Earth2Studio general release 0.15.0

🚨 Breaking Changes 🚨

• No notable breaks this release 🎉

📕 Changelog

🌎 Added

• Added Himawari-8/9 AHI ISatSS L2 Full Disk satellite data source (HimawariAHI)
• Added GHCN-Daily global station observation data frame source (GHCNDaily)
• Added NNJA conventional (in-situ + GPS RO) observation data source (NNJAObsConv)
• Added GOES Geostationary Lightning Mapper L2 LCFA event data source (GOESGLM)
• Added real-time GDAS conventional observation data source (NomadsGDASObsConv)
• Added quality field to E2STUDIO_SCHEMA for observation QC markers
• Added Climate in a Bottle tropical cyclone guidance and odds ration example
• Added Orbit-2 precipitation downscaling model

⚙️ Changed

• UFS Satellite Obs source is now the only one that provides the UFS specific channel_index and general sensor_index fields, all other now provide sensor_index only which can be used to consistently map from UFS to L1 products
• Added wavenumber (cm−1) field to all satellite schemas
• Changed channel_index to sensor_index in E2STUDIO_SCHEMA
• Disabled Atlas example from documentation build due to slow performance

🔨 Fixed

• Fixed potential uint16 underflow in UFS channel index expansion
• Fixed S3 upload bug in server utilities
• Fixed pres obs from UFS to be Pascal units
• Fixed chunk downloading race condition in file system cache for Zarr data sources
• Fixed 180° longitude misalignment in ECMWF open-data sources for some GRIB files with non-standard lon origin

📦 Dependencies

• Removed nested_asyncio for Python 3.14 compatibility and updated async data sources
• Bumping minimum ecmwf-opendata version to 0.3.29 to resolve IFS data request errors

Special thank you to our external contributors:

• Parth Katlana
• Isaac Lyngaas
• Viktor Cikojević

Earth2Studio general release 0.14.0

🚨 Breaking Changes 🚨

• Following PyTorch 2.11, Earth2Studio dependencies now point to CUDA 13.X installs by default. Later CUDA versions are still usable, however special install procedures might be required.

📕 Changelog

🌎 Added

• Added GenCast 1 degree Mini model
• Added CAMS Global atmospheric composition forecast data source (CAMS_FX)
• Added MetOp AMSU-A Level 1B brightness temperature data source (MetOpAMSUA)
• Added MetOp AVHRR Level 1B radiance/brightness temperature data source (MetOpAVHRR)
• Added JPSS ATMS Level 1 BUFR brightness-temperature data source (JPSS_ATMS)
• Added JPSS CrIS FSR Level 1 spectral radiance data source (JPSS_CRIS)
• Added MetOp IASI Level 1C infrared brightness temperature data source (MetOpIASI)
• Added NClimGrid daily CONUS gridded climate data source (NClimGridDaily)
• Added MTG-I FCI Level-1C Full Disk satellite radiance data source (MeteosatFCI)

🔨 Fixed

• Fixed source code links in documentation

📦 Dependencies

• Added eumdac>=3.1.0 to data optional dependency group for EUMETSAT Data Store access
• Moved package dependencies defaults to CUDA 13.0 following torch
• Moving suggested Python version to 3.13
• Pointing physicsnemo to git main source for torch 2.11 compatibility
• Updated ACE2 dependency hash with setuptools fix
• Updated models using PhysicsNeMo to compliance with nvidia-physicsnemo>=2.0

Special thank you to our external contributors:

• Jerry Lin
• Björn Bethge
• Iype Eldho

Earth2Studio general release 0.13.0

🚨 Breaking Changes 🚨

• Renamed tolerance parameter in ISD data source to time_tolerance
• Changed GraphCastOperational and GraphCastSmall latitude input / output to be [90,-90]
• Removed device from cbottle SR load_model API

📕 Changelog

🌎 Added

• Added NOAA UFS observation dataframe sources for satellite and conventional data
• Added Earth2Studio base schema for dataframe sources
• Added Planetary Computer data source for ECMWF IFS analysis data
• Added accumulated variable support to NCAR ERA5 data source
• Added routine to tile tensors to higher-dimensional tensors
• Added routine to concatenate tensors along specified coordinate dimension
• Added Planetary Computer data source for GOES cloud and moisture imagery
• Added ability to have seperate data and model cache locations via env variables
• Added random dataframe source
• Added base reflectivity to MRMS data source
• Added fetch_dataframe utility function
• Added data assimilation model class
• Added equirectangular interpolation data assimilation model
• Added StormCast SDA model
• Added beta serve utils with inference server and client implementations
• Added HealPix data assimilation (HealDA) model
• Added energy_score metric for multivariate ensemble forecast verification

⚙️ Changed

