Installation

Installing from PyPI

Minimal installation

Install the latest release with Python >= 3.10 and pip:

pip install earthkit-data

The package installed like this is minimal supporting only GRIB and NetCDF data and cannot access remote services other than URLs. If you want to use more data types or remote services you need to install the optional Python packages.

Installing all optional packages

You can install earthkit-data with all optional packages (with the exception of the “geotiff” and “zarr” dependencies, see below):

pip install "earthkit-data[all]"

Note

Some shells (e.g. zsh) require quotes around the square brackets, as shown above.

Installing individual optional packages

The following optional extras are available:

  • cds: provides access to the cds and ads sources

  • covjsonkit: provides access to CoverageJSON data served by the polytope source

  • ecmwf-opendata: provides access to the ecmwf-open-data

  • fdb: provides access to the fdb source

  • geotiff: adds GeoTIFF support (new in version 0.11.0). Please note that this is not included in the [all] option and has to be invoked separately.

  • geopandas: adds GeoJSON/GeoPandas support

  • gribjump: provides access to the gribjump source

  • iris: provides access to UK Met Office PP files (new in version 0.19.0).

  • mars: provides access to the mars source

  • odb: provides full support for the odb data type

  • projection: adds projection support

  • polytope: provides access to the polytope source

  • s3: provides access to non-public s3 buckets (new in version 0.11.0)

  • wekeo: provides access to the wekeo and wekeo-cds sources

  • zarr: provides access to the zarr source (new in version 0.15.0). Please note that this is not included in the [all] option and has to be invoked separately.

To install a single extra, for example mars:

pip install "earthkit-data[mars]"

Multiple extras can be combined in a single command:

pip install "earthkit-data[cds,mars]"

Installing the binary dependencies

FDB

For FDB (Fields DataBase) access FDB5 must be installed on the system. See the FDB documentation for details.

GribJump (experimental)

For FDB access with GribJump, both FDB5 and GribJump must be installed on the system. See the GribJump project for details.