New 4DIAU Methodology

Zero-diff to previous release: YES (but user must setup experiment differently)

Restart Changes: NO

1. Hotfixed a bug to enable regridding of catchement restarts from MERRA2

2. REPLAY updates:

   The REPLAY algorithm within the GEOSagcm has been modified to enable a 4DIAU methodology consistent with that used in DAS mode. Prior to this release, REPLAY could only incorporate one analysis increment within the CORRECTOR_DURATION window (nominally 6-hours). The 4DIAU update allows for multiple analysis increments to be used within the CORRECTOR window. The number of increments that wiil be used is determined by the settings of the REPLAY_FILE_FREQUENCY (in nnnnnn seconds format) and the REPLAY_FILE_REFERENCE_TIME (in HHMMSS format). Based on these two settings, the code will determine how many analysis increments will properly fit within the CORRECTOR window. Note: the previous setting of PREDICTOR_DURATION is no longer needed since the code computes the required length automatically.

   The updated algorthm allows for 2 types of REPLAY:

   1. Exact (Uses Archived Increment Files)

      Exact REPLAYs identically reproduce (bit-for-bit) a previous GEOS DAS experiment by simply using the archived IAU forcing from the DAS experiment. For these cases, only the CORRECTOR step is employed and is, therefore, as efficient as a stand-alone model run.

   2. Regular (Uses Archived Analysis/Assimilation Files)

      Regular REPLAYs are used to mimic the original IAU methodology, i.e., both the PREDICTOR and the CORRECTOR steps are employed. The key difference being that the Analysis is based on archived datasets. These Analyses may be from the GEOS DAS system, or from any other source that is written using the appropriate GEOS DAS ana.eta data format.

   For more detailed information, please see the comments within the AGCM.rc.tmpl file.

0-diff Updates Running the Default Jason-3_2 Configuration

Zero-diff to previous release: YES (with defaults and without regridding)

Restart Changes: YES (land regridding)

• Non-zero-diff updates for:
  1. Regridding land restarts
  2. Running Chou-Suarez longwave radiation.

1. Update FV3 to latest version v1.0.9 which fixed UH25 diagnostic to build in both R4 and R8.
2. Land Updates:
   1. Clarified LONG_NAME of "snow depth" variable.
   2. Added wemin wemout options.
   3. Add PEATMAP data processing (disabled by default).
   4. GEOSsurface_GridComp changed values of pi to MAPL_PI.
   5. Added 8 more climatological (fPAR, VISDF, NIRDF stats for CATCHCN) data files and new clsm/country_and _state_code.data file.
   6. Extra column on soil_param.* files.
3. Non-zero-diif bug fix in Chou-Suarez for erroneous cloud contamination in OLR-OLRNA (aerosol forcing).
4. Fixed MAPL bug with vector regridding of winds in CTM.
5. Workaround fix building FMS on macOS.

** Due to issues do not use v10.4.0

Zero-diff Updates to Jason-3_2 Default Configuration

Changelog

1. Compute decomposition in MKIAU GridComp.

2. Use esma_set_this in GridComps.

3. Allows GEOS-Chem (v12.4.0) chemistry to be setup and run "out of the box".

4. INTERNAL and IMPORT restarts for GEOS-Chem are now in AGCM.rc.tmpl.

5. GEOS-Chem timestep is set to be 2 x HEARTBEAT by default.

6. Enforces GOCART_DT==HEARTBEAT_DT so all species work correctly.

7. Bug fix for comments using GNU compilers with Ninja.

Zero-diff Updates to Default Jason-3_2 Config

Changelog

1. Enable reading netCDF increments during EXACT replay.

2. Fixed issues affecting the MOIST aerosol diagnostics: 1) incorrect mapping of tracer names to diagnostics and 2) sign of the diagnostics by not allowing negative values.

3. New approach for increment diagnostics discussed in GEOSchem_GridComp v1.0.3.

4. OXIT and OXIM replaced with MTRI%PCHEM::OXIM and TRI%PCHEM::OXIT in most HISTORY files. OX increments due to moist and turblence are now computed using BundleIncrementMod.F90 and their names have been changed.

5. Implemented increments to land surface variables in the ADAS.

6. Fixed GUST for AMIP vs no-inc REPLAY difference in HISTORY.

7. Removed shallow.F90 which is no longer used.

8. Updated gcm_regress.j to be able to test both agcm and coupled models.

9. Remove references to gcm_stats.j in setup.

Restart Changes: None.

Zero-diff Updates to Jason-3_2

Changelog

1. Fields out of the MTR bundle came in the "wrong" order and affected the Henry's law constants. Hotfix to fetch field by name instead of by index.

2. Fixed triangular pdf option in SHUW.

3. Update chemistry to v1.0.2 to run GMI and Stratchem. Updated the StratChem and GMIchem setup scripts to better match gcm_setup.

