Draft ChangeLog/ChangeSum

Author: slevis-lmwg

doc/ChangeLog

@@ -1,4 +1,134 @@
 ===============================================================
+Tag name: ctsm5.3.062
+Originator(s): slevis (Samuel Levis,UCAR/TSS,303-665-1310)
+Date: Thu 03 Jul 2025 12:23:00 PM MDT
+One-line Summary: Put instantaneous and non-inst. fields on separate hist files
+
+Purpose and description of changes
+----------------------------------
+ Following ctsm5.3.018 "Change history time to be the middle of the time bounds" the current change intends to prevent confusion associated with the time corresponding to instantaneous history fields by putting them on separate files than non-instantaneous fields. The result is
+ 1) two history files per clm, mosart, and rtm history tape:
+ tape h0 becomes h0a and h0i
+ tape h1 becomes h1a and h1i
+ ...
+ tape hX becomes hXa and hXi
+
+ 2) two history restart files per history restart tape:
+ rh0 becomes rh0a and rh0i
+ rh1 becomes rh1a and rh1i
+ ...
+ rhX becomes rhXa and rhXi
+
+ The clm could and still can handle not generating history (and corresponding history restart) files when empty. The rtm and mosart could not handle not generating empty files. Instead of refactoring rtm and mosart (out of scope), I introduced one active instantaneous field in mosart and one in rtm.
+
+Significant changes to scientifically-supported configurations
+--------------------------------------------------------------
+
+Does this tag change answers significantly for any of the following physics configurations?
+(Details of any changes will be given in the "Answer changes" section below.)
+
+    [Put an [X] in the box for any configuration with significant answer changes.]
+
+[ ] clm6_0
+
+[ ] clm5_0
+
+[ ] ctsm5_0-nwp
+
+[ ] clm4_5
+
+
+Bugs fixed
+----------
+List of CTSM issues fixed (include CTSM Issue # and description) [one per line]:
+ Resolves #1059 Don't allow inst. fields and averaged fields to be on the same history file
+ Resolves ESCOMP/RTM#32
+ Resolves ESCOMP/MOSART#52
+
+Notes of particular relevance for users
+---------------------------------------
+Caveats for users (e.g., need to interpolate initial conditions):
+ History tapes have new extensions, e.g. h0 becomes h0a and h0i
+ History restart tapes have new extensions, e.g. rh0 becomes rh0a and rh0i
+
+Changes to documentation:
+ Not, yet:
+ - clm documentation
+ - Adam Phillips' cmip documentation
+
+Substantial timing or memory changes:
+[e.g., check PFS test in the test suite and look at timings, if you
+expect possible significant timing changes]
+
+
+Testing summary:
+----------------
+
+ [PASS means all tests PASS; OK means tests PASS other than expected fails.]
+
+  build-namelist tests (if CLMBuildNamelist.pm has changed):
+
+    derecho - PASS
+
+  python testing (if python code has changed; see instructions in python/README.md; document testing done):
+
+    derecho - PASS
+
+  regular tests (aux_clm: https://github.com/ESCOMP/CTSM/wiki/System-Testing-Guide#pre-merge-system-testing):
+
+    derecho ----- OK
+    izumi ------- OK
+
+  fates tests: (-c fates-sci.1.84.0_api.40.0.0-ctsm5.3.061 -g fates-sci.1.84.0_api.40.0.0-ctsm5.3.062)
+    derecho ----- OK
+    izumi ------- OK
+
+  any other testing (give details below):
+
+  ctsm_sci (-c ctsm_sci-ctsm5.3.059 -g ctsm_sci-ctsm5.3.062)
+     derecho ---- FAIL and I will open an issue and mark EXPECTED FAILURE as the problem originates in ctsm5.3.060
+
+  mosart tests: (-c mosart1.1.08-ctsm5.3.061 -g mosart1.1.09-ctsm5.3.062)
+    derecho ----- OK
+    izumi ------- OK
+
+  rtm tests: (-c rtm1_0_86-ctsm5.3.061 -g rtm1_0_87-ctsm5.3.062)
+    derecho ----- OK
+    izumi ------- OK
+
+  crop_calendars tests: (tested while in ctsm5.3.058, before updating to ctsm5.3.061)
+    derecho ----- OK
+    izumi ------- OK
+
+  ssp tests: (tested while in ctsm5.3.058, before updating to ctsm5.3.061)
+    derecho ----- OK
+
+  hillslope tests: (tested while in ctsm5.3.058, before updating to ctsm5.3.061)
+    derecho ----- OK
+
+  fire tests: (tested while in ctsm5.3.058, before updating to ctsm5.3.061)
+    derecho ----- OK
+
+Answer changes
+--------------
+
+Changes answers relative to baseline: No, but read caveat
+
+ Caveat: h0 files become h0a (containing non-instantaneous fields) and h0i (containing instantaneous fields). I spot-checked clm, mosart, and rtm files and confirmed no bitwise change in answers.
+
+Other details
+-------------
+List any git submodules updated (cime, rtm, mosart, cism, fates, etc.):
+ mosart1.1.08 --> mosart1.1.09
+ rtm1_0_86 --> rtm1_0_87
+
+Pull Requests that document the changes (include PR ids):
+ https://github.com/ESCOMP/ctsm/pull/2445
+ https://github.com/ESCOMP/MOSART/pull/117
+ https://github.com/ESCOMP/RTM/pull/61
+
+===============================================================
+===============================================================
 Tag name: ctsm5.3.061
 Originator(s): slevis (Samuel Levis,UCAR/TSS,303-665-1310)
 Date: Thu 26 Jun 2025 11:28:43 AM MDT

doc/ChangeSum

@@ -1,5 +1,6 @@
 Tag                   Who      Date  Summary
 ============================================================================================================================
+       ctsm5.3.062   slevis 07/03/2025 Put inst. and non-inst. fields on separate hist files
        ctsm5.3.061   slevis 06/26/2025 Merge b4b-dev to master
        ctsm5.3.060   slevis 06/24/2025 Preliminary update of ctsm54 defaults (answer changing)
        ctsm5.3.059     erik 06/23/2025 Bring in various cleanup efforts found in previous testing after the chill changes came in