Examples#

This is a collection of examples in Earth2Studio that demonstrate various functionality and commonly used workflows.

Running Examples

Earth2Studio examples can be downloaded as a notebook or runnable Python script. Each requires installation of different optional dependency groups or additional packages for the specific models used or post-processing steps. Use uv to auto install dependencies on execution:

uv run <example_script>.py

If you are using a container or other type of environment, then pip installing will likely be needed. Look for the uv inline metadata blocks of the form:

# /// script
# dependencies = [
#   "earth2studio @ git+https://github.com/NVIDIA/earth2studio.git",
#   "cartopy",
# ]
# ///

Pip install these packages then execute the example with:

python <example_script>.py

Getting Started#

Introductory examples demonstrating the core inference workflows in Earth2Studio.

Image

Running Deterministic Inference

Running Deterministic Inference
Image

Running Diagnostic Inference

Running Diagnostic Inference
Image

Running Ensemble Inference

Running Ensemble Inference

Medium Range#

Examples focused on medium-range global weather forecasting, ensemble methods, and post-processing workflows.

Image

Single Variable Perturbation Method

Single Variable Perturbation Method
Image

Model Hook Injection: Perturbation

Model Hook Injection: Perturbation
Image

Huge Ensembles (HENS) Checkpoints

Huge Ensembles (HENS) Checkpoints
Image

Temporal Interpolation

Temporal Interpolation
Image

Tropical Cyclone Tracking

Tropical Cyclone Tracking

Downscaling#

Examples demonstrating generative and ensemble downscaling workflows for producing high-resolution outputs from global model forecasts.

Image

Generative Downscaling

Generative Downscaling
Image

CBottle Super Resolution

CBottle Super Resolution
Image

Ensemble Forecasting with Downscaling

Ensemble Forecasting with Downscaling

Nowcasting#

Examples demonstrating high-resolution nowcasting and short-range forecasting with models such as StormCast and StormScope.

Image

Running StormCast Inference

Running StormCast Inference
Image

Running StormCast Ensemble Inference

Running StormCast Ensemble Inference
Image

StormScope Satellite and Radar Nowcasting

StormScope Satellite and Radar Nowcasting

Data Assimilation#

Examples demonstrating data assimilation workflows in Earth2Studio.

Image

StormCast Score-Based Data Assimilation

StormCast Score-Based Data Assimilation
Image

HealDA Global Data Assimilation

HealDA Global Data Assimilation

Subseasonal to Seasonal#

Examples demonstrating subseasonal to seasonal (s2s) inference workflows with typical prediction timescales of two weeks to two years.

Image

Statistical Inference

Statistical Inference
Image

Running DLESyM Inference

Running DLESyM Inference

Miscellaneous#

Miscellaneous examples covering IO performance, custom data sources, and other utility workflows.

Image

Distributed Manager Inference

Distributed Manager Inference
Image

CBottle Data Generation and Infilling

CBottle Data Generation and Infilling
Image

IO Backend Performance

IO Backend Performance
Image

Creating a Local Data Source

Creating a Local Data Source

Extending Earth2Studio#

Examples focused on demonstrating how to extend Earth2Studio with user-defined components.

Image

Extending Prognostic Models

Extending Prognostic Models
Image

Extending Diagnostic Models

Extending Diagnostic Models
Image

Extending Data Sources

Extending Data Sources

Gallery generated by Sphinx-Gallery