Merge tag 'ctsm5.3.020' into standardize-time-metadata

Merge b4b-dev

slevis resolved conflicts:
.gitmodules
doc/ChangeLog
doc/ChangeSum

.gitmodules

@@ -36,15 +36,15 @@ fxDONOTUSEurl = https://github.com/NCAR/fates-release
 [submodule "cism"]
 path = components/cism
 url = https://github.com/ESCOMP/CISM-wrapper
-fxtag = cismwrap_2_2_002
+fxtag = cismwrap_2_2_005
 fxrequired = ToplevelRequired
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESCOMP/CISM-wrapper
 
 [submodule "rtm"]
 path = components/rtm
 url = https://github.com/ESCOMP/RTM
-fxtag = rtm1_0_85
+fxtag = rtm1_0_86
 fxrequired = ToplevelRequired
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESCOMP/RTM
@@ -60,31 +60,31 @@ fxDONOTUSEurl = https://github.com/ESCOMP/MOSART
 [submodule "mizuRoute"]
 path = components/mizuRoute
 url = https://github.com/ESCOMP/mizuRoute
-fxtag = cesm-coupling.n02_v2.1.3
+fxtag = cesm-coupling.n03_v2.2.0
 fxrequired = ToplevelRequired
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESCOMP/mizuRoute
 
 [submodule "ccs_config"]
 path = ccs_config
 url = https://github.com/ESMCI/ccs_config_cesm.git
-fxtag = ccs_config_cesm1.0.10
+fxtag = ccs_config_cesm1.0.16
 fxrequired = ToplevelRequired
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESMCI/ccs_config_cesm.git
 
 [submodule "cime"]
 path = cime
 url = https://github.com/ESMCI/cime
-fxtag = cime6.1.49
+fxtag = cime6.1.59
 fxrequired = ToplevelRequired
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESMCI/cime
 
 [submodule "cmeps"]
 path = components/cmeps
 url = https://github.com/ESCOMP/CMEPS.git
-fxtag = cmeps1.0.32
+fxtag = cmeps1.0.33
 fxrequired = ToplevelRequired
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESCOMP/CMEPS.git
@@ -100,7 +100,7 @@ fxDONOTUSEurl = https://github.com/ESCOMP/CDEPS.git
 [submodule "share"]
 path = share
 url = https://github.com/ESCOMP/CESM_share
-fxtag = share1.1.6
+fxtag = share1.1.7
 fxrequired = ToplevelRequired
 # Standard Fork to compare to with "git fleximod test" to ensure personal forks aren't committed
 fxDONOTUSEurl = https://github.com/ESCOMP/CESM_share

WhatsNewInCTSM5.3.md

@@ -1,53 +1,48 @@
-Purpose and description of changes since ctsm5.2.005
-----------------------------------------------------
+# What's new in CTSM 5.3 (tag `ctsm5.3.0`)
 
-Bring in updates needed for the CESM3.0 science capability/functionality "chill". Most importantly bringing
-in: CN Matrix to speed up spinup for the BGC model, updated surface datasets, updated Leung 2023 dust emissions,
-explicit Air Conditioning for the Urban model, updates to crop calendars. For clm6_0 physics these options are now
-default turned on in addition to Sturm snow, and excess ice.
+## Purpose and description of changes since CTSM 5.2 (tag `ctsm5.2.005`)
+- Adds CN Matrix method to speed up spinup for the BGC model.
+- Updates surface datasets.
+- Brings in new Leung 2023 dust emissions.
+- Adds explicit air conditioning for the urban model.
+- Updates crop calendars.
+- Updates fire model with various improvements, including default parameterization against climate reanalysis from CRU-JRA instead of GSWP.
+- FATES compsets can now be run with transient land use.
 
-Changes to CTSM Infrastructure:
-===============================
+These changes were needed ahead of the CESM3 capability/functionality "chill". For `clm6_0` physics these options are now turned on by default, in addition to Sturm snow and excess ice.
 
- - manage_externals removed and replaced by git-fleximod
- - Ability to handle CAM7 in LND_TUNING_MODE
+## Changes to CTSM infrastructure
+ - `manage_externals` removed and replaced by `git-fleximod`
+ - Ability to handle CAM7 in `LND_TUNING_MODE`
 
-Changes to CTSM Answers:
-========================
+## Changes to CTSM answers
 
- Changes to defaults for clm6_0 physics:
+ Changes to defaults for `clm6_0` physics:
   - Urban explicit A/C turned on
-  - Snow thermal conductivity is now Sturm_1997
-  - New IC file for f09 1850
+  - Snow thermal conductivity method is now `Sturm_1997`
+  - New initial conditions file for f09 ("1-degree") 1850, with more in progress
   - New crop calendars
-  - Dust emissions is now Leung_2023
+  - Dust emissions method is now `Leung_2023`
   - Excess ice is turned on
-  - Updates to MEGAN for BVOC's
+  - Updates to MEGAN for BVOCs
   - Updates to BGC fire method
 
  Changes for all physics versions:
-
   - Parameter files updated
   - FATES parameter file updated
   - Glacier region 1 is now undefined
-  - Update in FATES transient Land use
+  - Update in FATES transient land use
   - Pass active glacier (CISM) runoff directly to river model (MOSART)
-  - Add the option for using matrix for Carbon/Nitrogen BGC spinup
+  - Add the option for using Matrix CN method for Carbon/Nitrogen BGC spinup
 
-New surface datasets:
-=====================
+## New surface datasets
 
-- With new surface datasets the following GLC fields have region "1" set to UNSET:
-     glacier_region_behavior, glacier_region_melt_behavior, glacier_region_ice_runoff_behavior
+- With new surface datasets the following GLC fields have region "1" set to UNSET: glacier_region_behavior, glacier_region_melt_behavior, glacier_region_ice_runoff_behavior
 - Updates to allow creating transient landuse timeseries files going back to 1700.
-- Fix an important bug on soil fields that was there since ctsm5.2.0. This results in mksurfdata_esmf now giving identical answers with a change in number of processors, as it should.
-- Add in creation of ne0np4.POLARCAP.ne30x4 surface datasets.
-- Add version to the surface datasets.
-- Remove the --hires_pft option from mksurfdata_esmf as we don't have the datasets for it.
-- Remove VIC fields from surface datasets.
-
-New input datasets to mksurfdata_esmf:
-======================================
-
-- Updates in PFT/LAI/soil-color raw datasets (now from the TRENDY2024 timeseries that ends in 2023), as well as two fire datasets (AG fire, peatland), and the glacier behavior dataset.
+- Fix an important bug on soil fields that was there since `ctsm5.2.0`. This has the side effect of `mksurfdata_esmf` now giving identical answers with a change in number of processors, as it should.
+- Surface datasets now provided for the `ne0np4.POLARCAP.ne30x4` grid.
+- Surface datasets now have their version number embedded to prevent mismatch of surface dataset and CTSM version.
+- Remove the `--hires_pft` option from `mksurfdata_esmf` as we don't have the datasets for it.
+- Remove `VIC` fields from surface datasets.
+- Updates to input datasets in PFT/LAI/soil-color raw datasets (now from the TRENDY2024 timeseries that ends in 2023), as well as two fire datasets (crop fire peak month, peatland fraction), and the glacier behavior dataset.