earth2studio.data.GEFS_FX_721x1440

class earth2studio.data.GEFS_FX_721x1440(product='gec00', cache=True, verbose=True)

The Global Ensemble Forecast System (GEFS) forecast source is a 30 member ensemble forecast provided on an 0.25 degree equirectangular grid. GEFS is a weather forecast model developed by National Centers for Environmental Prediction (NCEP). This data source provides the select variables of GEFS served on a higher resolution grid t 6-hour intervals spanning from Sept 23rd 2020 to present date. Each forecast provides 3-hourly predictions up to 10 days (240 hours) and 6 hourly predictions for another 6 days (384 hours).

Parameters:

• product (str, optional) – GEFS product. Options are: control gec00 (control), gepNN (forecast member NN, e.g. gep01, gep02,…), by default “gec00”

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

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

Warning

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

Warning

Some variables in the GEFS lexicon may not be available at lead time 0. Consult GEFS documentation for additional information.

Note

NCEP only provides a small subset of variables on the higher resoluton 0.25 degree grid. For a larger selection, use the standard GEFS data source.

Note

Additional information on the data repository can be referenced here:

• https://registry.opendata.aws/noaa-gefs/

• https://www.ncei.noaa.gov/products/weather-climate-models/global-ensemble-forecast

• https://www.nco.ncep.noaa.gov/pmb/products/gens/

__call__(time, lead_time, variable)

Retrieve GEFS ensemble forecast data

Parameters:

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

• lead_time (timedelta | list[timedelta] | LeadTimeArray) – Forecast lead times to fetch.

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

Returns:

GEFS weather data array

Return type:

xr.DataArray

classmethod available(time)

Checks if given date time is avaliable in the GEFS object store

Parameters:

time (datetime | np.datetime64) – Date time to access

Returns:

If date time is avaiable

Return type:

bool