MAPL 2.69.0

[mathomp4]

Note to developers

This will be the last version of MAPL v2 based on the develop branch. MAPL v3 is now in active development and the develop branch will soon be MAPL v3 based.

We will branch main off of v2.69.0 as release/v2 and all PRs for MAPL v2 should be based on the release/v2 branch.

---

This release includes bug fixes, an enhancement to ExtDataDriver.x, and the removal of the short-lived MAPL_SUPPORT_MAPL3 build option.

Key Highlights:

• New RUN_LIKE_MODEL option in ExtDataDriver.x: Controls whether the clock ticks before (model-like) or after (default/legacy) each step, making it easier to reproduce true model behavior in testing (This adds adds a new option to ExtDataDriver.x #4886).

• ExtData2G non-CF vertical coordinate compatibility: Improved handling of non-CF dimensionless vertical coordinates; standard_name is now mapped to long_name for better compatibility with non-CF inputs (Update to extdata2g compatibility with non-CF inputs #4802).

• Bug Fixes:

  • Fixed a bug in WireComponent affecting TerminateImport and removed an unnecessary _ASSERT in MAPL_TerminateImportAllBut (Bugfix/fix do not connect #4674).
  • Fixed an informative error message when extrapolation is attempted without a valid range in ExtData2G (Fixes #4645 #4649).
  • Fixed SIGFPE (integer divide by zero) in MAPL_LoadBalanceMod when the load balancing algorithm evaluates maximum differences to zero (Fix SIGFPE (integer divide by zero) in MAPL_LoadBalanceMod #4643).
  • Python bridge: removed an odd 3rd-party dependency caused by importing no_type_check outside the standard library ([Fix | Python] Remove odd 3rd part dependency #4800).
  • Relaxed the comparison standard for grid_is_ok (Feature/wjiang/relax grid is ok #4870).

All testing shows this is zero-diff to MAPL 2.68.0

---

This version of MAPL was tested with:

• Intel Fortran Classic (ifort) 2021.13
• Intel Fortran (ifx) 2025.3
• GCC 13.2.0, 14.2.0, and 15.2.0
• NAG 7.2
• Flang 22.1

The libraries this version of MAPL is currently tested with are below.

• Baselibs 8.27.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 9.0.0b10 (Note: MAPL only requires 8.6.1 at the moment)
  • GFE 1.23.0
    • gFTL 1.17.0
    • gFTL-shared 1.12.0
    • pFUnit 4.16.0 (optional)
    • fArgParse 1.10.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.18.0 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)
  • UDUNITS2 2.28.8

Also, if you build with Baselibs and/or -DUSE_F2PY=ON, you should use (at least):

• ESMA_cmake v4.37.0

We recommend most external users set -DUSE_F2PY=OFF

We also require CMake 3.24 or higher.

---

From CHANGELOG.md

Fixed

• Relaxed comparison standard for grid_is_ok. Added a test program to querry index
• Fixed bug in WireComponent affecting TerminateImport
• Removed unnecessary _ASSERT in MAPL_TerminateImportAllBut
• Fixed bug so that an informative error message will be emitted when extrapolation is attempted to be used without a valid range in ExtData2G
• Fixed SIGFPE (integer divide by zero) in MAPL_LoadBalanceMod when load balancing algorithm evaluates maximum differences to zero.
• Python bridge: remove odd 3rd party dependency due to importing no_type_check outside of the standard library

Added

• Add new RUN_LIKE_MODEL options to ExtDataDriver.x to control whether clock ticks before (like model) or after (default and behaviour before this)

Changed

• Switch 6 lightweight CI workflows to ubuntu-slim runner to reduce concurrency pressure on ubuntu-latest (Switch lightweight CI workflows to ubuntu-slim runner #4841)
• Update components.yaml
  • ESMA_cmake v4.37.0
    • Add Coverage CMake build type
• Update CTest configuration for Coverage tests
• Changed standard_name to long_name in handling of non-CF dimensionless vertical coordinate in ExtData2G

Removed

• Removed MAPL_SUPPORT_MAPL3 CMake build option and all associated MAPL_TARGET_PREFIX variable logic (Remove MAPL_SUPPORT_MAPL3 build option #4633). The dual-mount MAPL2+MAPL3 approach has been abandoned in favour of a single-mount MAPL3-only strategy.

---

What's Changed

• v2: specify fixed site name for CDash runs in GitHub Actions by @mathomp4 in v2: specify fixed site name for CDash runs in GitHub Actions #4628
• Auto GitFlow - main → develop by @github-actions[bot] in Auto GitFlow - main → develop #4631
• Remove MAPL_SUPPORT_MAPL3 build option by @tclune in Remove MAPL_SUPPORT_MAPL3 build option #4634
• Update CI and CDash code for coverage by @mathomp4 in Update CI and CDash code for coverage #4640
• Auto GitFlow - main → develop by @github-actions[bot] in Auto GitFlow - main → develop #4642
• Fix SIGFPE (integer divide by zero) in MAPL_LoadBalanceMod by @mathomp4 in Fix SIGFPE (integer divide by zero) in MAPL_LoadBalanceMod #4643
• Fixes Swapped args in index() in ExtData2G #4645 by @bena-nasa in Fixes #4645 #4649
• Bugfix/fix do not connect by @atrayano in Bugfix/fix do not connect #4674
• Auto GitFlow - main → develop by @github-actions[bot] in Auto GitFlow - main → develop #4765
• [Fix | Python] Remove odd 3rd part dependency by @FlorianDeconinck in [Fix | Python] Remove odd 3rd part dependency #4800
• Update to extdata2g compatibility with non-CF inputs by @tclune in Update to extdata2g compatibility with non-CF inputs #4802
• Switch lightweight workflows to ubuntu-slim by @mathomp4 in Switch lightweight workflows to ubuntu-slim #4843
• Feature/wjiang/relax grid is ok by @weiyuan-jiang in Feature/wjiang/relax grid is ok #4870
• This adds adds a new option to ExtDataDriver.x by @bena-nasa in This adds adds a new option to ExtDataDriver.x #4886
• v2: Prepare for 2.69.0 release by @mathomp4 in v2: Prepare for 2.69.0 release #4891
• GitFlow: Merge develop into main for 2.69.0 release by @mathomp4 in GitFlow: Merge develop into main for 2.69.0 release #4899

Full Changelog: v2.68.0...v2.69.0

---

This discussion was created from the release MAPL 2.69.0.