earth2studio.data.ARCO#
- class earth2studio.data.ARCO(cache=True, verbose=True, async_timeout=600)[source]#
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, optional) – Cache data source on local memory, by default True
verbose (bool, optional) – Print download progress, by default True
async_timeout (int, optional) – 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:
The data source will automatically use Multi-Storage Client (MSC) if available, otherwise it will fallback to using gcsfs directly. MSC can provide better performance for cloud storage access.
- __call__(time, variable)[source]#
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:
ERA5 weather data array from ARCO
- Return type:
xr.DataArray
- async fetch(time, variable)[source]#
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:
ERA5 weather data array from ARCO
- Return type:
xr.DataArray
