Skip to main content
https://zenodo.org/badge/4645/castelao/oceansdb.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()

To get temperature at one point:

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

To get one profile of salinity:

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

To get a full depth section of temperature:

>>> t = db['TEMP'].extract(var='mn', doy=136.875, lat=17.5, lon=[-39, -37.5, -35])

Or to get topography for one point:

>>> db = oceansdb.ETOPO()
>>> h = db.extract(lat=17.5, lon=0)

History

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.

Release files for oceansdb 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oceansdb 0.7.1
File Size Uploaded
oceansdb-0.7.1.tar.gz 25.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for oceansdb 0.7.1
File Interpreter ABI Platform
oceansdb-0.7.1-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 47.0 kB

Release files / oceansdb-0.7.1.tar.gz

Download URL oceansdb-0.7.1.tar.gz
Size 25.9 kB
Tags Source
SHA-256 checksum
How to use checksums
bd302fcc89a76637b10fe5f6eb51da41fcc9f76338d88038cd1db662d07c44d1
BLAKE2b-256 checksum
How to use checksums
711db639ff9c53f7c85f3ef525493c754a472f3af58551d3f5fc68c658443dea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / oceansdb-0.7.1-py2.py3-none-any.whl

Download URL oceansdb-0.7.1-py2.py3-none-any.whl
Size 21.1 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
c13f46a7d4644517c16de6891fa7f4aad2bb9ac2e7346e0340d313afb4b870f7
BLAKE2b-256 checksum
How to use checksums
b75be4e32ac797789410684876ee6525d95f44dfd60ee72ad10388173d650a95
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

0.8.15

2 release files

0.8.14

2 release files

0.8.12

2 release files

0.8.11

2 release files

0.8.9

2 release files

0.8.8

2 release files

0.8.7

2 release files

0.8.6

2 release files

0.8.4

2 release files

0.8.3

2 release files

0.8.1

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

This release

0.7.1 This release

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

1 release file

0.5.0

1 release file

0.4.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page