diff options
author | Gard Spreemann <gspr@nonempty.org> | 2019-05-23 13:45:38 +0200 |
---|---|---|
committer | Gard Spreemann <gspr@nonempty.org> | 2019-05-23 13:45:38 +0200 |
commit | f15a4382091aae707a95302ee5a3ad5bafc724bc (patch) | |
tree | 8a8f2461f51e498a6b9fc1b7d21a2fa12c3ee562 /README.rst | |
parent | a025b6c38c32e4a580c6f521cee277a64d04fc12 (diff) | |
parent | 11e00a4a0a3771097ddddcdb8fa3c417407adf3b (diff) |
Merge tag 'upstream/0.1.4' into debian/latest
Upstream 0.1.4 tarball as released on PyPI.
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..166dac0 --- /dev/null +++ b/README.rst @@ -0,0 +1,62 @@ + +Install +------- + +Install via `pip` with:: + + $ pip install cdsapi + + +Configure +--------- + +Get your UID and API key from the CDS portal at the address https://cds.climate.copernicus.eu/user +and write it into the configuration file, so it looks like:: + + $ cat ~/.cdsapirc + url: https://cds.climate.copernicus.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') + >>> + + +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. |