MAPL 2.57.0

[mathomp4]

This version of MAPL has many new features including:

• Added a new EASE Grid Factory (based on code previously in GEOSgcm_GridComp)
• Added new option to History, if you specify xlevels instead of levels, it will perform extrapolation below the surface, using ECMWF formulas for height and temperature, otherwise use lowest model level
• Added _USERRC macro for use with ESMF commands that return both rc and userrc
• Added new option for raw_bw.x to use netcdf rather than binary
• Various updates for the trajectory samplers

NOTE: There is one change that can affect some diagnostic prints made by MAPL. The per-step diagnostic print was changed from being hardcoded as AGCM Date to now trigger off of the ROOT_NAME in CAP.rc. So, if ROOT_NAME is GEOSldas, the print will be GEOSldas Date instead of AGCM Date.

---

This version of MAPL was tested with:

• Intel Fortran Classic (ifort) 2021.6.0 and 2021.13
• Intel Fortran (ifx) 2025.0
• 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.33.0
  • netcdf-c 4.9.2
  • netcdf-fortran 4.6.1
  • ESMF 8.8.1 (Note: MAPL only requires 8.6.1 at the moment)
  • GFE 1.16.0
    • gFTL 1.15.2
    • gFTL-shared 1.10.0
    • pFUnit 4.11.1 (optional)
    • fArgParse 1.9.0 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.16.1 (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.62.1

We recommend most external users set -DUSE_F2PY=OFF

We also require CMake 3.24 or higher.

---

From CHANGELOG.md

Fixed

• StateFilterItem => MAPL_StateFilterItem in ACG
• Fix binary writes and reads in benchmark simulators
• Removed _HERE macros left in ExtDataGridCompNG.F90 from debugging

Added

• Added functions to read and write 0d string to nc4 file.
• Added EASE grid Factory so the regridder can use it easily
  • NOTE: The public EASE routines moved to MAPL have been prefixed with MAPL_. This allows older versions of GEOSgcm_GridComp to use MAPL 2.57+ but have the old routines
• Added new option to History, if you specify xlevels instead of levels, it will perform extrapolation below the surface, using ECMWF formulas for height and temperature, otherwise use lowest model level
• Added _USERRC macro for use with ESMF commands that return both rc and userrc
• Added new option for raw_bw.x to use netcdf rather than binary
• Swapped order of output dimensions for trajectory and mask samplers. Now the leading dimension (Fortran convention) is level.

Changed

• Changed per-step diagnostic print from being hardcoded as AGCM Date to now trigger off of the ROOT_NAME in CAP.rc. So, if ROOT_NAME is GEOSldas, the print will be GEOSldas Date instead of AGCM Date.
• Update the MAPL_EQsat code to the ramping version from CVS
• Add schema.version: 1 to enable trajectory sampler using a single GRID_LABEL item
• index_var_names keyword is introduced to simpify the specifications for IODA files
• delete obsfile_end_time in trajectory sampler
• change geoval_fields to fields in obs_platform
• change sampler_spec to sampler_type

---

What's Changed

• StateFilterItem => MAPL_StateFilterItem in ACG by @darianboggs in StateFilterItem => MAPL_StateFilterItem in ACG #3757
• Add _USERRC macro from MAPL3, update readmes by @mathomp4 in Add _USERRC macro from MAPL3, update readmes #3759
• Merge develop into main to get readmes onto main by @mathomp4 in Merge develop into main to get readmes onto main #3766
• Feature/bmauer/below surf extrapolation ecmwf by @bena-nasa in Feature/bmauer/below surf extrapolation ecmwf #3764
• fixes Height extrapolation seems to be working now? #3769 by @bena-nasa in fixes #3769 #3770
• Fixes Bug in surface extrapolation for vectors in last PRs #3778 by @bena-nasa in Fixes #3778 #3779
• Fix up Spack CI by @mathomp4 in Fix up Spack CI #3790
• Introduce schema.version option for trajectory sampler by @metdyn in Introduce schema.version option for trajectory sampler #3594
• Fix binary writes/reads in simulators by @mathomp4 in Fix binary writes/reads in simulators #3795
• Add write_LZ_first option to sampler code by @metdyn in Add write_LZ_first option to sampler code #3794
• Update MAPL_EQsat to ramping version by @mathomp4 in Update MAPL_EQsat to ramping version #3748
• fixes _HERE statements left in ExtData by accident #3802 by @bena-nasa in fixes #3802 #3803
• Auto GitFlow - main → develop by @github-actions in Auto GitFlow - main → develop #3809
• Add EASE grid by @weiyuan-jiang in Add EASE grid #3698
• Fix Ford readme by @mathomp4 in Fix Ford readme #3811
• Generalize per-step profiling print by @mathomp4 in Generalize per-step profiling print #3788
• Feature/bmauer/raw netcdf for hoot by @bena-nasa in Feature/bmauer/raw netcdf for hoot #3808
• Feature/wjiang/add 0d string nc by @weiyuan-jiang in Feature/wjiang/add 0d string nc #3785
• Convert system() call for NAG by @mathomp4 in Convert system() call for NAG #3818
• Prefix public EASE routines with MAPL_ by @mathomp4 in Prefix public EASE routines with MAPL_ #3824
• Merge develop into main for 2.57 Release by @mathomp4 in Merge develop into main for 2.57 Release #3826

Full Changelog: v2.56.1...v2.57.0

---

This discussion was created from the release MAPL 2.57.0.