Skip to content

MAPL 2.57.0

Choose a tag to compare

@mathomp4 mathomp4 released this 18 Jun 15:51
· 223 commits to main since this release
0dd4521

DOI

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

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