Skip to main content

Estimating the Circulation and Climate of the Ocean (ECCO) Version 4 Python Package

Project description


ecco_v4_py is a Python package that includes tools for loading and manipulating the ECCO v4 ocean and sea-ice state estimate (

Extensive documentation is provided on our readthedocs page:


Installation instructions can be found here!


If you would like to contribute, consider forking this repository and making pull requests via git!


contact or Ian.Fenty at


MIT License

Note on version numbers

ecco_v4_py uses the 'semantic versioning' scheme described here:

The essence of semantic versioning is a 3-part MAJOR.MINOR.MAINTENANCE numbering scheme:

MAJOR version when they make incompatible API changes,

MINOR version when they add functionality in a backwards-compatible manner, and

MAINTENANCE version when they make backwards-compatible bug fixes.

Note on testing with pytest

(credit to Tim Smith)

You can run the tests locally with the pytest package, which is available through conda-forge. With that installed, you can navigate to ECCOv4-py/ecco_v4_py/test and either:

Run all the tests exactly as they are on travis (this takes a while, like 12 minutes!):

py.test . -v --cov=ecco_v4_py --cov-config .coveragerc --ignore=ecco_v4_py/test/

Or you can run any individual module e.g. to run the few tests in ecco_utils:


(and you can add any of the -v or whatever flags you want).

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

ecco_v4_py-1.5.5.tar.gz (79.1 kB view hashes)

Uploaded source

Built Distribution

ecco_v4_py-1.5.5-py3-none-any.whl (90.3 kB view hashes)

Uploaded py3

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