earth2studio.data.GFS#

class earth2studio.data.GFS(source='aws', cache=True, verbose=True)[source]#

The global forecast service (GFS) initial state data source provided on an equirectangular grid. GFS is a weather forecast model developed by NOAA. This data source is provided on a 0.25 degree lat lon grid at 6-hour intervals spanning from Feb 26th 2021 to present date.

Parameters:
  • source (str, optional) – Data store location to pull from. Options are [aws, ncep], by default aws

  • 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.

Note

This data source only fetches the initial state of GFS and does not fetch an predicted time steps. See GFS_FX for fetching predicted data from this forecast system.

__call__(time, variable)[source]#

Retrieve GFS initial data to be used for initial conditions for the given time, variable information, and optional history.

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 GFS lexicon.

Returns:

GFS weather data array

Return type:

xr.DataArray

classmethod available(time)[source]#

Checks if given date time is avaliable in the GFS object store. Uses S3 store

Parameters:

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

Returns:

If date time is avaiable

Return type:

bool

Examples using earth2studio.data.GFS#

Running Deterministic Inference

Running Deterministic Inference

Running Diagnostic Inference

Running Diagnostic Inference

Running Ensemble Inference

Running Ensemble Inference

Generative Downscaling

Generative Downscaling

Single Variable Perturbation Method

Single Variable Perturbation Method

Model Hook Injection: Perturbation

Model Hook Injection: Perturbation

Statistical Inference

Statistical Inference

Extending Prognostic Models

Extending Prognostic Models

Extending Diagnostic Models

Extending Diagnostic Models

Extending Data Sources

Extending Data Sources