4. Hotfix in fv_tracer2d.F90 to compare to ksplt instead of nsplt.

5. FVdycoreCubed_GridComp moved to separate repository.

6. FMS moved to separate repository.

7. getco2.F90 moved to @GMAO_Shared.

8. Adapted GuestOcean_GridComp to select DATASEA, MOM5 or MOM6 at runtime.

9. Changes to enable LDAS to start using the develop branch:

   • ensemble ID width for LDAS
   • added co2 file for CatchCN support
   • bug fix that only affects New Land when snow impurity model is active

10. Updates from S2S-3 CVS tag:

    • includes dual ocean code
    • update to precip correction and additional coupled diagnostics

11. MERRA2_EMISSIONS_DIRECTORY path bugfix for gcm_run.j and regress.j

12. Updates from CVS GEOSadas-5_25_2 tag.

13. Updated plots.

14. Enhancements to scm_setup script.

Restart Changes: None.

Zero-diff update to 10.3.2

1. Move to GMAO_Shared 1.0.4 to merge more updates from CVS for plots
2. Updates for Travis CI

Release Equivalent to Jason-3_2

With this release, version 10.3.2 is equivalent to the CVS Jason-3_2 tag.

Note: For CVS to semantic versioning translation purposes Jason-X_Y is translated as v10.X.Y where Jason=J is given the number 10 based on it being the tenth letter.

---

Changelog

Per the @GEOSgcm_App/ChangeLog:

This is non-zero-diff to Jason-3_1.

1. Changes in FV3 related to Horizontal Advection choices. (from Bill: JU_20190722_WMP)
2. Changes in FV3 dddmp (from 0.1 to 0.2, to improve stability)
3. Changes in MOIST related to ICE-FALL. (from Bill: JU_20190722_WMP)
4. Updates to GEOS_OpenWaterGridComp.F90 and GEOS_DataSeaGridComp.F90 to modify the original Coupled/Merged System to include Santha's reformulated ice/melt. (from Santha: sakella-GEOSadas-5_25_0_DV_in_MIZ_SSTunderIceFix)
5. Many updates related to CMAKE for upcoming GIT repository.
6. The addition of ERA5 to QUICKPLOT.
7. Modified STATS for NPO, SPO, and XPO regions. Modified Montage plots.

Restart Changes: None.

Release Equivalent to Jason-3_1

With this release, version 10.3.1 is equivalent to the CVS Jason-3_1 tag.

Note: For CVS to semantic versioning translation purposes Jason-X_Y is translated as v10.X.Y where Jason=J is given the number 10 based on it being the tenth letter.

---

Changelog

Per the @GEOSgcm_App/ChangeLog:

This is non-zero-diff to Jason-3_0

1. Updates to GuestOcean_GridComp.F90 to re-sync OCEAN clock with ATMOS clock
   when running Regular REPLAY together with DataOcean. (non-zero diff)
2. Introduced code in MAPL_CFIO for HISTORY which corresponds to the "fix_undef" utility used in MERRA-2 post-processing. This creates consistency between horizontally transformed and vertically interpolated quantities and the target output level (i.e., values below surface are UNDEF).
3. MKIAU has been modified to allow for REPLAYing to different vertical resolution. Results are zero-diff to previous versions if vertical resolution is the same.
4. Updates to mk_restarts for Land/Catch. Zero-diff when regrid.pl points to standard (old-land) Icarus/Jason boundary area.

Restart Changes: None.

Release 10.3.0 equivalent to Jason-3_0

With this release, version 10.3.0 is equivalent to the CVS Jason-3_0 tag.

Note: For CVS to semantic versioning translation purposes Jason-X_Y is translated as v10.X.Y where Jason=J is given the number 10 based on it being the tenth letter.

---

Changelog

Per the @GEOSgcm_App/ChangeLog:

1. Zero-Diff update to FV3 dynamics to allow FV3+ADV option
2. Updates from Mike Manyin to his tag: Jason-2_2_MEM_2
3. This tag primarily is a Merge between Jason-2_2 and Andrea Molod's coupled tag. This produces a non-zero diff to Jason-2_2 due to a modified surface layer interface.

Restart Changes: None. However, due to changes in import states and diagnostics, these restarts have changed but are passive to the prognostic restarts:

• irrad_internal_rst
• surf_import_rst
• tr_internal_rst
• turb_import_rst

Initial Git Release

This is the initial release of GEOSgcm with code equivalent to the CVS tag GEOSadas-5_25_0. This is roughly equivalent to the CVS tag Jason-3_0 save for a script in @GEOSgcm_App.

Testing by @mathomp4 (1 day run at C24) and @lltakacs (EMIP run) show zero-diff to Jason-3_0.

Note: For CVS to semantic versioning translation purposes Jason-X_Y is translated as v10.X.Y where Jason=J is given the number 10 based on it being the tenth letter.