MAPL 2.34.2

This release of MAPL fixes a bug in ExtDataDriver.x to re-enable its use of the multigroup oserver.

---

The libraries this version of MAPL is currently tested with are below.

• Baselibs 7.7.0
  • 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.0 (Required)
  • 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)

---

From CHANGELOG.md

Fixed

• Fixed bug with ExtDataDriver.x when enabling oserver on dedicated resources

---

What's Changed

• Reenable use of multi group server in ExtDataDriver.x by @bena-nasa in #1934

Full Changelog: v2.34.1...v2.34.2

MAPL 2.34.1

This patch of MAPL 2.34 fixes an issue (#1923) concerning WRITE_RESTART_BY_OSERVER.

All testing is zero-diff with GEOSgcm save for cases with WRITE_RESTART_BY_OSERVER: YES where it fixes a bug with that code path.

---

The libraries this version of MAPL is currently tested with are below.

• Baselibs 7.7.0
  • 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.0 (Required)
  • 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)

---

From CHANGELOG.md

Fixed

• Fixed bug when writing 4D fields to checkpoint files with the PFIO server via the WRITE_RESTART_BY_OSERVER option

---

What's Changed

• fixes issue #1923 by @bena-nasa in #1925

Full Changelog: v2.34.0...v2.34.1

MAPL 2.34.0

This release of MAPL contains many new features and updates. Among the changes are:

