cdsapi

Python API to access the Copernicus Climate Data Store.
https://github.com/ecmwf/cdsapi

Category: Climate Change
Sub Category: Climate Data Access and Visualization

Keywords from Contributors

bufr grib meteorology decoding encoding wmo earth-science odb weather

Last synced: about 12 hours ago
JSON representation

Repository metadata

Python API to access the Copernicus Climate Data Store (CDS)

Host: GitHub
URL: https://github.com/ecmwf/cdsapi
Owner: ecmwf
License: apache-2.0
Created: 2019-01-17T16:44:07.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-11-28T15:28:14.000Z (5 months ago)
Last Synced: 2025-04-21T12:06:12.454Z (6 days ago)
Language: Python
Size: 104 KB
Stars: 266
Watchers: 26
Forks: 64
Open Issues: 37
Releases: 14
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE.txt

README.rst

          cdsapi
------

For a more detailed description on how to use the cdsapi, please visit: https://cds.climate.copernicus.eu/how-to-api


Install
-------

Install via `pip` with::

    $ pip install cdsapi


Configure
---------

Get your Personal Access Token from your profile on the CDS portal at the address: https://cds.climate.copernicus.eu/profile
and write it into the configuration file, so it looks like::

    $ cat ~/.cdsapirc
    url: https://cds.climate.copernicus.eu/api
    key: 

Remember to agree to the Terms and Conditions of every dataset that you intend to download.


Test
----

Perform a small test retrieve of ERA5 data::

    $ python
    >>> import cdsapi
    >>> cds = cdsapi.Client()
    >>> cds.retrieve('reanalysis-era5-pressure-levels', {
               "variable": "temperature",
               "pressure_level": "1000",
               "product_type": "reanalysis",
               "date": "2017-12-01/2017-12-31",
               "time": "12:00",
               "format": "grib"
           }, 'download.grib')
    >>>


License
-------

Copyright 2018 - 2019 European Centre for Medium-Range Weather Forecasts (ECMWF)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

In applying this licence, ECMWF does not waive the privileges and immunities
granted to it by virtue of its status as an intergovernmental organisation nor
does it submit to any jurisdiction.

Owner metadata

Name: European Centre for Medium-Range Weather Forecasts
Login: ecmwf
Email: [email protected]
Kind: organization
Description: Providing software to work with meteorological data and services
Website: www.ecmwf.int
Location: Shinfield Park, Reading, United Kingdom
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/6368067?v=4
Repositories: 44
Last ynced at: 2023-03-02T03:00:24.789Z
Profile URL: https://github.com/ecmwf

GitHub Events

Total

Create event: 4
Release event: 1
Issues event: 22
Watch event: 27
Delete event: 7
Issue comment event: 34
Push event: 13
Pull request review event: 1
Pull request event: 11
Fork event: 7

Last Year

Create event: 4
Release event: 1
Issues event: 22
Watch event: 27
Delete event: 7
Issue comment event: 34
Push event: 13
Pull request review event: 1
Pull request event: 11
Fork event: 7

Committers metadata

Last synced: 7 days ago

Total Commits: 130
Total Committers: 18
Avg Commits per committer: 7.222
Development Distribution Score (DDS): 0.608

Commits in past year: 19
Committers in past year: 5
Avg Commits per committer in past year: 3.8
Development Distribution Score (DDS) in past year: 0.421

Name	Email	Commits
Baudouin Raoult	b**t@e**t	51
Alessandro Amici	a**i@b**u	31
Eddy Comyn-Platt	5****F	20
Gionata Biavati	G**i@e**t	5
Mattia Almansi	m**i@b**u	4
Stephan Siemen	s**n@e**t	4
James Varndell	3****l	2
fxi	f@f****o	2
Jesper Baasch-Larsen	j**l@g**m	2
Harald Nordgård-Hansen	h**h@w**m	1
Daniel Tipping	d**l@o**h	1
Francesco Nazzaro	f**9@g**m	1
Kevin Anderson	k**n@n**v	1
Luca Fabbri	l**b@g**m	1
LukeJones123	9****3	1
Thomas Grandjean	t**e@g**m	1
garciam	m**d@g**m	1
Matthias Riße	m**e@f**e	1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 90
Total pull requests: 57
Average time to close issues: about 1 year
Average time to close pull requests: 4 months
Total issue authors: 72
Total pull request authors: 29
Average comments per issue: 2.67
Average comments per pull request: 1.18
Merged pull request: 39
Bot issues: 0
Bot pull requests: 0

