Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Copernicus Marine Service Toolbox

A CLI and Python package for discovering, filtering, and downloading Copernicus Marine datasets and metadata with support for subsetting, multiple output formats, and direct Marine Data Store access.
https://github.com/mercator-ocean/copernicus-marine-toolbox

Category: Hydrosphere
Sub Category: Ocean and Hydrology Data Access

Last synced: about 8 hours ago
JSON representation

Repository metadata

README.md

Copernicus Marine Service and Mercator Ocean international logos

Features

The Copernicus Marine Toolbox offers capabilities through both Command Line Interface (CLI) and Python API:

  • Metadata Information: List and retrieve metadata information on all products, datasets, variables.
  • Subset Datasets: Subset datasets to extract only the parts of interest, in preferred format, such as Analysis-Ready Cloud-Optimized (ARCO) Zarr or NetCDF file format.
  • Advanced Filters: Apply simple or advanced filters to get multiple files, in original formats like NetCDF/GeoTIFF, via direct Marine Data Store connections.
  • No Quotas: Enjoy no quotas, neither on volume size nor bandwidth.

Documentation

For detailed and up-to-date information, please refer to the Copernicus Marine Toolbox Documentation. It includes exhaustive guides, API specifications, and tutorials, automatically versioned.

For additional documentation and smooth transition for users of legacy services such as MOTU, OPeNDAP, or FTP, visit our Help Center.

Installation

The Copernicus Marine Toolbox can be installed and utilized in various ways to suit different user preferences and system configurations. For detailed guidance, refer to the installation page of the toolbox documentation.

Mamba | Conda

mamba install conda-forge::copernicusmarine --yes

or conda:

conda install -c conda-forge copernicusmarine

Pip

python -m pip install copernicusmarine

Binaries (no-installation)

These binaries require no installation and run independently on the user system. Simply download (from release page or check the installation page of the toolbox documentation) and run the binary for instant access to the toolbox Command Line Interface functionalities.

Docker

docker pull copernicusmarine/copernicusmarine:latest

Dependencies

Note that the use of xarray<2024.7.0 with numpy>=2.0.0 leads to inconsistent results. See this issue: xarray issue.

Command Line Interface (CLI)

The --help option

To discover commands and their available options, consider appending --help on any command line.

Example:

copernicusmarine --help

Returns:

Usage: copernicusmarine [OPTIONS] COMMAND [ARGS]...

Options:
  -V, --version  Show the version and exit.
  -h, --help     Show this message and exit.

Commands:
  describe  Print Copernicus Marine catalogue as JSON.
  get       Download originally produced data files.
  login     Create a configuration file with your Copernicus Marine credentials.
  subset    Download subsets of datasets as NetCDF files or Zarr stores.

Python package (API)

The copernicusmarine exposes a Python interface to allow you to call commands as functions.

Version management

We are using semantic versioning X.Y.Z → MAJOR.MINOR.PATCH → for example 1.0.2. We follow the SEMVER principles:

Given a version number MAJOR.MINOR.PATCH, increment the:

  • MAJOR version when you make incompatible API changes
  • MINOR version when you add functionality in a backward compatible manner
  • PATCH version when you make backward compatible bug fixes

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

Contribution

We welcome contributions from the community to enhance this package. If you find any issues or have suggestions for improvements, please check out our Report Template.

You are welcome to submit issues to the GitHub repository or create a pull request; however, please be advised that we may not respond to your request or may provide a negative response.

Future improvements & Roadmap

To keep up to date with the most recent and planned advancements, including revisions, corrections, and feature requests generated from users' feedback, please refer to our Roadmap.

Join the community

Get in touch!

Licence

Licensed under the EUPL

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 364
Total Committers: 11
Avg Commits per committer: 33.091
Development Distribution Score (DDS): 0.453

Commits in past year: 115
Committers in past year: 7
Avg Commits per committer in past year: 16.429
Development Distribution Score (DDS) in past year: 0.4

Name Email Commits
Renaud 3****r 199
Oriol Ricart Vilarrubias. 4****3 108
nitreb 5****b 35
Theophile-Varnier t****r@l****h 12
gkoenig-mercator g****g@m****r 3
alexandreb31 1****1 2
Vecko 3****o 1
Slim 4****0 1
Malo_F 9****t 1
Juniper Tyree 5****r 1
Quentin Gaudel q****l@m****r 1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 42
Total pull requests: 338
Average time to close issues: 27 days
Average time to close pull requests: 4 days
Total issue authors: 25
Total pull request authors: 12
Average comments per issue: 2.33
Average comments per pull request: 0.34
Merged pull request: 241
Bot issues: 0
Bot pull requests: 1

Past year issues: 15
Past year pull requests: 69
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 5 days
Past year issue authors: 12
Past year pull request authors: 5
Past year average comments per issue: 1.67
Past year average comments per pull request: 0.59
Past year merged pull request: 42
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/mercator-ocean/copernicus-marine-toolbox

Top Issue Authors

  • veenstrajelmer (8)
  • renaudjester (4)
  • G0rocks (3)
  • buchmann-dhi (3)
  • kingkong-cmd (2)
  • thopri (2)
  • rsignell (2)
  • jdemaria (1)
  • uwagura (1)
  • btupper (1)
  • dominik-eai (1)
  • maresb (1)
  • iuryt (1)
  • rjdmartins (1)
  • willirath (1)