1. Fixed the naming convention of the split field name (#1874). For this, before on split fields in History you'd get out DU, DU002, DU003. But now MAPL will do DU001, DU002, DU003
2. Updates for better support of State Specs in GOCART (see GEOS-ESM/GOCART#202)
   1. Support for * expansion in long names
   2. Support to fill %d in long names
3. Various updates for ongoing OpenMP support with MAPL and Gridded Components
4. Added requirement for ESMF 8.4.0 in CMake
5. Minor changes for stricter Debug builds

NOTE: Updates 1 and 2 above will change History both variable names and metadata. The data will be zero-diff, but comparators will be confused by the name change on split fields as well as different metadata if tested for.

---

The libraries this version of MAPL is currently tested with are below.

• Baselibs 7.7.0
  • 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.0 (Required)
  • 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)

---

From CHANGELOG.md

Added

• Added MAPL_find_bounds => find_bounds and MAPL_Interval => Interval to MAPL.F90 for use when doing component level OpenMP
• Added requirement for ESMF 8.4.0 in find_package() call
• Modified Apps/MAPL_GridCompSpecs_ACG.py to use the * capability for LONG_NAME like SHORT_NAME
• Added CMake code to apply stricter debug flags when building MAPL as Debug
• Added subroutine MAPL_MethodAdd to MAPL_Generic.F90
• Added subroutines get_callbacks and copy_callbacks to OpenMP_Support.F90
  • These added subroutines are to support "callback" procedures when inside OpenMP parallel region for mini states for component level threading.
• Added ability to expand "%d" in the long name when we split fields for History

Changed

• Update components.yaml
  • ESMA_cmake v3.24.0 (defines stricter debug flags for Intel, preliminary support for ifx)
• Reduced amount of CI tests to reduce cost
• Added message to label enforcer (requires v3)
• Fixed the naming convention of the split field name (#1874)
  • NOTE: This could change the name of any field in HISTORY using field splitting. The data will be the same, but the name will be
    different.

Fixed

• Fixed procedure "find" in CFIOCollection.F90 that was missing a _RETURN(_SUCCESS) at the end

---

What's Changed

• Bump actions/checkout from 3.1.0 to 3.2.0 by @dependabot in #1861
• Feature/aoloso/merge v10.23.0 mstrf gwd hybrid by @aoloso in #1859
• Update Label Enforcer and Changelog Enforcer for Dependabot by @mathomp4 in #1862
• Enforce ESMF version by @mathomp4 in #1857
• fixes #1869 by @bena-nasa in #1870
• Auto GitFlow - main → develop by @github-actions in #1872
• Fixes #1874. This fixes the convention for naming the split field nam… by @atrayano in #1875
• Reduce number of CI tests by @mathomp4 in #1879
• Feature/wdboggs/extend star long name by @darianboggs in #1881
• Bump CircleCI-Public/trigger-circleci-pipeline-action from 1.0.5 to 1.0.6 by @dependabot in #1884
• Add stricter debugging flags when building MAPL as Debug by @mathomp4 in #1871
• Bump mheap/github-action-required-labels from 2 to 3 by @dependabot in #1892
• Extend OMP layer to support ESMF callback states by @aoloso in #1889
• Update to ESMA_cmake 3.24, Update Changelog for 2.34 release by @mathomp4 in #1894
• Fixes #1878. The adds ability to expand %d in the long name, when we … by @atrayano in #1899
• Update changelog for 2.34 release by @mathomp4 in #1901
• GitFlow: Merge develop into main for 2.34 release by @mathomp4 in #1898

Full Changelog: v2.33.0...v2.34.0

MAPL 2.33.0

This release of MAPL has a bugfix to allow ExtData2G to run with GNU compilers. Also, has a fix to one of the tutorials.

All testing shows this is zero-diff for GEOSgcm.

---

The libraries this version of MAPL is currently tested with are below.

• Baselibs 7.7.0
  • netcdf-c 4.9.0
  • netcdf-fortran 4.6.0
  • ESMF 8.4.0
  • 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)

---

From CHANGELOG.md

Added

• Added new test case for ExtData2G to test multiple input files

Fixed

• Fixed bug in tutorial case parent_no_children when attempting recommended exercises
• Implemented workaround for gfortran runtime issue with YafYaml when parsing multiple ExtData yaml files for ExtData2G

---

What's Changed

• Fixes #1846 by @bena-nasa in #1849
• Fixes #1847 by @bena-nasa in #1850
• Prepare for 2.33 release by @mathomp4 in #1852
• GitFlow: Merge Develop into Main for 2.33 Release by @mathomp4 in #1854

Full Changelog: v2.32.0...v2.33.0

MAPL 2.32.0

This release of MAPL adds a few new features:

1. Added new option to allow for gaps in datasets ingested by ExtDataNG (see #1789)
2. Added a new fArgParse command line parser. This will eventually replace the use of FLAP in MAPL3, and is now just optional in MAPL2. Requires fArgParse v1.4.1
3. Added subroutines for reading 4d integers in NetCDF4_FileFormatter
4. Updated MAPL to use Baselibs 7.7.0. This has the fArgParse version needed for the parser (see above), as well as has newer netCDF to enable use of the quantize feature.

---

The libraries this version of MAPL is currently tested with are below.

• Baselibs 7.7.0
  • netcdf-c 4.9.0
  • netcdf-fortran 4.6.0
  • ESMF 8.4.0
  • 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)

---

From CHANGELOG.md

Added

• Add fArgParse CLI argument parser
• Added subroutines for reading 4d integers in NetCDF4_FileFormatter
• Added new option to allow for gaps in datasets ingested by ExtDataNG

Changed

• Updated to ESMA_cmake v3.21.0
  • Adds support for a generic x86_64 processor for GNU
• Updated to ESMA_env v4.8.0
  • Baselibs v7.7.0
    • fArgParse v1.4.1
    • pFUnit v4.6.1
• Move to use GitHub Actions for label enforcement

---

What's Changed

• Feature/bmauer/fixes #1789 by @bena-nasa in #1797
• Move to use GitHub Action for Label Enforcement by @mathomp4 in #1840
• add 4d integer reading subroutine to formatter by @weiyuan-jiang in #1838
• Fixes #1756. Add fArgParse CLI parser by @mathomp4 in #1758
• GitFlow: Merge Develop into Main for 2.32.0 Release by @mathomp4 in #1844

Full Changelog: v2.31.0...v2.32.0

MAPL 2.31.0

This release of MAPL has many new features and updates including:

• Fixes for the NVIDIA compiler
• New function to remove variable from FileMetadata object
• Added file name to errors when reading netCDF files
• Added capability to Automatic Code Generator to detect inconsistencies in spec files at build time
• Add support for netCDF quantize.
  • Note this requires netCDF-C v4.9.0 and netCDF-Fortran v4.6.0, but our CMake does have a test
    to make sure the netCDF library was compiled with support. This test uses NETCDF_INCLUDE_DIRS and as such
    within GEOS requires the use of ESMA_cmake v3.20.0 or later to (possibly) succeed.
• Added subroutine to calculate IJ indexes of given lats lons for cubed-sphere grid

---

The libraries this version of MAPL has been tested with are below.

• Baselibs 7.5.0
  • netcdf-c 4.8.1
  • netcdf-fortran 4.5.4
  • ESMF 8.3.0
  • GFE 1.4.0
    • gFTL 1.8.1
    • gFTL-shared 1.5.0
    • pFUnit 4.4.1 (optional)
    • fArgParse 1.3.0 (optional)
    • pFlogger 1.9.1 (if -DBUILD_WITH_PFLOGGER=YES)
    • yaFyaml 1.0.4 (if -DUSE_EXTDATA2G=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES)

In order to use the new netCDF quantize support in MAPL, you need to use the equivalent to Baselibs 7.7.0 (which MAPL and GEOS will soon move to):

• Baselibs 7.7.0
  • netcdf-c 4.9.0
  • netcdf-fortran 4.6.0
  • ESMF 8.4.0
  • GFE 1.8.0
    • gFTL 1.8.1
    • gFTL-shared 1.5.0
    • pFUnit 4.6.1 (optional)
    • fArgParse 1.4.1 (optional)
    • pFlogger 1.9.1 (if -DBUILD_WITH_PFLOGGER=YES)
    • yaFyaml 1.0.4 (if -DUSE_EXTDATA2G=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES)

---

From CHANGELOG.md

Fixed

• Fixed the subroutine that removes a variable from FileMetadata Object
• Defined real64 constants in consistent way
• Workarounds for NVIDIA compiler

Added

• Added a function to remove a variable from FileMetadata object.
• Added assert to NetCDF4_get_var.H to print variable name if data retrieval fails
• Added to asserts in NetCDF4_get_var.H to print out file if there are error getting variables
• Added capability to Automatic Code Generator to detect inconsistencies in spec files at build time
• Add support for netCDF quantize.
  • Note this requires netCDF-C v4.9.0 and netCDF-Fortran v4.6.0, but our CMake does have a test
    to make sure the netCDF library was compiled with support. This test uses NETCDF_INCLUDE_DIRS and as such
    within GEOS requires the use of ESMA_cmake v3.20.0 or later to (possibly) succeed.
• Added subroutine to calculate IJ indexes of given lats lons for cubed-sphere grid

Changed

• Updated to ESMA_cmake v3.20.0
  • This is to support the NETCDF_INCLUDE_DIRS used in the quantize support test
• Updated to ESMA_env v4.7.0
  • This has many updates including moving to netCDF-C v4.9.0 and netCDF-Fortran v4.6.0. The other updates:
    • Baselibs v7.6.0
      • ESMF v8.4.0
      • zlib 1.2.13
      • curl 7.86.0
      • netCDF-C 4.9.0
      • netCDF-Fortran 4.6.0
      • NCO 5.1.1
      • CDO 2.1.0
• Removed some unneeded use statements in ExtDataGridCompNG.F90. This seemed to let this new quantize support build with Intel
• Changed nbits internally to be nbits_to_keep. Note that externally, you still use nbits: in HISTORY.rc

---

What's Changed

• Auto GitFlow - main → develop by @github-actions in #1786
• Bump devops-infra/action-pull-request from 0.5.1 to 0.5.2 by @dependabot in #1790
• Add status check after retrieving variable data from NetCDF file by @lizziel in #1792
• Auto GitFlow - main → develop by @github-actions in #1801
• Auto GitFlow - main → develop by @github-actions in #1804
• Bump devops-infra/action-pull-request from 0.5.2 to 0.5.3 by @dependabot in #1807
• Auto GitFlow - main → develop by @github-actions in #1815
• define real64 constants more consistently by @weiyuan-jiang in #1799
• Fixes #1800. Add file name to NC4 asserts by @mathomp4 in #1813
• Fixes for NVIDIA by @mathomp4 in #1823
• add function to remove a variable from meta data by @weiyuan-jiang in #1825
• Bugfix/wjiang/rm var from meta by @weiyuan-jiang in #1827
• Add capability to check MAPL Spec options (fields) to Automatic Code Generator (ACG) by @darianboggs in #1829
• add subroutine to calculate global IJ index for cubed sphere grid by @weiyuan-jiang in #1782
• Add netCDF quantize support by @mathomp4 in #1810
• GitFlow: Merge develop into main for release by @mathomp4 in #1835

Full Changelog: v2.30.3...v2.31.0

MAPL 2.30.3

This patch release of MAPL 2.30 fixes a bug when writing fields in History with ungridded dimension when the split option is not requested.

This is zero-diff for GEOS except (obviously) when the bug was encountered in History output.

---

The libraries this version of MAPL has been tested with are below.

• Baselibs 7.5.0
  • netcdf-c 4.8.1
  • netcdf-fortran 4.5.4
  • ESMF 8.3.0
  • GFE 1.4.0
    • gFTL 1.8.1
    • gFTL-shared 1.5.0
    • pFUnit 4.4.1 (optional)
    • fArgParse 1.3.0 (optional)
    • pFlogger 1.9.1 (if -DBUILD_WITH_PFLOGGER=YES)
    • yaFyaml 1.0.4 (if -DUSE_EXTDATA2G=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES)

---

From CHANGELOG.md

Fixed

• Fixed bug when writing fields in History with ungridded dimension when the split option is not requested

---

What's Changed

• fixes #1811 bug with output variables with ungridded dims by @bena-nasa in #1814

Full Changelog: v2.30.2...v2.30.3

MAPL 2.30.2

This patch release of MAPL fixes an issue where when a grid is received from outside of MAPL (e.g., NOAA UFS), MAPL must provide a mechanism to specify a grid-type for internal processing. Add an option to set_grid to set GridType explicitly.

---

The libraries this version of MAPL has been tested with are below.

• Baselibs 7.5.0
  • netcdf-c 4.8.1
  • netcdf-fortran 4.5.4
  • ESMF 8.3.0
  • GFE 1.4.0
    • gFTL 1.8.1
    • gFTL-shared 1.5.0
    • pFUnit 4.4.1 (optional)
    • fArgParse 1.3.0 (optional)
    • pFlogger 1.9.1 (if -DBUILD_WITH_PFLOGGER=YES)
    • yaFyaml 1.0.4 (if -DUSE_EXTDATA2G=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES)

---

From CHANGELOG.md

Fixed

• When a grid is received from outside of MAPL (e.g., NOAA UFS), MAPL must provide a mechanism to specify a grid-type for internal processing. Add an option to set_grid to set GridType explicitly.

---

What's Changed

• Add option to set_grid to set GridType explicitly. by @darianboggs in #1794
• Prepare for 2.30.2 release by @mathomp4 in #1802

Full Changelog: v2.30.1...v2.30.2

MAPL 2.30.1

This patch release of MAPL has a fix for building time_ave_util.x at NAS with MPT+GNU.

---

The libraries this version of MAPL has been tested with are below.

• Baselibs 7.5.0
  • netcdf-c 4.8.1
  • netcdf-fortran 4.5.4
  • ESMF 8.3.0
  • GFE 1.4.0
    • gFTL 1.8.1
    • gFTL-shared 1.5.0
    • pFUnit 4.4.1 (optional)
    • fArgParse 1.3.0 (optional)
    • pFlogger 1.9.1 (if -DBUILD_WITH_PFLOGGER=YES)
    • yaFyaml 1.0.4 (if -DUSE_EXTDATA2G=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES)

---

From CHANGELOG.md

Fixed

• Fix for building time_ave_util.x at NAS using MPT

---

What's Changed

• Fixes #1784. Fix build issue at NAS by @mathomp4 in #1785

Full Changelog: v2.30.0...v2.30.1

MAPL 2.30.0

This release of MAPL adds a new utility, time_ave_util.x that is a refactoring of the current time_ave.x currently built as part of GMAO_Shared. The previous utility only worked on Lat-Lon grids, but the new one works with Lat-Lon, Cubed-Sphere, and Tripolar grids and supports regridding to a different grid if the user desires that the averaging be performed and output on a different grid than the datasets grid.

---

The libraries this version of MAPL has been tested with are below.

• Baselibs 7.5.0
  • netcdf-c 4.8.1
  • netcdf-fortran 4.5.4
  • ESMF 8.3.0
  • GFE 1.4.0
    • gFTL 1.8.1
    • gFTL-shared 1.5.0
    • pFUnit 4.4.1 (optional)
    • fArgParse 1.3.0 (optional)
    • pFlogger 1.9.1 (if -DBUILD_WITH_PFLOGGER=YES)
    • yaFyaml 1.0.4 (if -DUSE_EXTDATA2G=YES)
    • FLAP geos/v1.10.0 (if -DBUILD_WITH_FLAP=YES)

---

From CHANGELOG.md

Added

• Introduced a new time averaging utility code to perform time averages of datasets

Changed

• Moved Regrid_Util.F90 to the Apps directory

---

What's Changed

• New Time Averaging Util by @bena-nasa in #1776
• GitFlow: Merge Develop into Main for 2.30.0 Release by @mathomp4 in #1778

Full Changelog: v2.29.0...v2.30.0