Skip to content

E3SM v3.2.0

Latest

Choose a tag to compare

@rljacob rljacob released this 18 Nov 04:45
· 4572 commits to master since this release
v3.2.0
648b167

E3SM V3.2 Description

Version 3.2 of the Energy Exascale Earth System Model.

Description and New Features

Version 3.2 includes all capabilities of v3.1 and adds updated high-resolution defaults, expanded coupled human and wave capabilities, additional online processing for emulation workflows, and a broad set of scientific and technical improvements across the model.

Some changes alter the climate of standard v3 configurations relative to v3.1.0 and v3.0.0.

The default grid configuration for the low-resolution configuration of v3 remains a “trigrid” consisting of:

  • Atmosphere on ne30pg2 (physics grid).
  • Ocean and sea ice on IcoswISC30E3r5.
  • Land and river run-off on a common r05 grid.

The high-resolution coupled configuration introduced in v3.1 remains part of v3.2:

  • v3.HR on ne120pg2_r025_RRSwISC6to18E3r5.

Additional coupled capabilities and configurations were added for v3.2:

  • Further support for CMIP7-based high-resolution forcings, including 1950 and 20TR forcing support for v3.HR.
  • Expanded coupling with the GCAM human system model, including human component use cases and resolution-matched configurations.
  • New wave-enabled repeating-2010 compsets, including CRYO2010-WW3 and WCYCL2010-WW3.
  • Online processing to generate output for Full Model Emulation (FME) training.
  • Additional driver-moab coupled capability, including nonlinear maps and budget calculations matching driver-mct.

Planned Simulations

Data from the following simulations will be made available:

  • A high-resolution 125-year perpetual 1950 coupled simulation.
  • A three-member ensemble high-resolution transient coupled simulation from 1950 to 2023.
  • A low-resolution 200 year fully coupled simulation with repeating 2010 forcing.
  • Two Low Resolution 200-yr Wave-enabled simulations under repeating 2010-forcing:
    • A fully coupled low-res wave run (LRW; with waves fully coupled to atmosphere, ocean and sea ice)
    • A partially-coupled low-res wave run with waves fully coupled to atmosphere, ocean but NO wave-sea ice interactions.

Watch E3SM Data Docs for information.

Climate-Changing and Answer-Changing Updates

Several changes in v3.2 are expected to change answers relative to v3.1, including changes that affect the climate of standard configurations:

  • MPAS-Seaice now uses Icepack v1.5.3.
  • MPAS-Ocean removes a redundant sea-ice enthalpy flux term affecting all configurations with active ocean and sea ice components.
  • MPAS-Seaice changes the default melt pond scheme to the sea level melt pond scheme available in Icepack v1.5.3.
  • Polar cases now default to the tri-grid budget conserving nonlinear atmosphere-to-surface map option nlmaps_atm2srf_conserve.
  • Final atmosphere and ocean parameter tunings for v3.HR are set as defaults.

Other answer-changing or scientifically important changes include:

  • MPAS-Ocean adds free-slip, partial-slip, and no-slip lateral wall momentum boundary conditions.
  • MPAS-Ocean updates Southern Ocean refined configuration defaults to enable Langmuir mixing, latitude-dependent Southern Ocean background diffusivity, and one-step congelation freezing.
  • MPAS-Ocean adds an option to use EAM-generated dust and iron deposition in marine biogeochemistry configurations.
  • MALI updates calving defaults for Greenland meshes used in prognostic E3SM simulations.
  • MOSART redirects negative groundwater-like runoff in selected low-resolution wave-enabled configurations.
  • MPAS-Seaice adjusts low-resolution wave configuration namelist defaults and reduces the sea-ice initialization disk poleward of 85 degrees for LRW configurations.
  • EAMxx fixes behavior in the IOP remapper for DP/IOP cases with pack sizes greater than one and level counts not divisible by the pack size.
  • ELM updates FATES through API 44, including updated default FATES land-use data files.

Atmosphere

