MAPL 2.48.0

[mathomp4]

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

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

---

This discussion was created from the release MAPL 2.48.0.