Past year issues: 27
Past year pull requests: 20
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 1 day
Past year issue authors: 20
Past year pull request authors: 8
Past year average comments per issue: 2.48
Past year average comments per pull request: 0.85
Past year merged pull request: 14
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ecmwf/cdsapi

Top Issue Authors

veenstrajelmer (8)
manfredsc (3)
stefan-maxar (2)
BSchilperoort (2)
mvhulten (2)
WeatherGod (2)
samburu (2)
e5k (2)
baudouinth (2)
jblarsen (2)
gspr (2)
EddyCMWF (1)
mendezr (1)
rabernat (1)
mo-jfallon (1)

Top Pull Request Authors

EddyCMWF (22)
malmans2 (4)
mwtoews (2)
akeeman (2)
maresb (2)
JamesVarndell (2)
matrss (1)
gbiavati (1)
StephanSiemen (1)
kandersolar (1)
colligant (1)
haraldnh (1)
grigaut (1)
markelg (1)
dtip (1)

Top Issue Labels

bug (23)
enhancement (13)

Top Pull Request Labels

contributor (14)
approved-for-ci (4)

Package metadata

Total packages: 13
Total downloads:
- pypi: 132,782 last-month
Total docker downloads: 1,090
Total dependent packages: 74 (may contain duplicates)
Total dependent repositories: 179 (may contain duplicates)
Total versions: 73
Total maintainers: 3

pypi.org: cdsapi

Climate Data Store API

Homepage: https://github.com/ecmwf/cdsapi
Documentation: https://cdsapi.readthedocs.io/
Licenses: Apache 2.0
Latest release: 0.7.5 (published 5 months ago)
Last Synced: 2025-04-25T14:03:37.391Z (1 day ago)
Versions: 34
Dependent Packages: 66
Dependent Repositories: 140
Downloads: 132,782 Last month
Docker Downloads: 1,090
Rankings:
- Dependent packages count: 0.272%
- Dependent repos count: 1.276%
- Downloads: 1.579%
- Docker downloads count: 2.075%
- Average: 2.714%
- Stargazers count: 5.306%
- Forks count: 5.774%
Maintainers (2)
- braoult
- ecmwf

alpine-v3.18: py3-cdsapi-pyc

