IFS_ENS#

class earth2studio.data.IFS_ENS(
source='aws',
member=1,
cache=True,
verbose=True,
async_timeout=600,
)[source]#
Global

Integrated forecast system (IFS) ensemble (ENS) initial state data source on an equirectangular grid at 0.25 degree resolution. IFS is a forecast model developed by ECMWF. Data for the most recent 4 days can be retrieved from ECMWF’s servers (source ecmwf). Historical data is part of ECMWF’s open data project on AWS (source aws).

Parameters:

  • source (str, optional) – Data source to fetch data from. For possible options refer to ECMWF’s open data Python SDK, by default “aws”.

  • member (int, optional) – Ensemble member id to use. If 0 the control forecast will be requested, if greater than 0 perturbed ensemble member will be requested, by default 1.

  • cache (bool, optional) – Cache data source in local memory, by default True.

  • verbose (bool, optional) – Print download progress, by default True.

  • async_timeout (int, optional) – Time in seconds after which the download will be cancelled if not finished successfully, by default 600.

Warning

This is a remote data source and can potentially download a large amount of data to your local machine for large requests.

Note

Accumulated variables are provided from previous forecast cycles using forecast predictions that verify at the requested analysis time.

Additional information on the data repository can be referenced here:

__call__(time, variable)[source]#

Retrieve IFS ENS data.

Parameters:

  • time (datetime | list[datetime] | TimeArray) – Timestamps to return data for (UTC).

  • variable (str | list[str] | VariableArray) – String, list of strings or array of strings that refer to variables to return. Must be in the data lexicon.

Returns:

IFS ENS initial state data array.

Return type:

xr.DataArray

async fetch(time, variable)[source]#

Async method to retrieve IFS ENS initial state data.

Parameters:

  • time (datetime | list[datetime] | TimeArray) – Timestamps to return data for (UTC).

  • variable (str | list[str] | VariableArray) – String, list of strings or array of strings that refer to variables to return. Must be in the data lexicon.

Returns:

IFS ENS initial state data array.

Return type:

xr.DataArray

On this page