• Changed available date for ARCO data source to be dynamically updated
• Changed ISD data frame return to master schema
• handshake_coords is now accepting list of dimensions while remaining backwards-compatible
• Updated CBottle infill to mixture of model checkpoints
• Updated GraphCastOperational and GraphCastSmall latitude input / output to be [90,-90]
• Updated GraphCast models to support multiple time inputs, multiple times will be looped not batched
• Renamed tolerance parameter in ISD data source to time_tolerance

❌ Removed

• Removed device from cbottle SR load_model API

🔨 Fixed

• Fixed timezone bug in CBottleVideo that converted UTC time to local system time
• Bug in cbottle datasource resulting identical samples for multiple samples
• Bug in StormCast loading out-of-date model package, introduced in 5518edecbabee371c824b34f0f2ec269a4d6094f
• Bug in spherical perturbations which did not use lmax from the SHT transform

📦 Dependencies

• Added pyarrow explicitly to core dependencies
• Updated CBottle repo to NVlabs location
• Updated Makani dependency hash to later version with pyproject toml fix
• Updated ACE2 dependency hash with setuptools fix
• Updated models using PhysicsNeMo to compliance with nvidia-physicsnemo>=2.0

Special thank you to our external contributors:

• Jerry Lin
• abhaygoudannavar

Earth2Studio patch release 0.12.1

🚨 Breaking Changes 🚨

• No notable breaks this release 🎉

📕 Changelog

⚙️ Changed

• Moved (most) cBottle checkpoints to huggingface repo
• Added config.json download for HF models to track downloads

📦 Dependencies

• Added onnxscript to onnx models to add support for newer torch versions
• Moved lock file / CI system to torch 2.9.1

Earth2Studio general release 0.12.0

🚨 Breaking Changes 🚨

• No notable breaks this release 🎉

📕 Changelog

🌎 Added

• Added CorrDiff CMIP6->ERA5 diagnostic model
• Added derived TCWV diagnostic model
• Added verbose option for inference workflows in run.py to toggle off tqdm
• Added Atlas prognostic model
• Added StormScope GOES and MRMS models

⚙️ Changed

• Removed AIFS-ENS invariants from model input / outputs and moved into model wrapper
• CDS and NCAR lexica have been updated with variables for AIFS-ENS
• Switch grib reads in HRRR data sources from xarray to pygrib to fix memory leak
• Updated AIFS model to 1.1 checkpoint version
• Updated GFS lexicon to include composite reflectivity
• Moved most data sources from cfgrib to pygrib

🔨 Fixed

• Made tp in HRRR and GFS units m for package consistency
• Fixed batched inference support for AIFS and AIFS ENS

📦 Dependencies

• Added pygrib to core dependency group
• Moved cfgrib to optional dependency group
• Resolved conflict between AIFS and AIFS ENS groups
• Removed old numcodecs limit

Special thank you to our external contributors:

• Yuki H. Takano

Earth2Studio general release 0.11.0

🚨 Breaking Changes 🚨

• Removed IMERG data source
• ECMWF data sources for IFS and AIFS have been updated to separate classes for getting analysis data and forecast data

📕 Changelog

🌎 Added

• Added general PlanetaryComputerData source for pulling Planetary Computer STAC assets
• Added ECMWF AIFSENS ensemble prognostic model wrapper
• Added MRMS data source
• Added IFS and IFS-ENS initial state datasources
• Added local datasource example with Microsoft Aurora model
• Added NOAA's Integrated Surface Database (ISD) data frame source

⚙️ Changed

• Removed tp06 field from Graphcast operational model
• Removed static fields from Graphcast model input / outputs
• Moved StormCast and DLESyM checkpoints to Huggingface
• Change previous IFS, IFS_ENS, AIFS and AIFS_ENS sources to IFS_FX, IFS_ENS_FX, AIFS_FX
  and AIFS_ENS_FX to reflect that they are forecast sources
• Support multiple x, coords pairs in batch function decorator

❌ Removed

• Removed support for returning multiple samples at once from IFS ENS data sources
• IMERG datasource

🔨 Fixed

• Vertical wind variables in GFS / GEFS to be Pa s-1

📦 Dependencies

• Removed Aurora-fork option which had a temporary patch for package conflict that is
  resolved in the source aurora package
• Capped PhysicsNeMo to below 2.0

Special thank you to our external contributors:

• Rodrigo Almeida
• David Ahijevych

Earth2Studio general release 0.10.0

🚨 Breaking Changes 🚨

• Dropped Python 3.10 support

📕 Changelog

🌎 Added

• Added Mic PlanetaryComputerData source for pulling Planetary Computer STAC assets
• Added ECMWF AIFSENS ensemble prognostic model wrapper
• Added MRMS data source
• Added IFS and IFS-ENS initial state datasources
• Local datasource example
• Added TimeWindow datasource wrapper for fetching data at multiple time offsets
• Added NOAA's Integrated Surface Database (ISD) data frame source

