GEOS-ESM/MAPL: MAPL 2.39.0

This is a minor release of MAPL with new features and fixes. The new features are:

• Added minimal support for NetCDF "groups".
• New feature to allow for single component testing as code is refactored
• Added module to process datetime strings from NetCDF to ESMF_Time and ESMF_TimeInterval variables and vice versa

Most of these features are for internal development at the moment.

Also some fixes were made:

• READ_RESTART_BY_FACE has been fixed and now can read restarts from full CS grids as well as restarts that have been separated by face via WRITE_RESTART_BY_FACE. The current implementation requires that both num_readers and num_writers must be multiple of 6.
• 'config.py' has been fixed. python3 requires // for integer divides.

All testing with GEOSgcm shows this to be zero-diff to MAPL 2.38

The libraries this version of MAPL is currently tested with are below. (No change since last release of MAPL)

• Baselibs 7.8.1
  • netcdf-c 4.9.0 (Needed for quantize support, but not required for all of MAPL)
  • netcdf-fortran 4.6.0 (Needed for quantize support, but not required for all of MAPL)
  • ESMF 8.4.1 (ESMF 8.4.0 required, but 8.4.1 recommended as it has a bug fix)
  • GFE 1.8.0
    • gFTL 1.8.1
    • gFTL-shared 1.5.0
    • pFUnit 4.6.1 (optional)
    • fArgParse 1.4.1 (if -DBUILD_WITH_FARGPARSE=YES, default=YES)
    • pFlogger 1.9.1 (if -DBUILD_WITH_PFLOGGER=YES, default=YES)
    • yaFyaml 1.0.4 (if -DUSE_EXTDATA2G=YES, default=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES, default=YES)

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

• Added minimal support for NetCDF "groups". getvar* can now optionally specify a group_name and the data will be returned from the named group rather than the default group.

• New feature to allow for single component testing as code is refactored

  • Created Comp_Testing_Driver.F90 in Apps
  • Created subset_fields.py to grab a subset of columns
  • Created shell script to perform subsetting, run the driver, and evaluate differences
  • Instructions for use can be viewed under Apps/Comp_Testing_Info.md
• Added module to process datetime strings from NetCDF to ESMF_Time and ESMF_TimeInterval variables and vice versa

• READ_RESTART_BY_FACE has been fixed and now can read restarts from full CS grids as well as restarts that have been separated by face via WRITE_RESTART_BY_FACE. The current implementation requires that both num_readers and num_writers must be multiple of 6.
• 'config.py' has been fixed. python3 requires // for integer divides.

• Process NetCDF datetimes to ESMF_Time and ESMF_TimeInterval and vice versa by @darianboggs in https://github.com/GEOS-ESM/MAPL/pull/2121
• fix the option READ_RESTART_BY_FACE by @weiyuan-jiang in https://github.com/GEOS-ESM/MAPL/pull/2119
• Component Testing Framework by @nataliepatten in https://github.com/GEOS-ESM/MAPL/pull/2059
• Auto GitFlow - main → develop by @github-actions in https://github.com/GEOS-ESM/MAPL/pull/2124
• fix integer divides in config.py by @patricia-nasa in https://github.com/GEOS-ESM/MAPL/pull/2128
• Fixes #2126 - minimal support for netcdf groups by @tclune in https://github.com/GEOS-ESM/MAPL/pull/2129
• Prepare for 2.39.0 Release by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2132
• GitFlow: Merge develop into main for 2.39 release by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2135

• @patricia-nasa made their first contribution in https://github.com/GEOS-ESM/MAPL/pull/2128

Full Changelog: https://github.com/GEOS-ESM/MAPL/compare/v2.38.1...v2.39.0