Precompiled Python bytecode for py3-cdsapi

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0 license
Latest release: 0.6.1-r1 (published about 2 years ago)
Last Synced: 2025-04-25T14:03:40.146Z (1 day ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 8.229%
- Forks count: 15.919%
- Stargazers count: 16.997%
Maintainers (1)
- [email protected]

alpine-v3.18: py3-cdsapi

Python API to access the Copernicus Climate Data Store

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0 license
Latest release: 0.6.1-r1 (published about 2 years ago)
Last Synced: 2025-04-02T05:59:02.647Z (25 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 8.229%
- Forks count: 15.919%
- Stargazers count: 16.997%
Maintainers (1)
- [email protected]

alpine-edge: py3-cdsapi-pyc

Precompiled Python bytecode for py3-cdsapi

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.7.5-r0 (published 4 months ago)
Last Synced: 2025-04-25T14:03:47.005Z (1 day ago)
Versions: 11
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Average: 12.577%
- Dependent packages count: 14.389%
- Forks count: 17.158%
- Stargazers count: 18.762%
Maintainers (1)
- [email protected]

alpine-edge: py3-cdsapi

Python API to access the Copernicus Climate Data Store

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.7.5-r0 (published 4 months ago)
Last Synced: 2025-04-02T03:21:45.571Z (25 days ago)
Versions: 12
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Average: 12.603%
- Dependent packages count: 14.641%
- Forks count: 17.024%
- Stargazers count: 18.746%
Maintainers (1)
- [email protected]

alpine-v3.17: py3-cdsapi

Python API to access the Copernicus Climate Data Store

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0 license
Latest release: 0.5.1-r0 (published almost 3 years ago)
Last Synced: 2025-04-03T06:07:54.901Z (24 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Average: 14.438%
- Forks count: 14.758%
- Stargazers count: 15.74%
- Dependent packages count: 27.254%
Maintainers (1)
- [email protected]

conda-forge.org: cdsapi

Homepage: https://software.ecmwf.int/stash/projects/CDS/repos/cdsapi
Licenses: Apache-2.0
Latest release: 0.5.1 (published about 4 years ago)
Last Synced: 2025-04-02T02:58:20.788Z (25 days ago)
Versions: 7
Dependent Packages: 8
Dependent Repositories: 39
Rankings:
- Dependent repos count: 5.76%
- Dependent packages count: 7.088%
- Average: 16.923%
- Forks count: 25.99%
- Stargazers count: 28.855%

alpine-v3.21: py3-cdsapi-pyc

Precompiled Python bytecode for py3-cdsapi

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.7.4-r0 (published 6 months ago)
Last Synced: 2025-04-25T14:03:43.247Z (1 day ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- [email protected]

alpine-v3.21: py3-cdsapi

Python API to access the Copernicus Climate Data Store

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.7.4-r0 (published 6 months ago)
Last Synced: 2025-04-25T14:03:40.246Z (1 day ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- [email protected]

alpine-v3.20: py3-cdsapi

Python API to access the Copernicus Climate Data Store

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.7.0-r0 (published about 1 year ago)
Last Synced: 2025-04-02T04:11:32.487Z (25 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- [email protected]

alpine-v3.19: py3-cdsapi-pyc

Precompiled Python bytecode for py3-cdsapi

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.6.1-r4 (published over 1 year ago)
Last Synced: 2025-04-02T05:16:42.067Z (25 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- [email protected]

alpine-v3.19: py3-cdsapi

Python API to access the Copernicus Climate Data Store

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.6.1-r4 (published over 1 year ago)
Last Synced: 2025-04-25T14:03:40.277Z (1 day ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- [email protected]

alpine-v3.20: py3-cdsapi-pyc

Precompiled Python bytecode for py3-cdsapi

Homepage: https://github.com/ecmwf/cdsapi
Licenses: Apache-2.0
Latest release: 0.7.0-r0 (published about 1 year ago)
Last Synced: 2025-04-02T00:08:17.301Z (25 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- [email protected]

Dependencies

setup.py pypi

requests >=2.5.0
tqdm *

tests/requirements.txt pypi

pytest * test
pytest-cov * test
pytest-env * test
pytest-flakes * test
pytest-mccabe * test
pytest-pep8 * test
pytest-runner * test
requests * test

.github/workflows/check-and-publish.yml actions

actions/checkout v3 composite
actions/setup-python v2 composite
mvasigh/dispatch-action main composite

.github/workflows/label-public-pr.yml actions

docker/Dockerfile docker

python 3.7-alpine build

Score: 20.410728963152373

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

cdsapi

Keywords from Contributors

Repository metadata

README.rst

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Package metadata

pypi.org: cdsapi

alpine-v3.18: py3-cdsapi-pyc

alpine-v3.18: py3-cdsapi

alpine-edge: py3-cdsapi-pyc

alpine-edge: py3-cdsapi

alpine-v3.17: py3-cdsapi

conda-forge.org: cdsapi

alpine-v3.21: py3-cdsapi-pyc

alpine-v3.21: py3-cdsapi

alpine-v3.20: py3-cdsapi

alpine-v3.19: py3-cdsapi-pyc

alpine-v3.19: py3-cdsapi

alpine-v3.20: py3-cdsapi-pyc

Dependencies