Skip to main content

Package to subsample ocean climatologies and reference data.

Project description

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

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.

Project details


Download files

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

Source Distribution

oceansdb-0.8.10.tar.gz (33.9 kB view details)

Uploaded Source

Built Distribution

oceansdb-0.8.10-py2.py3-none-any.whl (25.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file oceansdb-0.8.10.tar.gz.

File metadata

  • Download URL: oceansdb-0.8.10.tar.gz
  • Upload date:
  • Size: 33.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.1 CPython/3.7.3

File hashes

Hashes for oceansdb-0.8.10.tar.gz
Algorithm Hash digest
SHA256 bcbe5d953a4f8dbe001604b096401db0d435e9a2f67ef9064da88c93dc38e8b4
MD5 be0f9c02a7392010dc7a0aed3c70aa0a
BLAKE2b-256 0c7c347f6a927b36acc5497e7c3709a2d099e9a5e45e52f823f5e1848ba2f3bc

See more details on using hashes here.

File details

Details for the file oceansdb-0.8.10-py2.py3-none-any.whl.

File metadata

  • Download URL: oceansdb-0.8.10-py2.py3-none-any.whl
  • Upload date:
  • Size: 25.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.1 CPython/3.7.3

File hashes

Hashes for oceansdb-0.8.10-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5feaadb91c6381b8fd54d14d3f3acd1d0c16c0c0a79e38b0f6cd4077963b85f8
MD5 21d18734cb86bd9f61cb11f36d836e8c
BLAKE2b-256 ecb327c187ce23242ec87a638d0b42210a1ffb39932b5455d9523e8008dcb59b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page