Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Package to subsample ocean climatologies and reference data.

Project description

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.


  • 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:

>>> import oceansdb
>>> db = oceansdb.WOA()

Temperature at one point:

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

A profile of salinity:

>>> 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:

>>> 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:

>>> db = oceansdb.CARS()
>>> 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:

>>> db = oceansdb.ETOPO()
>>> h = db['topography'].extract(lat=17.5, lon=0)


0.7.0 (2017-05-11)

  • New generic crop functionality.
  • Interpolate in steps, in order: time, lat x lon, and finally z. Gives better results for profiles.

0.6.0 (2016-04-14)

  • Adding CSIRO Atlas of Regional Seas (CARS), another climatology for temperature and salinity.

0.4.0 (2016-03-29)

  • Added etopo5, a world wide bathymetry. Some of this code has its origins on pyAVISO and CoTeDe.

0.2.0 (2016-03)

  • Renamed package to OceansDB, planning to include other climatologies and references.

0.1.0 (2016-02-09)

  • Generalized interpolator. Extract climatology for point, profile or section.

0.0.1 (2015-12-13)

  • First release on PyPI. Extracted from CoTeDe to be a standalone package.

pre-released (~2006)

  • The first version was developed in support to quality control thermosalinographs at NOAA. It was later injected inside CoTeDe.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
oceansdb-0.8.3-py2.py3-none-any.whl (21.8 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Dec 10, 2017
oceansdb-0.8.3.tar.gz (26.0 kB) Copy SHA256 hash SHA256 Source None Dec 10, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page