data.NClimGridDaily

NA

Import path: earth2studio.data.NClimGridDaily

View source on GitHub

Documentation

NOAA NClimGrid daily gridded climate data source.

NClimGrid provides daily CONUS gridded temperature and precipitation data on a ~1/24 degree (~0.0417°) latitude/longitude grid. Data spans from 1951 to the present and is stored as monthly NetCDF files on AWS S3.

Available variables: t2m_max, t2m_min, t2m (daily avg), tp (precipitation).

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 ) –

  Total timeout in seconds for the entire fetch operation, 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:

• www.ncei.noaa.gov/products/land-based-station/nclimgrid-daily
• registry.opendata.aws/noaa-nclimgrid/

__call__

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

Function to get NClimGrid data.

Parameters:

• time (datetime | list[datetime] | TimeArray) –

  Timestamps to return data for (UTC).

• variable (str | list[str] | VariableArray) –

  Canonical Earth2Studio variable name(s). Must be in the NClimGridLexicon.

Returns:

• DataArray –

  NClimGrid weather data array with dimensions [time, variable, lat, lon].

fetch async

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

Async function to get NClimGrid data.

Parameters:

• time (datetime | list[datetime] | TimeArray) –

  Timestamps to return data for (UTC).

• variable (str | list[str] | VariableArray) –

  Canonical Earth2Studio variable name(s). Must be in the NClimGridLexicon.

Returns:

• DataArray –

  NClimGrid weather data array with dimensions [time, variable, lat, lon].

available classmethod

available(time: datetime | datetime64) -> bool

Check if given date time is available.

Parameters:

• time (datetime | datetime64) –

  Date time to check.

Returns:

• bool –

  If date time is available.