The atmospheric component remains EAM. EAM in v3.2 includes focused high-resolution support and continued infrastructure and forcing updates:

  • Added v3.HR 1950 CMIP7 forcings.
  • Updated EAM and ELM CMIP7 forcings for the v3.HR 1950 configuration.
  • Final atmosphere parameter tunings for v3.HR are part of the default configuration for that case.

HOMME updates include:

  • Improved standalone and CIME-based testing.
  • Use of more MPI tasks where tests allow it.
  • Debug builds now consistently use debug flags.
  • New CMake machine files for pm-gpu.
  • Per-test timing and maximum standalone test timing support.
  • Removal of global data gathering in phys_grid_mod.
  • Updated HOMME2SCRIP.py NetCDF output typing.
  • Increased tracer mass conservation tolerance so that eam-thetahy_sl_pg2_mass passes.

EAMxx remains an optional atmosphere component and is not yet supported in production configurations. Development in v3.2 continued rapidly, with substantial model, diagnostics, and infrastructure advances:

  • Completed the port of ZM deep convection subroutines to C++.
  • Added a separate vertical remapper for elevated emissions.
  • Reworked vertical remapping to categorize by vertical tag rather than midpoint/interface.
  • Made diagnostics independent of the atmospheric process stack.
  • Propagated mask fields to generic diagnostics and generalized Field::update for masked affine transformations.
  • Added Field::alias overloads for dimension tag renaming and support for copying selected data and metadata in a field clone.
  • Refactored field utilities and sampling diagnostics so utilities perform weighted sums while diagnostics manage masking and averaging.
  • Updated MAM4xx for faster photolysis tables and improved heterogeneous freezing.
  • Added support for all SCORPIO PIO_TYPE options in I/O configuration.
  • Made Field a shallow-const container and preserved allocation properties in process tendency fields.
  • Fixed tendency units and metadata inheritance issues in namelist defaults.
  • Shortened remapper timer names and improved units usage after EKAT updates.
  • Added and documented additional P3 physical-property tests, including cloud-liquid immersion freezing and rime density.
  • Added support for the Ninja generator in test-all-eamxx.
  • Fixed loop upper bounds when printing rank-5 fields.
  • Simplified workflows by removing NODE_EXTRA_CA_CERTS handling.
  • Enabled linear time interpolation for reading multi-year SPC files.
  • Added more flexible vertical remapping and further online diagnostic improvements.

Land

The land component remains ELM. In v3.2, land development focused on FATES updates, metadata improvements, and coupled human-system support:

  • Updated FATES through API 44 across the v3.2 cycle.
  • Updated default FATES land-use data files.
  • Added units and long_name metadata to restart file variables.

FATES updates in v3.2 include:

  • Updated land-use and default data inputs.
  • Continued support for evolving fire, ecosystem, and demographic capabilities introduced in earlier v3 releases.

GCAM coupling was expanded in v3.2:

  • Added human component use cases.
  • Merged human component namelists into a single configuration path.
  • Added support for multiple human component resolutions matched to the land grid.
  • Added diagnostics for coupled carbon flux support.
  • Updated the GCAM submodule and GIAC-related tooling on the infrastructure side.

River

The river model remains MOSART. In v3.2, updates are limited but include answer-changing behavior for selected configurations:

  • Negative qgwl is redirected in low-resolution wave-enabled configurations through namelist default changes.
  • Coupled driver and testing support was expanded for cases involving river interactions.

Ocean

The ocean component remains MPAS-Ocean. v3.2 includes climate-changing fixes, new physical options, biogeochemistry support, and high-resolution tuning:

  • Removed a redundant sea-ice enthalpy flux term, affecting all configurations with active ocean and sea ice components.
  • Updated defaults for SOwISC12to30E3r3 to enable Langmuir mixing, latitude-dependent Southern Ocean background diffusivity, and one-step congelation freezing.
  • Added free-slip, partial-slip, and no-slip momentum boundary conditions through a new lateral_walls namelist section and config_wall_slip_factor.
  • Fixed cell-vertex layer-thickness remapping across partially masked duals.
  • Added an option to use EAM-generated dust and iron deposition in ocean biogeochemistry.
  • Disabled mixed-layer heat budget calculations when tracer budgets are disabled.
  • Updated MARBL to the MARBLv3 branch for marine biogeochemistry configurations.
  • Fixed an RK4 time-stepper bug that affects RK4-only cases.
  • Final ocean parameter tunings for v3.HR are set as defaults.

