oceansdb 0.8.8

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

Find out what is available:

>>> db.keys()

Average 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 from the 1 min arc resolution:

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

History

0.8.0

• Allowing to choose resolution and temporal scale.

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.