Xarray backend to map an ECMWF style request to a service onto an Xarray Dataset
This Open Source project is build by B-Open - https://www.bopen.eu
xarray-ecmwf is a Python library and Xarray backend with the following functionalities:
- opens an ECMWF style request as a Xarray Dataset connected to the remote services
- the Climate Data Store via cdsapi: ERA5, Seasonal forecasts
- the Athospheric Data Store via cdsapi
- the ECMWF Open data via ecmwf-opendata: High resolution forecasts, ensemble forecast
- allows lazy loading the data and well integrated with Dask and Dask.distributed
- allows chunking the input request according to a configurable splitting strategy. Allowed strategies:
- by one month
- by one day
- supports requests returning a single GRIB file, via cfgrib
>>> import xarray as xr
>>> request = {
... "dataset": "reanalysis-era5-single-levels",
... "product_type": "reanalysis",
... "variable": ["2m_temperature"],
... "year": ["2002"],
... "month": ["01"],
... "day": ["15"],
... "time": ["00:00", "12:00"],
... }
>>> ds = xr.open_dataset(request, engine="ecmwf")
>>> ds
<xarray.Dataset>
Dimensions: (time: 2, latitude: 721, longitude: 1440)
Coordinates:
number int64 ...
* time (time) datetime64[ns] 2002-01-15 2002-01-15T12:00:00
step timedelta64[ns] ...
surface float64 ...
valid_time (time) datetime64[ns] ...
* latitude (latitude) float64 90.0 89.75 89.5 89.25 ... -89.5 -89.75 -90.0
* longitude (longitude) float64 0.0 0.25 0.5 0.75 ... 359.2 359.5 359.8
Data variables:
t2m (time, latitude, longitude) float32 ...
Attributes:
GRIB_edition: 1
GRIB_centre: ecmf
GRIB_centreDescription: European Centre for Medium-Range Weather Forecasts
GRIB_subCentre: 0
Conventions: CF-1.7
institution: European Centre for Medium-Range Weather Forecasts
history: ...Copyright 2022, B-Open Solutions srl.
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.