Sea Ice

The sea-ice component remains MPAS-Seaice. Major v3.2 changes include an updated Icepack base and several answer-changing default adjustments:

  • Replaced the Icepack submodule with Icepack version 1.5.3 and updated MPAS-Seaice accordingly.
  • Changed the default melt pond scheme to the sea level melt pond scheme from Icepack v1.5.3.
  • Added surface tilt force, ocean stress, and stress-divergence fields to the monthly output stream.
  • Adjusted low-resolution wave configuration defaults, including elastic subcycle number and one-step congelation freezing.
  • Reduced the sea-ice initialization disk to poleward of 85 degrees for wave-enabled low-resolution configurations.
  • Added a statistical reproducibility test for MPAS-Seaice.

Land-Ice

The land-ice component remains MALI. The land-ice component is still not yet supported in production configurations, but v3.2 includes further capability and configuration updates:

  • Set default calving parameters for Greenland meshes used in prognostic E3SM simulations.
  • Updated from MALI-Dev/develop with a spatially varying crevasse-depth calving law.
  • Improved Runge-Kutta time stepping.
  • Added new subglacial hydrology options.
  • Refactored flood-fill logic and fixed related bugs.
  • Additional v3.HR and Greenland-related tuning and configuration updates continue the expansion begun in v3.1.

Waves

The optional wave component remains WAVEWATCH III. WW3 is still not yet supported in production simulations, but v3.2 expands coupled wave capability:

  • Added CRYO2010-WW3 and WCYCL2010-WW3 compsets for repeating 2010 conditions.
  • Updated the WW3 submodule for much faster initialization of unresolved obstacle files.
  • Reverted a frequency-array indexing change that caused divide-by-zero behavior.
  • Wave-related coupled defaults were adjusted in some low-resolution configurations.

Coupler & Driver

The default coupler remains cpl7/MCT through driver-mct, while driver-moab continued substantial development in v3.2.

driver-mct changes include:

  • Polar cases now default to nlmaps_atm2srf_conserve which helps with conservation in tri-grid cases near coastlines (nlmaps is always conservative).

driver-moab changes include:

  • Added nonlinear map support matching driver-mct.
  • Enabled writing of auxiliary history files.
  • Allowed the coupler to use its own processor pool.
  • Separated lateral exchange infrastructure from ELM.
  • Improved rpointer robustness.
  • Closed memory leaks.
  • Replaced a redundant atmosphere-to-ocean remap with saved tag values.
  • Added heat, water, and carbon budget calculations matching driver-mct.
  • Got MOAB working on mappy and refactored cplcomp_moab_Init with shared helpers.
  • Additional tests now cover ported X-cases, online maps, and debug paths.

AI/ML and Infrastructure

v3.2 adds further infrastructure for emulation, diagnostics, build portability, and tooling:

  • Added online processing to generate output for Full Model Emulation (FME) training.
  • E3SM can now perform horizontal remapping to lat-lon, vertical coarsening, derived-field computation, and writing of ready-to-train NetCDF history files directly from the running model.
  • Added an extra debug testmod driven by a new EXTRA_DEBUG XML setting.
  • Updated SCORPIO through version 1.9.3 during the v3.2 cycle.
  • Updated EKAT and related build-system dependencies.
  • Moved or updated MOAB_ROOT on several machines so driver-moab cases can run.
  • Updated CIME and testing support for coupled human and MOAB-driven cases.
  • Improved support for non-HPC and developer workflows through testing and generator enhancements.