update changelog and changesum for ctsm5.1.dev145

doc/ChangeLog

@@ -1,4 +1,98 @@
 ===============================================================
+Tag name: ctsm5.1.dev146
+Originator(s): glemieux (Gregory Lemieux, LBNL, [email protected])
+Date: Mon Oct 23 15:22:00 PM MDT 2023
+One-line Summary: FATES cross-grid seed dispersal
+
+Purpose and description of changes
+----------------------------------
+
+This PR enables FATES to disperse seeds across neighboring grid cells using MPI. 
+The API update includes calls to new fates dispersal procedures.  There are
+four parameters that are utilized to control the dispersal kernel, although
+these were introduced in ctsm5.1.dev130 so no new default FATES parameter file
+is necessary with this update.  A new namelist parameter has been added to 
+enable the use of the seed dispersal mode.
+
+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.]
+
+[ ] clm5_1
+
+[ ] clm5_0
+
+[ ] ctsm5_0-nwp
+
+[ ] clm4_5
+
+
+Bugs fixed or introduced
+------------------------
+Known bugs introduced in this tag (include issue #):
+- ESCOMP/CTSM#1089 (Cross-grid seed dispersal mechanism is not b4b for PE layout changes)
+
+Notes of particular relevance for users
+---------------------------------------
+Changes to CTSM's user interface (e.g., new/renamed XML or namelist variables):
+- New namelist option, fates_seeddisp_cadence, added.  This option Setting the switch 
+value to zero turns off dispersal.  Setting the switch to 1, 2, or 3 sets the dispersal 
+cadence to daily, monthly or yearly.
+
+Substantial timing or memory changes:
+- Users should be careful to limit the maximum dispersal distance parameter,
+fates_seed_dispersal_max_dist, to a reasonable value based on the gridcell 
+resolution used.  Using a very large value will increase the memory requirements
+to store the gridcell neighborhood information.
+
+Notes of particular relevance for developers:
+---------------------------------------------
+Caveats for developers (e.g., code that is duplicated that requires double maintenance):
+- This PR introduces MPI calls to subroutines that are called by clm_driver.
+Comments have been provided in code to make future developers aware of these
+calls so as to avoid moving them into OpenMP threaded regions.
+
+Changes to tests or testing:
+- Two new testmods have been added into the fates suite to test seed
+dispersal.  One of the tests is to track issue CTSM#1089 which was introduced
+with this PR.
+
+Testing summary:
+----------------
+
+ [PASS means all tests PASS; OK means tests PASS other than expected fails.]
+
+  regular tests (aux_clm: https://github.com/ESCOMP/CTSM/wiki/System-Testing-Guide#pre-merge-system-testing):
+
+    cheyenne ---- OK
+    izumi ------- PASS
+
+  fates tests: (give name of baseline if different from CTSM tagname, normally fates baselines are fates-<FATES TAG>-<CTSM TAG>)
+    cheyenne ---- OK
+    izumi ------- OK
+
+Answer changes
+--------------
+
+Changes answers relative to baseline: Only fates testmods in aux_clm are
+answer changing due to science updates associated with externals update.
+
+Other details
+-------------
+
+List any externals directories updated (cime, rtm, mosart, cism, fates, etc.):
+- fates: sci.1.67.2_api.27.0.0 -> sci.1.68.0_api.28.0.0
+
+Pull Requests that document the changes (include PR ids):
+https://github.com/ESCOMP/CTSM/pull/2077
+https://github.com/NGEET/fates/pull/1005
+
+===============================================================
+===============================================================
 Tag name: ctsm5.1.dev145
 Originator(s): @cenlinhe (Cenlin He,UCAR/RAL), slevis (Samuel Levis,UCAR/TSS,303-665-1310)
 Date: Thu Oct 19 14:34:25 MDT 2023

doc/ChangeSum

@@ -1,5 +1,6 @@
 Tag                   Who      Date  Summary
 ============================================================================================================================
+    ctsm5.1.dev146 glemieux 10/23/2023 FATES cross-grid seed dispersal
     ctsm5.1.dev145   slevis 10/19/2023 SNICAR snow albedo scheme updates
     ctsm5.1.dev144 samrabin 10/19/2023 Remove a deprecated shr_mpi_bcast call
     ctsm5.1.dev143   rgknox 10/13/2023 Zeroing of wood product fluxes on fates columns