Skip to content

Aurora1p5

GlobalMRF202648 GBMicrosoftPyTorch

Import path: earth2studio.models.px.Aurora1p5

View source on GitHub View install commands

Documentation

Bases: _Aurora

Aurora v1.5 0.25 degree global forecast model with hourly output.

The underlying 6-hour auto-regressive model is queried at t+1h through t+6h from the same input pair before advancing the AR state. Inputs are two states six hours apart on a (720, 1440) grid, with 5 atmospheric variables across 13 pressure levels and 18 surface variables. Outputs include 7 additional diagnostic variables.

Note

This model uses the checkpoints from the microsoft/aurora HuggingFace repository. For additional information see:

Aurora v1.5 was pretrained on ERA5 and fine-tuned on IFS operational analyses and is recommended to be initialized with IFS analyses. The open-data IFS does not publish sea ice concentration (sic). earth2studio.data.NCAR_ERA5 or earth2studio.data.ARCO_ERA5 may be used instead. GFS is not supported due to missing surface variables.

The iterator yields the initial condition first. Its output-only variables (i10fg, blh, uvb1h, ssrd1h, ttr1h, tp1h, sf1h) contain NaN at that step; subsequent steps contain model predictions. Use Aurora1p5_6h for six-hourly output.

Warning

We encourage users to familiarize themselves with the license restrictions of this model's checkpoints.

Parameters:

  • core_model (Module) –

    Core Aurora1p5 model

  • static_vars (dict[str, Tensor]) –

    Static field tensors, each with shape (720, 1440).

__call__ 

__call__(
    x: Tensor, coords: CoordSystem
) -> tuple[Tensor, CoordSystem]

Runs prognostic model 1 step.

Parameters:

  • x (Tensor) –

    Input tensor

  • coords (CoordSystem) –

    Input coordinate system

Returns:

  • tuple[Tensor, CoordSystem] –

    Output tensor and coordinate system one output time-step in the future

create_iterator 

create_iterator(
    x: Tensor, coords: CoordSystem
) -> Iterator[tuple[Tensor, CoordSystem]]

Creates a iterator which can be used to perform time-integration of the prognostic model. Will return the initial condition first (0th step).

Parameters:

  • x (Tensor) –

    Input tensor

  • coords (CoordSystem) –

    Input coordinate system

Yields:

  • Iterator[tuple[Tensor, CoordSystem]] –

    Iterator that generates time-steps of the prognostic model containing the output data tensor and coordinate system dictionary.

load_default_package classmethod 

load_default_package() -> Package

Load prognostic package

load_model classmethod 

load_model(package: Package) -> PrognosticModel

Load prognostic from package

Parameters:

  • package (Package) –

    Package to load model from

Returns:

  • PrognosticModel –

    Prognostic model