OceansDB

https://zenodo.org/badge/52222122.svg https://readthedocs.org/projects/oceansdb/badge/?version=latest https://img.shields.io/travis/castelao/oceansdb.svg https://img.shields.io/pypi/v/oceansdb.svg

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.

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:

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