diff --git a/doc/ChangeLog b/doc/ChangeLog index 537febda2c..58599534be 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,4 +1,98 @@ =============================================================== +Tag name: ctsm5.1.dev146 +Originator(s): glemieux (Gregory Lemieux, LBNL, glemieux@lbl.gov) +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--) + 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 diff --git a/doc/ChangeSum b/doc/ChangeSum index d53fd26b54..222d608adb 100644 --- a/doc/ChangeSum +++ b/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