GEOS-ESM/MAPL: MAPL 2.43.0

This is a minor release of MAPL. It has various updates and fixes as delineated below. Some highlights are:

• Updates for ongoing work with trajectory and station sampling
• Examples on how to use the Automatic Code Generator
• Fixes for use of the MAPL Python code with Python 3
• Fixes for GCC 13 which is still NOT SUPPORTED but this allows for further testing
• Fix to allow ExtData2G to be built as static library

MAPL is currently tested with:

• Intel Fortran Classic 2021.6.0 (Classic 2021.10.0 seems to work, ifx does not yet work)
• GCC 12.3.0 (13 not supported)
• NAG 7.1

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.5.0 (required)
  • 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 should use:

• ESMA_cmake v3.34.0

We recommend most external users set -DUSE_F2PY=OFF

From CHANGELOG.md

Added

• Station sampler: add support to Global Historical Climatology Network Daily (GHCN-D)
• Add to trajectory sampler DEFINE_OBS_PLATFORM for reading multiple IODA files. To do this, we add union_platform function for observation.
• New directory (docs/tutorial/grid_comps/automatic_code_generator) containing an example showing how to automatically generate the source code using the MAPL_GridCompSpecs_ACG.py tool.
• Added/modified a few _ASSERT calls in ExtData, to better explain what is wrong in .yaml file

Changed

• Change the verification of the grid in MAPL_GetGlobalHorzIJIndex to avoid collective call
• Swath grid step 1: allow for destroying and regenerating swath grid and regenerating regridder route handle, and creating allocatable metadata in griddedIO. Modifications are made to GriddedIO.F90, MAPL_AbstractRegridder.F90, and MAPL_EsmfRegridder.F90.
• Swath grid step 2: add control keywords for swath grid. Allow for filename template with DOY. Allow for missing obs files. User needs to specify index_name_lon/lat, var_name_lon/lat/time, tunit, obs_file_begin/end/interval, Epoch and Epoch_init.
• Update CI to Baselibs 7.17.0 (for future MAPL3 work) and the BCs v11.3.0 (to fix coupled run)
• Update components.yaml
  • ESMA_env v4.24.0 (Baselibs 7.17.0)
• Update CI to use circleci-tools v2
• Changed the Python MAPL __init__.py file to restore behavior from pre-Python3 transition where we did from foo import *. Also fix up other Python2 code to Python3.

Fixed

• Fixed bug broken multi-step file output in History under certain template conditions
• [#2433] Implemented workarounds for gfortran-13
• Missing TARGET in GriddedIO - exposed runtime error when using NAG + debug.
• Allow ExtData2G to be built as SHARED or STATIC

What's Changed

• Automatic Code Generator Sample Code (0 diff) by @JulesKouatchou in https://github.com/GEOS-ESM/MAPL/pull/2420
• avoid collective call inside subroutine MAPL_GetGlobalHorzIJIndex by @weiyuan-jiang in https://github.com/GEOS-ESM/MAPL/pull/2436
• Auto GitFlow - main → develop by @github-actions in https://github.com/GEOS-ESM/MAPL/pull/2442
• Fixes #2433 Minor changes for gfortran-13. by @tclune in https://github.com/GEOS-ESM/MAPL/pull/2443
• Auto GitFlow - main → develop by @github-actions in https://github.com/GEOS-ESM/MAPL/pull/2449
• Update CI and components to match latest GEOSgcm by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2459
• Swath grid for MAPL_HistoryGridComp by @metdyn in https://github.com/GEOS-ESM/MAPL/pull/2458
• Auto GitFlow - main → develop by @github-actions in https://github.com/GEOS-ESM/MAPL/pull/2461
• Auto GitFlow - main → develop by @github-actions in https://github.com/GEOS-ESM/MAPL/pull/2472
• Update to circleci-tools v2 orb; ESMA_env v4.24 by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2466
• Auto GitFlow - main → develop by @github-actions in https://github.com/GEOS-ESM/MAPL/pull/2480
• Auto GitFlow - main → develop by @github-actions in https://github.com/GEOS-ESM/MAPL/pull/2488
• fixes #2487 by @bena-nasa in https://github.com/GEOS-ESM/MAPL/pull/2490
• Bump actions/upload-artifact from 3 to 4 by @dependabot in https://github.com/GEOS-ESM/MAPL/pull/2493
• Fixes #2499: Allow ExtData2G to be built static by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2500
• Print helpful information for certain ExtData problems. by @mmanyin in https://github.com/GEOS-ESM/MAPL/pull/2452
• Add type obs_platform to Trajectory Sampler by @metdyn in https://github.com/GEOS-ESM/MAPL/pull/2465
• Station sampler: add support to Global Historical Climatology Network Daily (GHCN-D) by @metdyn in https://github.com/GEOS-ESM/MAPL/pull/2477
• Restore MAPL Python2 import behavior by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2496
• Prepare for MAPL 2.43.0 release by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2503
• GitFlow: Merge develop into main for release by @mathomp4 in https://github.com/GEOS-ESM/MAPL/pull/2504

New Contributors

• @mmanyin made their first contribution in https://github.com/GEOS-ESM/MAPL/pull/2452

Full Changelog: https://github.com/GEOS-ESM/MAPL/compare/v2.42.4...v2.43.0