MAPL 2.40.3.1

NOTE: This is a special tweak release of MAPL 2.40.3. We do not recommend users use this version unless specifically told to.

This version of MAPL is essentialy v2.40.3 but with changes and fixes for ESMF 8.6.1 backported from newer tags. Thus, unlike MAPL 2.40.3, this version requires at least ESMF 8.6.1 (due to CMake changes).

---

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

• Baselibs 7.14.0
  • netcdf-c 4.9.2 (Needed for quantize support, but not required for all of MAPL)
  • netcdf-fortran 4.6.1 (Needed for quantize support, but not required for all of MAPL)
  • ESMF 8.6.1
  • GFE 1.11.0
    • gFTL 1.10.0
    • gFTL-shared 1.6.1
    • pFUnit 4.7.3 (optional)
    • fArgParse 1.5.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.9.5 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES, default=NO)

Also, if you build with -DUSE_F2PY=ON, you will need:

• ESMA_cmake v3.31.1

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Changed

• Backport changes to use ESMF 8.6.1 to 2.40.3
  • Update to use ESMF::ESMF target
  • Update to ESMF 8.6.1 FindESMF.cmake file
  • Remove excessive prints in generic/OpenMP_Support.F90

---

Full Changelog: v2.40.3...v2.40.3.1

MAPL 2.50.2

This patch release of MAPL 2.50 fixes a bug with the placement of a cycle in a coupler loop in History. This bug was exposed in the pert code used in GEOSadas.

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 and 2021.13 (Note: ifx does not yet work)
• GCC 13.2.0 and 14.2.0
• NAG 7.2

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

• Baselibs 7.25.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1
  • GFE 1.16.0
    • gFTL 1.14.0
    • gFTL-shared 1.9.0
    • pFUnit 4.10.0 (optional)
    • fArgParse 1.8.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.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 v3.51.0

We recommend most external users set -DUSE_F2PY=OFF

We also require CMake 3.23 or higher.

---

From CHANGELOG.md

Fixed

• Fixed bug with cycle placement in coupler loop in History

---

What's Changed

• fixes #3131 by @bena-nasa in #3132

Full Changelog: v2.50.1...v2.50.2

MAPL 2.47.1.2

This is a tweak patch on top of v2.47.1.1. It has a fix for a timer bug when using History and the GEOS Pert application.

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 (Classic 2021.13 seems to work, ifx does not yet work)
• GCC 13.2.0
• NAG 7.2

The libraries this version of MAPL is currently tested with are below. NOTE: Changes here from MAPL 2.44 and earlier, namely GFE

• Baselibs 7.24.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1b04 (8.6.0 is enough for Baselibs builds, but 8.6.1 is required for Spack)
  • GFE 1.15.0
    • gFTL 1.13.0
    • gFTL-shared 1.8.0
    • pFUnit 4.9.0 (optional)
    • fArgParse 1.7.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.0 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)

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

• ESMA_cmake v3.46.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Changed

• Fixed timer bug in History with GEOS pert application

---

Full Changelog: v2.47.1.1...v2.47.1.2

MAPL 2.47.1.1

This is a tweak release on MAPL v2.47.1 with a fix needed for GEOSadas development. It has a minor revision (and generalization) of MAPL_DefGridName for GSI purposes

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 (Classic 2021.13 seems to work, ifx does not yet work)
• GCC 13.2.0
• NAG 7.2

The libraries this version of MAPL is currently tested with are below. NOTE: Changes here from MAPL 2.44 and earlier, namely GFE

• Baselibs 7.24.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1b04 (8.6.0 is enough for Baselibs builds, but 8.6.1 is required for Spack)
  • GFE 1.15.0
    • gFTL 1.13.0
    • gFTL-shared 1.8.0
    • pFUnit 4.9.0 (optional)
    • fArgParse 1.7.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.0 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)

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

• ESMA_cmake v3.46.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Changed

• Minor revision (and generalization) of grid-def for GSI purposes

---

Full Changelog: v2.47.1...v2.47.1.1

MAPL 2.50.1

This is a patch release on MAPL 2.50. It fixes an uninitialized variable found when running with GNU and ExtData2G when built with Debugging compiler options.

All tests show this is zero-diff to MAPL 2.50.0.

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 and 2021.13 (Note: ifx does not yet work)
• GCC 13.2.0 and 14.2.0
• NAG 7.2

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

