Skip to content

data.HRRR

NA

Import path: earth2studio.data.HRRR

View source on GitHub

Documentation

High-Resolution Rapid Refresh (HRRR) data source provides hourly North-American weather analysis data developed by NOAA (used to initialize the HRRR forecast model). This data source is provided on a Lambert conformal 3km grid at 1-hour intervals. The spatial dimensionality of HRRR data is [1059, 1799].

The hrrr_x and hrrr_y coordinates of the resulting DataArray are the native coordinates of the HRRR model. The corresponding CRS can be set up with cartopy:

import cartopy.crs as ccrs

proj_hrrr = ccrs.LambertConformal(
    central_longitude=262.5,
    central_latitude=38.5,
    standard_parallels=(38.5, 38.5),
    globe=ccrs.Globe(semimajor_axis=6371229, semiminor_axis=6371229),
)

Parameters:

  • source (str, default: 'aws' ) –

    Data source to use ('aws', 'google', 'azure', 'nomads'), by default 'aws'

  • max_workers (int, default: 24 ) –

    Deprecated, has no effect. Kept for API compatibility, by default 24

  • 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

  • async_workers (int, default: None ) –

    Maximum number of concurrent downloads. By default None, which autoscales to the number of download tasks (capped at 64)

  • retries (int, default: 3 ) –

    Number of retries for each download task on transient errors, by default 3

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:

__call__ 

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

Retrieve HRRR analysis data (lead time 0)

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

Returns:

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

Returns:

available classmethod 

available(time: datetime | datetime64) -> bool

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

Parameters:

Returns:

  • bool –

    If date time is avaiable

Examples using earth2studio.data.HRRR

Preview of Running StormCast Ensemble InferenceRunning StormCast Ensemble InferenceEnsemble StormCast inference workflow. Preview of StormCast-CONUS Score-Based Data AssimilationStormCast-CONUS Score-Based Data AssimilationRunning StormCast-CONUS with guided diffusion posterior sampling to assimilate observations.