hrrr#

HRRR analysis data source via earth2studio.

Fetches High-Resolution Rapid Refresh (HRRR) hourly analysis data from cloud object stores (AWS, Google, or NOMADS) using earth2studio.data.HRRR. HRRR provides 3 km North-American weather analysis on a Lambert conformal grid with spatial shape (1799, 1059).

Each pipeline index corresponds to a single timestamp, and the returned xarray.DataArray has dimensions (time, variable, hrrr_x, hrrr_y) with a single time step.

Classes#

HRRRSource

Fetch HRRR analysis fields from cloud object stores.

Module Contents#

class physicsnemo_curator.domains.da.sources.hrrr.HRRRSource(
times: list[datetime.datetime],
variables: list[str],
*,
source: str = 'aws',
cache: bool = False,
max_workers: int = 24,
)#

Bases: physicsnemo_curator.core.base.Source[xarray.DataArray]

Fetch HRRR analysis fields from cloud object stores.

HRRR is a NOAA 3 km, hourly-updated weather analysis covering North America on a Lambert conformal grid. Data is accessed via earth2studio and can be served from AWS, Google Cloud, or NOMADS.

Parameters:

  • times (list[datetime]) – Timestamps to fetch. Must be within the range supported by the chosen source (AWS/Google: after 2018-07-12T13:00; NOMADS: last 2 days only).

  • variables (list[str]) – Earth2studio variable identifiers (e.g. "t2m", "u10m"). Must be present in earth2studio.lexicon.HRRRLexicon.

  • source (str) – Cloud data source. One of "aws" (default), "google", or "nomads".

  • cache (bool) – Whether to cache downloaded data locally. Default False.

  • max_workers (int) – Maximum async I/O workers for downloads. Default 24.

Examples

>>> from datetime import datetime
>>> source = HRRRSource(
...     times=[datetime(2024, 1, 1, 0)],
...     variables=["t2m", "u10m"],
... )
>>> len(source)
1
>>> da = next(source[0])
>>> da.dims
('time', 'variable', 'hrrr_x', 'hrrr_y')

Note

classmethod params() → list[physicsnemo_curator.core.base.Param]#

Return parameter descriptors for the HRRR source.

Returns:

Descriptors for times, variables, source, cache, and max_workers.

Return type:

list[Param]

property cache: bool#

Return whether local caching is enabled.

description: ClassVar[str] = 'HRRR 3 km analysis via earth2studio (AWS, Google, NOMADS)'#

Short description shown in the interactive CLI.

name: ClassVar[str] = 'HRRR'#

Human-readable display name for the interactive CLI.

property source: str#

Return the cloud data source name.

property times: list[datetime.datetime]#

Return the list of timestamps in this source.

property variables: list[str]#

Return the list of variable IDs in this source.