• Baselibs 7.25.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1
  • GFE 1.16.0
    • gFTL 1.14.0
    • gFTL-shared 1.9.0
    • pFUnit 4.10.0 (optional)
    • fArgParse 1.8.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.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 v3.51.0

We recommend most external users set -DUSE_F2PY=OFF

We also require CMake 3.23 or higher.

---

From CHANGELOG.md

Fixed

• Fixed unitialized variable bug in ExtData exposed by gfortran

---

What's Changed

• Fixes #3073 by @bena-nasa in #3107

Full Changelog: v2.50.0...v2.50.1

MAPL 2.50.0

This release of MAPL has a fix for using point source emissions with stretched cube-sphere grids. This code was introduced in MAPL 2.45.0 and before this fix, leads to point sources on wrong faces of the cube (see this comment for before-and-after).

Beyond this, we also set the new minimum CMake version required to 3.23 as well as better error trapping.

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 and 2021.13 (Note: ifx does not yet work)
• GCC 13.2.0 and 14.2.0
• NAG 7.2

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

• Baselibs 7.25.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1
  • GFE 1.16.0
    • gFTL 1.14.0
    • gFTL-shared 1.9.0
    • pFUnit 4.10.0 (optional)
    • fArgParse 1.8.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.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 v3.51.0

We recommend most external users set -DUSE_F2PY=OFF

We also require CMake 3.23 or higher.

From CHANGELOG.md

Added

• Added MAPL_Reverse_Schmidt to reverse the stretched grid for indices computation

Changed

• Propagated the error message from MAPL_HorzIJIndex subroutine
• Updated minimum CMake version to 3.23

Fixed

• Trapped more errors from Extdata's i-server

---

What's Changed

• Auto GitFlow - main → develop by @github-actions in #3083
• IJ indices for stretched grid and bubble up error from MAPL_getHorzIJindex subroutine by @weiyuan-jiang in #2851
• trapped more error from i-server by @weiyuan-jiang in #3067
• Prepare for 2.50.0 Release by @mathomp4 in #3087
• GitFlow: Merge develop into main for 2.50 release by @mathomp4 in #3090

Full Changelog: v2.49.1...v2.50.0

MAPL 2.49.1

This is a patch release of MAPL 2.49. It fixes erroneous asserts that blocked some use cases when creating route handles.

All testing shows it to be zero-diff to 2.49.0

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 and 2021.13 (Note: ifx does not yet work)
• GCC 13.2.0 and 14.2.0
• NAG 7.2

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

• Baselibs 7.25.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1
  • GFE 1.16.0
    • gFTL 1.14.0
    • gFTL-shared 1.9.0
    • pFUnit 4.10.0 (optional)
    • fArgParse 1.8.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.0 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)
  • UDUNITS2 2.28.8 -- NEW DEPENDENCY FOR MAPL 2.48

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

• ESMA_cmake v3.51.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Removed erroneous asserts that blocked some use cases in creating route handles

---

What's Changed

• GitFlow: Merge 2.46.4 hotfix into main by @mathomp4 in #3081

Full Changelog: v2.49.0...v2.49.1

MAPL 2.46.4

This is a patch release of MAPL 2.46. It fixes erroneous asserts that blocked some use cases when creating route handles.

This should be zero-diff to 2.46.3.

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 (Classic 2021.12 seems to work, ifx does not yet work)
• GCC 13.2.0
• NAG 7.2

The libraries this version of MAPL is currently tested with are below. NOTE: Changes here from MAPL 2.44 and earlier, namely GFE

• Baselibs 7.24.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1b04 (8.6.0 is enough for Baselibs builds, but 8.6.1 is required for Spack)
  • GFE 1.15.0
    • gFTL 1.13.0
    • gFTL-shared 1.8.0
    • pFUnit 4.9.0 (optional)
    • fArgParse 1.7.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.0 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)

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

• ESMA_cmake v3.45.1

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Removed erroneous asserts that blocked some use cases in creating route handles

---

Full Changelog: v2.46.3...v2.46.4

MAPL 2.49.0

This is a minor release of MAPL 2.

The main new functionality is support for zstandard compression in MAPL History. Note that this requires zstandard support built into netCDF (and HDF5). At the moment ESMA-Baselibs cannot exercise this as ESMA-Baselibs builds HDF5 and netCDF as static libraries so the zstandard plugin is not available. But spack builds of MAPL can use the new functionality. MAPL does have a test to make sure zstandard support is available and if not, if someone tries to use it, the system will fail out.

