E3SM-Project/e3sm-unified: v1.12.0

In this version

• Many packages have been updated, including:

  • chemdyg 1.1.1
  • dask 2025.9.1
  • e3sm_diags 3.1.0
  • e3sm_to_cmip 1.13.0
  • esmf 8.9.0
  • esmfpy 8.9.0
  • hdf5 1.14.6
  • libnetcdf 4.9.3
  • livvkit 3.2.0
  • mache 2.0.0
  • matplotlib 3.10.6
  • moab 5.6.0
  • mosaic 1.12.1
  • mpas_analysis 1.14.0
  • mpas_tools 1.4.0
  • mpi4py 4.1.1
  • nco 5.3.6
  • pcmdi_metrics 4.0.1
  • proj 9.6.2
  • pyproj 3.7.2
  • tempest-extremes 2.4
  • xarray 2025.9.0
  • xcdat 0.10.1
  • zppy 3.1.0
  • zppy-interfaces 0.2.0
  • zstash 1.5.0

• python versions 3.11, 3.12, and 3.13 will be supported

New and improved

• ChemDyg 1.1.0:

  • Updates to be compatible with zppy (v3.0.0)
  • Some minor fixes

• E3SM-Diags 3.0.1 and 3.1.0 :

  • New features:

    • Support for plotting data on native grids (e.g., cubed-sphere, unstructured grids) using UXarray, see example-native-grid-visualization
    • Snapshot analysis on core diagnostic sets (lat_lon, lat_lon_native, polar, zonal_mean_2d, meridional_mean_2d, zonal_mean_2d_stratosphere), allowing analysis of individual time steps of model data, see example-snapshot-analysis. model vs obs support will be included in next releases.
    • Full support of 2d land variable in model vs model run.
    • Included AR and ETC detection script for standalone use.

  • User-facing Bug fixes and Enhancements

    • Fixed tropical_subseasonal set by supporting processing year values less than 1000
    • Fixed streamflow diagnostics to support dynamic resolution
    • Added v3LR to baseline in Taylor Diagram and CMIP comparison plots
    • Updated tropical_subseasonal set for EAMxx output

• e3sm_to_cmip v1.13.0 (since 1.11.3):

  • Added support for new v3 atmosphere variable handlers.
  • Introduced 3D aerosol species mixing ratio variable.
  • Centralized results directories, revamped logging, and improved logger readability.
  • Optimized entry point and argument parsing for faster runtime setup.
  • Matched variable handlers by compatible frequency and raw variable names.
  • Fixed MPAS handler logging and temporary directory issues to prevent file collisions and hanging.
  • Ensured unique user_metadata.json files across parallel processes.
  • Added fill_nan() to replace np.nan with proper CMOR fill values.
  • Preserved legacy Xarray compat, join, and data_vars behaviors for stability.
  • View the full changelog for more information.

• LIVVKit 3.1.0:

  • Handles missing performance files more gracefully
  • Improves file diff section header titles

• MOAB 5.6.0:

  • iMOAB, BfB, and remapping: Unified iMOAB API for online and offline linear map workflows, faster parallel SCRIP and domain file reading with dynamic partitioning, correct RLL grid rank propagation, and fully BfB reproducible map projections using arbitrary decompositions.
  • CAAS and visualization: Added parallel CAAS nonlinear bounds-preserving filter and enhanced MOAB VisIt plugin support to visualize linear map couplings alongside meshes and fields.
  • Regression and comparison tools: Expanded regression testing with the compare H5M utility, added new tools to compare projection data and offline maps generated with mbtempest, and improved metadata handling to ensure consistent grid rank/dimension of meshes and fields.
  • Detailed changelogs provide more information about all updates.

• mosaic 1.2.1:

  • Mirroring of planar periodic meshes across periodic boundaries.
  • Better support for directly plotting from restart files.

• MPAS-Analysis 1.14.0:

  • Enhanced ocean and sea-ice diagnostics: more robust conservation time series, expanded variables for polar regions and mass flux analysis, improved barotropic streamfunction handling, and fixes for hangs and missing projections.
  • Broader and more flexible analysis capabilities: support for custom climatology maps (2D/3D), improved transect processing (including NetCDF transects), addition of wind-stress-curl map plots, and better handling of anomalies and regional time series.

• NCO 5.3.6:

  • ncremap fixes OpenMP use for horizontal & vertical regridding
  • ncclimo --rgn_stt automatically selects only 2D spatial variables for global timeseries
  • ncks S1D ELM gridifier can aggregate fields over all Urban landunit types
  • ncremap better detects and warns about corrupt input

• xcdat 0.10.1 (since 0.8.0):

  • Added options to output regridding weights and infer vertical target data.
  • Introduced weight thresholds for spatial and temporal averaging.
  • Improved time frequency inference using median delta calculation.
  • Enhanced coordinate handling and added curvilinear grid support.
  • Fixed major xgcm and xESMF integration issues and regridding alignment.
  • Preserved legacy Xarray open_mfdataset() behaviors to prevent breaking changes.
  • Constrained cf_xarray >= 0.10.7 for correct non-monotonic bounds handling.
  • Removed mask from grid creation to fix xESMF issues.
  • Improved performance and stability across regridding and temporal operations.
  • View the full changelog for more information.

• zppy 3.1.0:

  • zppy v3.1.0 adds two new features and is designed for use with zppy-interfaces v0.2.0.
    • Users may now include pcmdi_diags. zppy currently supports mean_climate, variability_modes_cpl, variability_modes_atm, and synthetic_plots. Support for enso will come in a later release. Please note we are considering this to be a "beta release" of pcmdi_diags. Please let the developers know if you encounter any issues by posting on the discussion page. Example cfgs using pcmdi_diags are available here and here.
    • The global_time_series task now has improved performance and clearer distinctions between its operating modes (i.e., a multi-plot PDF or viewers similar to those of e3sm_diags).
  • Other improvements include adding provenance cfg files to the output and web directories for easier debugging, removing machine specific paths, updating the default cfg for ilamb, supporting job_nbr in the ts_task, fixing the regex for tc_analysis, and fixing year looping for land model-vs-model in e3sm_diags.

• zppy-interfaces 0.2.0:

  • Adds support for the new features (pcmdi_diags and improvements to global_time_series) included in zppy v3.1.0.

• zstash 1.5.0:

  • zstash v1.5.0 includes two important updates:
    • Globus authentication has been simplified. Now, instead of running a "toy problem", pasting an auth code twice, and then running the desired command, users can immediately run their desired command and will only be prompted for an auth code once. Additionally, there is no longer a need to delete a token file except when switching to a new destination endpoint.
    • zstash will now detect database corruptions such as a tar appearing multiple times.

What's Changed

• Add docs workflow by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/129
• Flesh out the documentaiton by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/130
• Fix docs path in GitHub Action by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/131
• Add table of contents and missing pages by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/132
• Further fixes to the docs, particularly the table of contents by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/133
• Fix link in gh-pages root by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/134
• Automatically detect E3SM-Unified version and dev labels by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/135
• Yet more updates and fixes to the docs by @xylar in https://github.com/E3SM-Project/e3sm-unified/pull/136
• Add instructions for ceating env on Apple Silicon by @andrewdnolan in https://github.com/E3SM-Project/e3sm-unified/pull/138
• Update to 1.12.0 by @andrewdnolan in https://github.com/E3SM-Project/e3sm-unified/pull/137

New Contributors

• @andrewdnolan made their first contribution in https://github.com/E3SM-Project/e3sm-unified/pull/138

Full Changelog: https://github.com/E3SM-Project/e3sm-unified/compare/1.11.1...1.12.0