MAPL 2.39.7

This is a patch release of MAPL that fixes an issue so the pFIO MultigroupServer does not allow a file written by multiple processes at the same time.

All testing shows it zero diff to MAPL 2.39.6

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Fix a bug so that MultigroupServer does not allow a file written by multiple processes at the same time.

---

What's Changed

• Fix a bug so that MultigroupServer does not allow a file written by m… by @weiyuan-jiang in #2238

Full Changelog: v2.39.6...v2.39.7

MAPL 2.39.6

This patch release of MAPL 2.39 fixes issues with the tripolar grid and with the time_ave_util.x utility.

All testing shows it zero-diff to MAPL 2.39.5.

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Changed

• Relaxed restriction in the tripolar grid factory so that grids can be made even when the decomposition deos not evenly divide the grid dimension so that the factory can be used in utilities where the core count makes such a condition impossible to satisfiy

Fixed

• Fix a bug in time_ave_util.x so that it can work with files with no vertical coordinate

---

What's Changed

• fixes #2232 by @bena-nasa in #2234
• Fixes for 2.39.6 Release by @mathomp4 in #2239

Full Changelog: v2.39.5...v2.39.6

MAPL 2.39.5

This is a patch release of MAPL has a fix for HISTORY (see #2058). Namely, a user would specify an alias in HISTORY.rc for a variable with a single bin/ungridded dimension and the alias would be ignored. So before this:

'CA.brEXTTAU'    , 'CA.br'     , 'BREXTTAU'    ,

would lead to output of CA.brEXTTAU001 instead of BREXTTAU or BREXTTAU001.

In MAPL 2.39.5, this will now result in a variable called BREXTTAU without the 001. If a user desires that name, they can update the alias in HISTORY.

Beyond that fix, this is zero-diff to MAPL 2.39.4 (all other HISTORY and the state is the same)

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Fixed logic in generating the names of the split fields. If the alias field in the History.rc has separators (;), each substring is used to name the resulting fields. If there are no separators, this will be the exact name of the first split field

---

What's Changed

• Fixes #2038. Cleaned the rules for split field names by @atrayano in #2226

Full Changelog: v2.39.4...v2.39.5

MAPL 2.39.4

This patch release of MAPL 2.39 fixes a climatology bug in ExtData2G (see #2192 for more information).

All testing with GEOSgcm shows this to be zero-diff to v2.39.3

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Added bug fix when using climatology option in ExtData2G under certain scenarios

---

What's Changed

• Fixes #2192. Fix ExtData2G Climatology bug by @mathomp4 in #2207

Full Changelog: v2.39.3...v2.39.4

MAPL 2.39.3

This patch version of MAPL 2.39 fixes a bug when performing vertical regridding in History when the output grid cannot be decomposed so that every core has a DE.

This is zero-diff to v2.39.2 save for cases that encountered the bug.

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Fixed a bug when performing vertical regridding in History when the output grid cannot be decomposed so that every core has a DE

---

What's Changed

• Feature/jkouatch/ford doc v01 by @JulesKouatchou in #2162
• CMake improvements by @scivision in #2075
• fixes #2187 by @bena-nasa in #2188

New Contributors

• @scivision made their first contribution in #2075

Full Changelog: v2.39.2...v2.39.3

MAPL 2.39.2

This patch version of MAPL fixes a bug reported by @AlexanderRichert-NOAA with builds of MAPL that do not build with support for pFlogger. There were unprotected find_package(PFLOGGER REQUIRED) calls that tripped up these styles of builds.

This is zero-diff to v2.39.1

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Fix unintentional PFLOGGER requirements in geom and pfio

---

What's Changed

• Protect required pflogger in CMake by @mathomp4 in #2153

Full Changelog: v2.39.1...v2.39.2

MAPL 2.39.1

This patch release of MAPL 2.39 fixes the handling of ungridded dims for averaged collections. When the grid rank is 2, the code erroneously assigned vertical dimension to the ungridded dims

All testing shows it zero-diff to MAPL 2.39.0 when the bug is not encountered (which is rare)

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Fixed

• Fixed the handling of ungridded dims for averaged collections. When the grid rank is 2, the code erroneously assigned vertical dimension to the ungridded dims

---

What's Changed

• Fixes #2138. Properly accounts for vertical dimension when grid rank is by @atrayano in #2139

Full Changelog: v2.39.0...v2.39.1

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

From CHANGELOG.md

Added

• 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

Fixed

• 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.

---

What's Changed

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

New Contributors

• @patricia-nasa made their first contribution in #2128

Full Changelog: v2.38.1...v2.39.0

MAPL 2.38.1

This is a patch release of MAPL that introduces a new feature needed by some MAPL users. It adds a new runtime option:

RUN_AT_INTERVAL_START:

to force component alarms ring at start of the interval. The default the current behavior still to ring at the end.

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Added

• Added new option "RUN_AT_INTERVAL_START:" so force component alarms ring at start of the interval, default still to ring at the end

---

What's Changed

• Run at start option by @bena-nasa in #2123

Full Changelog: v2.38.0...v2.38.1

MAPL 2.38.0

This is a minor release of MAPL with many new features and fixes.

The new features are:

• Printed time to write files to the disk in MultiGroupServer (enabled via logging.yaml using MAPL.pfio)
• Added merge function to Filemetadata to merge two meta objects
• Added support for "DEPENDS_ON" and "DEPENDS_ON_CHILDREN" for export_specs. The typical usage on this feature is when the calculation of a variable involves other export variables, either from the same component (DEPENDS_ON specifies the list on such variables), or in the children (in this case the expectation is that all of the children have the SAME export). In both cases MAPL performs automatic allocation of these export variables.
• Added support for use of pFlogger simTime in logging (only if -DBUILD_WITH_PFLOGGER=ON)
  • Note: Due to bug in pFlogger v1.9.3 and older, you must specify a dateFmt in your logging configuration file in the
    formatter when using simTime (see pFlogger issue #90). This is fixed in pFlogger v1.10.0
• Add geom subdirectory and contents for MAPL Geom framework

All testing shows it to be zero-diff to MAPL 2.37 in re GEOSgcm.

---

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:

• ESMA_cmake v3.28.0

We recommend most external users set -DUSE_F2PY=OFF

---

From CHANGELOG.md

Added

• Printed time to write files to the disk in MultiGroupServer
• Added merge function to Filemetadata to merge two meta objects
• Added support for "DEPENDS_ON" and "DEPENDS_ON_CHILDREN" for export_specs. The typical usage on this feature is when the calculation of a variable involves other export variables, either from the same component (DEPENDS_ON specifies the list on such variables), or in the children (in this case the expectation is that all of the children have the SAME export). In both cases MAPL performs automatic allocation of these export variables.
• Added support for use of pFlogger simTime in logging (only if -DBUILD_WITH_PFLOGGER=ON)
  • Note: Due to bug in pFlogger v1.9.3 and older, you must specify a dateFmt in your logging configuration file in the
    formatter when using simTime (see pFlogger issue #90).
    This is fixed in pFlogger v1.10.0
• Add geom subdirectory and contents for MAPL Geom framework

Changed

• Add logic to GriddedIO class so that if an uninitialized time object is passed, the resulting file will not depend on time
• Make sure the pfio files are closed when the time and speed appear in logfile
• Enable more tests in CircleCI

Fixed

• Move ioserver_profiler%stop call to the right place
• Caught an untrapped error condition when writing to NetCDF

---

What's Changed

• Auto GitFlow - main → develop by @github-actions in #2053
• Bump mheap/github-action-required-labels from 3 to 4 by @dependabot in #2054
• Add support for pFLogger simTime by @mathomp4 in #2060
• Auto GitFlow - main → develop by @github-actions in #2065
• Auto GitFlow - main → develop by @github-actions in #2077
• Add "geom" framework by @darianboggs in #2070
• Auto GitFlow - main → develop by @github-actions in #2083
• Re-enable many CircleCI tests by @mathomp4 in #2063
• Handmerge main to develop 2023Apr25 by @mathomp4 in #2096
• Auto GitFlow - main → develop by @github-actions in #2098
• Bump CircleCI-Public/trigger-circleci-pipeline-action from 1.0.7 to 1.1.0 by @dependabot in #2085
• Feature/atrayano/depends on by @atrayano in #2100
• Add subroutine to merge Filemetadata by @weiyuan-jiang in #2092
• print files and writing time in MultiGroupServer by @weiyuan-jiang in #2087
• Exchange the order to make sure files are closed by @weiyuan-jiang in #2106
• Fixes #2072 by @bena-nasa in #2073
• trap the nf90_open error by @weiyuan-jiang in #2071
• move the call ioserver_profiler%stop to the right place by @weiyuan-jiang in #2109
• Prepare for MAPL 2.38.0 Release by @mathomp4 in #2111
• GitFlow: Merge Develop into Main for release by @mathomp4 in #2116

Full Changelog: v2.37.3...v2.38.0