We also have bug fixes for macOS and NVHPC in this release.

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 and 2021.13 (Note: ifx does not yet work)
• GCC 13.2.0 and 14.2.0
• NAG 7.2

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

• Baselibs 7.25.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1
  • GFE 1.16.0
    • gFTL 1.14.0
    • gFTL-shared 1.9.0
    • pFUnit 4.10.0 (optional)
    • fArgParse 1.8.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.0 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)
  • UDUNITS2 2.28.8 -- NEW DEPENDENCY FOR MAPL 2.48

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

• ESMA_cmake v3.51.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Added

• Added zstandard compression support
  • Note this requires netCDF-C to have been compiled with zstandard support. We have a CMake test to check for this and enabling zstandard output in History will fail if the library does not support it

Changed

• ExtDataDriver.x now uses ExtData2G by default
• Update components.yaml
  • ecbuild geos/v1.4.0
    • Fixes bug between GCC, macOS, and the -pipe flag

Fixed

• Workaround for NVHPC 24.9 involving use statement in block construct

---

What's Changed

• fixes #3042 by @bena-nasa in #3058
• Update to ecbuild geos/v1.4.0 by @mathomp4 in #3066
• Fixes #1618. Add zstandard support by @mathomp4 in #3056
• Workarounds for NVHPC 24.9 by @mathomp4 in #3068
• GitFlow: Merge develop into main for 2.49 release by @mathomp4 in #3071

Full Changelog: v2.48.0...v2.49.0

MAPL 2.48.0

This is a minor release of MAPL. It has various updates and fixes compared to MAPL 2.47. All testing shows it to be zero-diff to MAPL 2.47.

The complete list of changes is delineated below but some highlights are:

• Support for GCC 14 and Intel 2021.13
• Added Fortran interface to UDUNITS2
  • NOTE: This now means MAPL depends on UDUNITS2 (and transitively, expat)
• Added 5 new ExtData tests to test compression, bit-shaving, and quantization
• Add restart benchmark code restart_simulator.x in benchmark directory
• Start implementing changes for vertical regridding in ExtData
• Made the POSITIVE field attribute defaults to "down" in case it is not found
• Added ability to read the attribute with explicit type "string" of a netcdf variable.
• Add support for preliminary CF Conventions quantization properties

Note the with the last point, we added a new quantization keyword granular_bitround to History. This will be the preferred keyword for quantization in the future replacing GranularBR (which we formally deprecated and will remove in MAPL3).

---

This version of MAPL was tested with:

• Intel Fortran Classic 2021.6.0 and 2021.13 (Note: ifx does not yet work)
• GCC 13.2.0 and 14.2.0
• NAG 7.2

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

• Baselibs 7.25.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.6.1
  • GFE 1.16.0
    • gFTL 1.14.0
    • gFTL-shared 1.9.0
    • pFUnit 4.10.0 (optional)
    • fArgParse 1.8.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.14.0 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)
  • UDUNITS2 2.28.8 -- NEW DEPENDENCY FOR MAPL 2.48

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

• ESMA_cmake v3.51.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Added

• Added 5 new ExtData tests to test compression, bit-shaving, and quantization

Changed

• Rename all single-digit ExtData tests to have a leading zero (i.e., case1 -> case01)
• Add restart benchmark code restart_simulator.x in benchmark directory
• Start implementing changes for vertical regridding in ExtData
• Made the POSITIVE field attribute defaults to "down" in case it is not found
• VLOCATION is not querried in MAPL_VerticalMethods.F90 for rank 2 fields
• Fixed time print in Cap GC (from slashes to colons)
• Added ability to read the attribute with explicit type "string" of a netcdf variable.
• Add ability to connect export of the MAPL hierachy to ExtData via CAP.rc file
• Added new driver, CapDriver.x, to excerise the MAPL_Cap with the configuratable component also used by ExtDataDriver.x
• Added Fortran interface to UDUNITS2
  • NOTE: This now means MAPL depends on UDUNITS2 (and transitively, expat)
• Improve mask sampler by adding an MPI step and a LS_chunk (intermediate step)
• CI Updates
  • Update Baselibs in CI to 7.25.0
  • Update to circleci-tools orb v4
    • This adds the ability to do an ifx test along with the ifort test (though ifx is not yet enabled)
