OceansDB

A database of marine reference data like climatologies and bathymetry.
https://github.com/castelao/oceansdb

Category: Hydrosphere
Sub Category: Ocean and Hydrology Data Access

Last synced: about 14 hours ago
JSON representation

Repository metadata

A database of marine reference data like climatologies and bathymetry

• Host: GitHub
• URL: https://github.com/castelao/oceansdb
• Owner: castelao
• License: bsd-3-clause
• Created: 2016-02-21T18:52:28.000Z (almost 10 years ago)
• Default Branch: main
• Last Pushed: 2023-02-22T03:50:57.000Z (almost 3 years ago)
• Last Synced: 2025-11-17T17:03:22.479Z (about 1 month ago)
• Language: Python
• Size: 246 KB
• Stars: 24
• Watchers: 5
• Forks: 15
• Open Issues: 7
• Releases: 3
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE.rst
  • Authors: AUTHORS.rst
  • Zenodo: .zenodo.json

README.rst

          ========
OceansDB
========

.. image:: https://zenodo.org/badge/52222122.svg
   :target: https://zenodo.org/badge/latestdoi/52222122

.. image:: https://readthedocs.org/projects/oceansdb/badge/?version=latest
    :target: http://oceansdb.readthedocs.org/en/latest/?badge=latest
         :alt: Documentation Status

.. image:: https://img.shields.io/travis/castelao/oceansdb.svg
        :target: https://travis-ci.org/castelao/oceansdb

.. image:: https://img.shields.io/pypi/v/oceansdb.svg
        :target: https://pypi.python.org/pypi/oceansdb


Package to subsample, or interpolate, climatologies like WOA to any coordinates.

This package started with functions to obtain climatological values to compare with measured data, allowing a quality control check by comparison. It hence needed to work for any coordinates requested. I split these functionalities from `CoTeDe `_ into this standalone package to allow more people to use it for other purposes.

* Free software: 3-clause BSD style license - see LICENSE.rst  
* Documentation: https://oceansdb.readthedocs.io.

Features
--------

- If the database files are not localy available, automatically download it.

- Extract, or interpolate if necessary, climatologic data on requested coordinates;

  - Can request a single point, a profile or a section;

  - Ready to handle -180 to 180 or 0 to 360 coordinate system;

- Ready to use with:

  - World Ocean Atlas (WOA)

  - CSIRO Atlas Regional Seas (CARS)

  - ETOPO (topography)

Quick howto use
---------------

Inside python:

.. code-block:: python

    >>> import oceansdb
    >>> with oceansdb.WOA() as db:

Find out what is available:

.. code-block:: python

    >>>     db.keys()

Average temperature at one point:

.. code-block:: python

    >>>     t = db['sea_water_temperature'].extract(var='mean', doy=136.875, depth=0, lat=17.5, lon=-37.5)

A profile of salinity:

.. code-block:: python

    >>>     t = db['sea_water_salinity'].extract(var='mean', doy=136.875, depth=[0, 10, 15, 18], lat=17.5, lon=-37.5)

A full depth section of temperature:

.. code-block:: python

    >>>     t = db['sea_water_temperature'].extract(var='mean', doy=136.875, lat=17.48, lon=[-39, -37.5, -35.2])

Using CARS instead of WOA:

.. code-block:: python

    >>> with oceansdb.CARS() as db:
    >>>     t = db['sea_water_temperature'].extract(var='mean', doy=136.875, lat=17.48, lon=[-39, -37.5, -35.2], depth=[0,10,120,280])

Or to get topography for one point from the 1 min arc resolution:

.. code-block:: python

    >>> with oceansdb.ETOPO(resolution='1min') as db:
    >>>     h = db['topography'].extract(lat=17.5, lon=0)

        

---

Owner metadata

• Name: Guilherme Castelão
• Login: castelao
• Email:
• Kind: user
• Description: multi-class: PhD in Physical Oceanography, offshore solo sailor, Rustacean and Pythonista.
• Website: www.castelao.net
• Location: CO
• Twitter:
• Company: @NREL
• Icon url: https://avatars.githubusercontent.com/u/1903589?v=4
• Repositories: 80
• Last ynced at: 2024-06-11T15:44:11.788Z
• Profile URL: https://github.com/castelao

---

GitHub Events

Total

• Watch event: 3
• Fork event: 1

Last Year

• Watch event: 3
• Fork event: 1

---

Committers metadata

Last synced: 2 days ago

Name	Email	Commits
Gui	g****e@c****t	270
Guilherme Castelao	c****o@h****u	53
Guilherme Castelao	c****o@g****l	7
ZeDias	j****n@g****m	1
Chris Slater	6****m	1

Committer domains:

• hatch.ucsd.edu: 1
• castelao.net: 1

---

Issue and Pull Request metadata

Last synced: 4 months ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/castelao/oceansdb

---

---

---

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 454 last-month
• Total dependent packages: 2 (may contain duplicates)
• Total dependent repositories: 6 (may contain duplicates)
• Total versions: 43
• Total maintainers: 1

---

Dependencies

Score: 11.18115217100548