⚙️ Changed

• Updated CBottle data source to mixture of experts models, added additional parameters
  to load_model to align with other cBottle models.
• Fixed duplicate geo-potential at surface ids in AIFS, IFS data source and orography
  source, orography is denoted by lower case z
• Updated package caching default to None, which will default to true for remote
  packages and false for local packages
• Changed IFS to be a forecast data source.
• InferenceOutputSource can now accept an Xarray Dataset directly as an argument
• InferenceOutputSource returns data consistently in ("time", "lead_time", "variable")
  order
• Added support for ERA5 model levels and additional variables in ARCO data source
• Changed the HRRR_X and HRRR_Y coordinates of the HRRR data source to match the native
  LCC coordinates
• Updated CorrDiffTaiwan model wrapper to use latest PhysicsNeMo APIs.

⚠️ Deprecated

• Added deprecated warning for IMERG data source. This will be removed in the next
  release.

🔨 Fixed

• Fixed typo: InferenceOuputSource renamed to InferenceOutputSource
• StormCast ensures that conditioning variables are in the correct order
• NetCDFBackend unit change to ensure timedeltas are correctly decoded by xarray
• GFS data source for early 2021 dates
• Updated corrdiff wrapper for newer physicsnemo performance improvements

📦 Dependencies

• Dropped support for Python 3.10
• Bumped CBottle (and Earth2Grid) versions
• Capped JAX version, due to numpy 2.0 requirement conflicting with NV PyTorch containers
• Temp limit globus-sdk for intake-esgf
• Added multi-storage client into data dependency group

Special thank you to our external contributors:

• Joshua-Elms
• Rodrigo Almeida

Earth2Studio general release 0.9.0

🚨 Breaking Changes 🚨

• This is the last release with Python 3.10 support! Please upgrade Python version to at least 3.11 for main branch and future releases.

📕 Changelog

🌎 Added

• Async Zarr IO backend with non-blocking write calls
• Different compression codec support in the ZarrBackend with zarr_codecs parameter
• IO performance example
• Unified CorrDiff Wrapper
• Added UV script dependencies to all examples
• New metrics: Brier score, fractions skill score, log spectral distance, mean absolute error.
• Option to compute error of ensemble mean in rmse and mae.
• Added FourCastNet 3 model

⚙️ Changed

• Zarr IO Backend now uncompressed by default
• Allow HCBV perturbation to handle constant outputs (like land sea mask, or
  geopotential at surface)
• test/models/dx/test_corrdiff.py is now test/models/dx/test_corrdiff_taiwan.py
• Updated APIs for optional dependency managment utils with improved error messages
• Allow Zarr backends to user datetime and timedelta arrays for Zarr 3.0

🔨 Fixed

• Incorrect datetime utc timezone calculation in SFNO wrapper was fixed.
• DLWP output coords lead_time array to have proper shape
• Fixed data sources using GCFS throwing error at end of script from aiohttp session
  clean up
• Fixed HRRR_FX valid lead time check for date times not on 6 hour interval
• Removed time limits for WB2 climatology data source

📦 Dependencies

• Adding rich to core dependencies
• Updated torch-harmonics to 0.8.0
• Updated Makani to 0.2.1

Special thank you to our external contributors:

• Rodrigo Almeida

Earth2Studio patch release 0.8.1

🚨 Breaking Changes 🚨

• No notable breaks this release 🎉

📕 Changelog

⚙️ Changed

• Updated default StormCast package version to 1.0.2

🔨 Fixed

• NGC filesystem from API change in version >=3.158.1 of ngcsdk

📦 Dependencies

• Removed ngcsdk dependency requirement for public NGC packages

Earth2Studio general release 0.8.0

🚨 Breaking Changes 🚨

• No notable breaks this release 🎉

📕 Changelog

🌎 Added

• Added GraphCast operational model (0.25 degree resolution)
• Added Graphcast 1 degree model
• Added SolarRadiationAFNO diagnostic model for predicting surface solar radiation
• Added DataArrayPathList for reading local data using glob patterns or explicit file lists
• Added Climate in a Bottle (cBottle) data source
• Added Climate in a Bottle (cBottle) Infilling diagnostic model
• Added Climate in a Bottle (cBottle) Super Resolution diagnostic model
• Added S2S recipe

⚙️ Changed

• In recipes, renamed requirements.txt -> recipe-requirements.txt

🔨 Fixed

• Fixed NCAR data source lat / lon labels and cache reads
• Fixed FuXi tp06 field input to be mm
• Fixed fsspec async filesystem initialization in data sources
• Fixed bug in GFS_FX forecast source which had lead time fixed at 0

📦 Dependencies

• Moved NGC SDK to optional dependencies due to it causing slow version resolutions
• Removing upper Python restriction on Rapids install for TC trackers