• Update components.yaml
  • ESMA_env v4.30.1
    • Update to Baselibs 7.25.0
      • ESMF 8.6.1
      • GFE v1.16.0
        • gFTL v1.14.0
        • gFTL-shared v1.9.0
        • fArgParse v1.8.0
        • pFUnit v4.10.0
        • yaFyaml v1.4.0
      • curl 8.8.0
      • NCO 5.2.6
      • Other various fixes from the v8 branch
    • Move to use Intel ifort 2021.13 at NCCS SLES15, NAS, and GMAO Desktops
    • Move to use Intel MPI at NCCS SLES15 and GMAO Desktops
    • Move to GEOSpyD Min24.4.4 Python 3.11
    • Fix for csh at NAS
  • ESMA_cmake v3.51.0
    • Update esma_add_fortran_submodules function
    • Move MPI detection out of FindBaselibs
    • Add SMOD to submodule generator
    • NAG OpenMP Workaround
    • Support for Jemalloc and LLVM Flang
• Add support for preliminary CF Conventions quantization properties
  • Add new quantization keyword granular_bitround to History. This will be the preferred keyword for quantization in the future
    replacing GranularBR

Fixed

• Fix profiler PercentageColumn test for GCC 14
• Fix bug in ExtData Tests. CMake was overwriting the EXTDATA2G_SMALL_TESTS LABEL with ESSENTIAL

Deprecated

• Deprecate GranularBR as a quantization method keyword in History. We will prefer granular_bitround in the future to match
  draft CF conventions. This will be removed in MAPL 3.

---

What's Changed

• Improved mask sampler by @metdyn in #2890
• Update to ESMA_cmake v3.48.0 by @mathomp4 in #2905
• Auto GitFlow - main → develop by @github-actions in #2915
• Update CI Baselibs to 7.25.0 by @mathomp4 in #2897
• Add Refactor to PR Template by @mathomp4 in #2932
• Pull UDUNITS fortran interface into develop by @bena-nasa in #2934
• Clarify changelog for udunits dependency, reorder cmake by @mathomp4 in #2936
• Update to ESMA_env v4.30.0 (Baselibs 7.25, Intel 2021.13) by @mathomp4 in #2927
• Update to ESMA_cmake v3.49.0 (SMOD for submodules) by @mathomp4 in #2941
• Fix GCC 14 issue with profiler test by @mathomp4 in #2946
• Fix bug in CMake for ExtData2G Tests by @mathomp4 in #2947
• some prep work for extdata2g vertical regridding development by @bena-nasa in #2949
• Fixes #2926. Update quantization properties by @mathomp4 in #2940
• Clean up CODEOWNERS by @mathomp4 in #2958
• Clean up NAG + OpenMP CMake by @mathomp4 in #2960
• GitFlow: Merge main into develop 2024-Aug-16 by @mathomp4 in #2973
• Fixes #2969 by @bena-nasa in #2975
• VERIFY Statement after MPI call by @JulesKouatchou in #2919
• Add future ability to test ifx in CI by @mathomp4 in #2956
• Feature/bmauer/add extdata imports by @bena-nasa in #2994
• Update to ESMA_cmake v3.51.0 by @mathomp4 in #3005
• Feature/bmauer/containers extdata2g by @bena-nasa in #3007
• Move from stale bot to stale action by @mathomp4 in #2990
• Auto GitFlow - main → develop by @github-actions in #3011
• Update to ESMA_env v4.30.1 by @mathomp4 in #3015
• Update stale action to remove stale label when unstale by @mathomp4 in #3017
• Auto GitFlow - main → develop by @github-actions in #3022
• read explicit "string" type of an attribute of a netcdf variable by @weiyuan-jiang in #3026
• Feature/fixes #3025 by @bena-nasa in #3028
• Fixes #3034. Convert Cap time print to colons by @mathomp4 in #3035
• querring VLOCATION on MAPL_VerticalMethods.F90 for rank 2 fields by @atrayano in #3039
• new restart_simulator.x code by @bena-nasa in #3040
• Add extdata tests to test compression, bit-shaving, and quantization by @mathomp4 in #3047
• Prepare for 2.48.0 Release by @mathomp4 in #3049
• GitFlow: Merge develop into main for 2.48 release by @mathomp4 in #3051

Full Changelog: v2.47.2...v2.48.0