Top Pull Request Authors

  • renaudjester (183)
  • uriii3 (96)
  • nitreb (31)
  • gkoenig-mercator (11)
  • Theophile-Varnier (9)
  • alexandreb31 (2)
  • maresb (1)
  • ways (1)
  • VeckoTheGecko (1)
  • jacopo-exact (1)
  • dependabot[bot] (1)
  • qgau (1)

Top Issue Labels

Top Pull Request Labels

  • dependencies (1)
  • WIP (1)
  • on hold (1)

Dependencies

.github/workflows/check-format.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/tests.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
poetry.lock pypi
  • aiohttp 3.9.1
  • aioretry 5.0.2
  • aiosignal 1.3.1
  • asciitree 0.3.3
  • asttokens 2.4.1
  • async-timeout 4.0.3
  • attrs 23.2.0
  • beautifulsoup4 4.12.3
  • boto3 1.33.13
  • botocore 1.33.13
  • cachier 2.2.2
  • certifi 2023.11.17
  • cfgv 3.4.0
  • cftime 1.6.3
  • charset-normalizer 3.3.2
  • click 8.1.7
  • cloudpickle 3.0.0
  • colorama 0.4.6
  • dask 2023.12.1
  • decorator 5.1.1
  • distlib 0.3.8
  • docopt 0.6.2
  • exceptiongroup 1.2.0
  • executing 2.0.1
  • fasteners 0.19
  • filelock 3.13.1
  • frozenlist 1.4.1
  • fsspec 2023.12.2
  • identify 2.5.33
  • idna 3.6
  • importlib-metadata 7.0.1
  • ipython 8.18.1
  • jedi 0.19.1
  • jinja2 3.1.3
  • jmespath 1.0.1
  • locket 1.0.0
  • lxml 4.9.4
  • markupsafe 2.1.4
  • matplotlib-inline 0.1.6
  • motuclient 1.8.8
  • multidict 6.0.4
  • nest-asyncio 1.6.0
  • netcdf4 1.6.5
  • nodeenv 1.8.0
  • numcodecs 0.12.1
  • numpy 1.26.3
  • packaging 23.2
  • pandas 2.2.0
  • parso 0.8.3
  • partd 1.4.1
  • pexpect 4.9.0
  • platformdirs 4.1.0
  • portalocker 2.8.2
  • pre-commit 2.21.0
  • prompt-toolkit 3.0.43
  • ptyprocess 0.7.0
  • pure-eval 0.2.2
  • pydap 3.4.1
  • pygments 2.17.2
  • pystac 1.9.0
  • python-dateutil 2.8.2
  • pytz 2023.3.post1
  • pywin32 306
  • pyyaml 6.0.1
  • requests 2.31.0
  • s3transfer 0.8.2
  • semver 3.0.2
  • setuptools 68.2.2
  • six 1.16.0
  • soupsieve 2.5
  • stack-data 0.6.3
  • toolz 0.12.0
  • tqdm 4.66.1
  • traitlets 5.14.1
  • types-requests 2.31.0.6
  • types-requests 2.31.0.20240106
  • types-urllib3 1.26.25.14
  • typing-extensions 4.9.0
  • tzdata 2023.4
  • urllib3 1.26.18
  • urllib3 2.0.7
  • virtualenv 20.25.0
  • watchdog 3.0.0
  • wcwidth 0.2.13
  • webob 1.8.7
  • xarray 2023.11.0
  • yarl 1.9.4
  • zarr 2.16.1
  • zipp 3.17.0
pyproject.toml pypi
  • ipython ^8.14.0 develop
  • pre-commit ^2.20.0 develop
  • types-requests ^2.27.11 develop
  • aiohttp >=3.8.5
  • aioretry ^5.0.2
  • boto3 >=1.25
  • cachier >=2.2.1
  • click >=8.0.4
  • dask >=2022
  • lxml >=4.9.0
  • motuclient >=1.8.4
  • nest-asyncio >=1.5.8
  • netCDF4 >=1.5.4
  • pydap >=3.2.2
  • pystac >=1.8.3
  • python >=3.9,<3.13
  • requests >=2.27.1
  • semver >=3.0.2
  • setuptools >=68.2.2
  • tqdm >=4.65.0
  • xarray >=2023.4.0
  • zarr >=2.13.3
.github/workflows/release.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/binary-windows.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/message-prerelease.yml actions
  • actions/github-script v7 composite
.github/workflows/dependencies-tests.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v4 composite
.github/workflows/link-PR-doc.yml actions
  • readthedocs/actions/preview v1 composite
.github/workflows/message-release.yml actions
  • actions/github-script v7 composite
.github/workflows/push-docker-image.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/binaries.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/binary-test-windows.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/binary-test.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/message-general-pr.yml actions
  • actions/github-script v7 composite
.github/workflows/pre-release.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v1 composite
.github/workflows/tests_on_oss.yml actions
  • actions/cache v3 composite
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • snok/install-poetry v1 composite

Score: 6.64639051484773