data.ARCO

Global

Import path: earth2studio.data.ARCO

View source on GitHub

Documentation

Analysis-Ready, Cloud Optimized (ARCO) is a data store of ERA5 re-analysis data currated by Google. This data is stored in Zarr format and contains 31 surface variables, pressure level variables defined on 37 pressure levels, and model level variables defined on the 137 native ERA5 vertical levels, all on a 0.25 degree lat lon grid. Temporal resolution is 1 hour.

Parameters:

• cache (bool, default: True ) –

  Cache data source on local memory, by default True

• verbose (bool, default: True ) –

  Print download progress, by default True

• async_timeout (int, default: 600 ) –

  Time in sec after which 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

Additional information on the data repository can be referenced here:

• cloud.google.com/storage/docs/public-datasets/era5

__call__

__call__(
    time: datetime | list[datetime] | TimeArray,
    variable: str | list[str] | VariableArray,
) -> DataArray

Function to get 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 ARCO lexicon.

Returns:

• DataArray –

  ERA5 weather data array from ARCO

fetch async

fetch(
    time: datetime | list[datetime] | TimeArray,
    variable: str | list[str] | VariableArray,
) -> DataArray

Async function to get 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 ARCO lexicon.

Returns:

• DataArray –

  ERA5 weather data array from ARCO

available classmethod

available(time: datetime | datetime64) -> bool

Checks if given date time is avaliable in the ARCO data source

Parameters:

• time (datetime | datetime64) –

  Date time to access

Returns:

• bool –

  If date time is avaiable

Examples using earth2studio.data.ARCO

Running Atlas InferenceDeterministic inference using the Atlas prognostic model. Running StormCast-CONUS InferenceBasic StormCast-CONUS inference workflow for the full Continental United States. Extending Data SourcesImplementing a custom data source