summaryrefslogtreecommitdiff
path: root/README.rst
blob: 3b57a62d0e23bcafcba1919534c8d052451772ac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
Install
-------

Install via `pip` with::

    $ pip install cdsapi


Configure
---------

Get your UID and API key from the CDS portal at the address https://cds-toolbox-test.bopen.eu/user
and write it into the configuration file, so it looks like::

    $ cat ~/.cdsapirc
    url: https://cds-toolbox-test.bopen.eu/api/v2
    key: <UID>:<API key>
    verify: 0

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