From 6baba6f96fbb178ef5827d98bd28347fd782ad5a Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Fri, 6 Sep 2024 12:05:21 -0600 Subject: [PATCH 1/9] Start getting the template for the ctsm5.3.0 ChangeLog --- doc/ChangeLog | 138 ++++++++++++++++++++++++++++++++++++++++++++++++++ doc/ChangeSum | 1 + 2 files changed, 139 insertions(+) diff --git a/doc/ChangeLog b/doc/ChangeLog index e553a59730..fd46741fec 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,4 +1,142 @@ =============================================================== +Tag name: ctsm5.3.0 +Originator(s): erik (Erik Kluzek,UCAR/TSS,303-497-1326) +Date: Fri 06 Sep 2024 02:21:22 AM MDT +One-line Summary: Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data + +Purpose and description of changes +---------------------------------- + +Changes to CTSM: +================ + + +New surface datasets: +===================== + + +New input datasets to mksurfdata_esmf: +====================================== + + +Contributors +------------ + + +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.] + +[X] clm6_0 + +[X] clm5_1 + +[X] clm5_0 + +[X] ctsm5_0-nwp + +[X] clm4_5 + + +Bugs fixed +---------- + +List of CTSM issues fixed (include CTSM Issue # and description) [one per line]: + +Notes of particular relevance for users +--------------------------------------- + +Caveats for users (e.g., need to interpolate initial conditions): + +Changes to CTSM's user interface (e.g., new/renamed XML or namelist variables): + +Changes made to namelist defaults (e.g., changed parameter values): + +Changes to the datasets (e.g., parameter, surface or initial files): + +Changes to documentation: + +Things being deprecated (which will be removed): + +Notes of particular relevance for developers: +--------------------------------------------- + +Caveats for developers (e.g., code that is duplicated that requires double maintenance): + +Changes to tests or testing: + + +Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_esmf python) +---------------- + [PASS means all tests PASS; OK means tests PASS other than expected fails.] + + build-namelist tests (if CLMBuildNamelist.pm has changed): + + derecho - + + python testing (if python code has changed; see instructions in python/README.md; document testing done): + + derecho - + + regular tests (aux_clm: https://github.com/ESCOMP/CTSM/wiki/System-Testing-Guide#pre-merge-system-testing): + + derecho ----- + izumi ------- + + fates tests: (give name of baseline if different from CTSM tagname, normally fates baselines are fates--) + derecho ----- + izumi ------- + + any other testing (give details below): + + mksurfdata_esmf + derecho ---- run "make all" to create all datasets (completes in XXX hours) + (crop-global-SSP2-4.5-ne30 was longest at 6 hr, most completed in XXX hours) + + ctsm_sci + derecho ---- + + mosart + derecho ---- + izumi ------ + + rtm + derecho ---- + + +Answer changes +-------------- + +Changes answers relative to baseline: Yes! New surface datasets so answers change for ALL simulations! + + Summarize any changes to answers, i.e., + - what code configurations: ALL + - what platforms/compilers: ALL + - nature of change (roundoff; larger than roundoff/same climate; new climate): + new climate + + If this tag changes climate describe the run(s) done to evaluate the new + climate (put details of the simulations in the experiment database) + - casename: + + URL for LMWG diagnostics output used to validate new climate: + + +Other details +------------- +[Remove any lines that don't apply. Remove entire section if nothing applies.] + +List any git submodules updated (cime, rtm, mosart, cism, fates, etc.): + +Pull Requests that document the changes (include PR ids): +(https://github.com/ESCOMP/ctsm/pull) + +=============================================================== +=============================================================== Tag name: ctsm5.2.028 Originator(s): rgknox (Ryan Knox, LBNL, rgknox@lbl.gov) glemieux (Gregory Lemieux, LBNL, glemieux@lbl.gov) diff --git a/doc/ChangeSum b/doc/ChangeSum index 45bab07440..c592a29382 100644 --- a/doc/ChangeSum +++ b/doc/ChangeSum @@ -1,5 +1,6 @@ Tag Who Date Summary ============================================================================================================================ + ctsm5.3.0 erik 09/06/2024 Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data ctsm5.2.028 rgknox 09/05/2024 FATES history flushing update ctsm5.2.027 erik 08/28/2024 Merge b4b-dev ctsm5.2.026 slevis 08/23/2024 Turn on excess ice, explicit AC, Leung_2023 for clm6 From aa469b160288dc6aad0bfb795d4456c00adf7478 Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Wed, 11 Sep 2024 11:07:49 -0600 Subject: [PATCH 2/9] More updates, add in another double tag ctsm5.2.029 to document just the part that changes from ctsm5.2.028 --- README | 22 +++--- README.md | 4 +- README_GITFLEXIMOD.rst | 4 +- bld/README | 16 ++--- doc/ChangeLog | 149 ++++++++++++++++++++++++++++++++--------- doc/ChangeSum | 3 +- 6 files changed, 143 insertions(+), 55 deletions(-) diff --git a/README b/README index 8b4e15e557..d3dcbce19f 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ -$CTSMROOT/README 04/19/2023 +$CTSMROOT/README 09/05/2024 -Community Terrestrial Systems Model (CTSM) science version 5.2 series -- source code, tools, +Community Terrestrial Systems Model (CTSM) science version 5.3 series -- source code, tools, offline-build and test scripts. This gives you everything you need to run CTSM with CESM with the CMEPS driver and CDEPS data models to provide CRU NCEP or GSWP3 forcing data in place of a modeled atmosphere. @@ -51,7 +51,7 @@ tools ------------- CTSM Offline tools to prepare input datasets and process out cime_config ------- Configuration files of cime for compsets and CTSM settings bin/git-fleximod -- Script to manage the needed sub-component source directories (handled with git submodule) py_env_create ----- Script to setup the python environment for CTSM python tools using conda -python ------------ Python modules used in tools and testing and automated checking of ALL CTSM python scirpts +python ------------ Python modules used in tools and testing and automated checking of ALL CTSM python scripts Directory structure only for a CTSM checkout: @@ -66,6 +66,8 @@ components/cmeps -------------------- CESM top level driver (for NUOPC driver [w components/cdeps -------------------- CESM top level data model shared code (for NUOPC driver). components/cism --------------------- CESM Community land Ice Sheet Model. components/mosart ------------------- Model for Scale Adaptive River Transport +components/mizuRoute ---------------- Reached based river transport model for water routing + (allows both gridded river and Hydrologic Responce Unit river grids) components/rtm ---------------------- CESM River Transport Model. Top level documentation ($CTSMROOT): @@ -74,6 +76,7 @@ README ------------------- This file README.md ---------------- File that displays on github under https::/github.com/ESCOMP/CTSM.git README.rst --------------- File that displays under the project in github README_GITFLEXIMOD.rst --- Information on how to work with git-fleximod for CTSM +WhatsNewinCTSM5.3.md ----- Overview document of the changes between ctsm5.2.0 and ctsm5.3.0 CODE_OF_CONDUCT.md ------- Code of Conduct for how to work with each other on the CTSM project Copyright ---------------- CESM Copyright file doc/UpdateChangeLog.pl --- Script to add documentation on a tag to the @@ -104,17 +107,16 @@ run_sys_tests --------------- Python script to send the standard CTSM testing of parse_cime.cs.status -------- Script to parse test status files cs.status.* created by create_test (can be used along with run_sys_tests) doc/Quickstart.GUIDE -------- Quick guide to using NUOPC scripts. -doc/IMPORTANT_NOTES --------- Some important notes about this version of - CTSM, configuration modes and namelist items - that are not validated or functional. +doc/IMPORTANT_NOTES.md ------ Some important notes about this version of + CTSM, configuration modes and namelist items + that are not validated or functional. doc/ChangeLog --------------- Detailed list of changes for each model version. doc/ChangeSum --------------- Summary one-line list of changes for each model version. doc/UsersGuide -------------- CTSM Users Guide -doc/IMPORTANT_NOTES --------- Some important notes on caveats for some configurations/namelist items bld/README ------------------ Description of how to use the build-namelist scripts. -bld/build-namelist ---------- Script to build CTSM namelists. +bld/build-namelist ---------- Lower level script to build CTSM namelists. cime_config/buildnml ------------- Build the CTSM namelist for CIME cime_config/buildlib ------------- Build the CTSM library @@ -155,9 +157,9 @@ src/dyn_subgrid --- Dynamic land unit change src/init_interp --- Online interpolation scr/fates --------- FATES model and sub-directories Functionally Assembled Terrestrial Ecosystem Simulator (FATES) - Experimental Ecosystem Demography model + Ecosystem Demography model src/utils --------- Utility codes -src/self_tests ---- Internal testing (unit tests run as a part of a CTSM simulation) +src/self_tests ---- Internal testing (unit tests run as a part of a CTSM system test) src/unit_test_shr - Unit test shared modules for unit testing src/unit_test_stubs Unit test stubs that replicate CTSM code simpler diff --git a/README.md b/README.md index 045af9f6a1..5e800a0b77 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ The Community Terrestrial Systems Model. -This includes the Community Land Model (CLM5.0 and CLM4.5) of the Community Earth System Model. +This includes the Community Land Model of the Community Earth System Model. For documentation, quick start, diagnostics, model output and references, see @@ -43,7 +43,7 @@ CTSM code management is provided primarily by: Software engineering team: - [Erik Kluzek](https://github.com/ekluzek) - [Bill Sacks](https://github.com/billsacks) -- [Sam Levis](https://github.com/slevisconsulting) +- [Sam Levis](https://github.com/slevis-lmwg) - [Adrianna Foster](https://github.com/adrifoster) - [Sam Rabin](https://github.com/samsrabin) - [Greg Lemieux](https://github.com/glemieux) diff --git a/README_GITFLEXIMOD.rst b/README_GITFLEXIMOD.rst index de6bbf392f..d1ab767645 100644 --- a/README_GITFLEXIMOD.rst +++ b/README_GITFLEXIMOD.rst @@ -67,10 +67,10 @@ Switching to a different CTSM branch or tag If you have already checked out a branch or tag and **HAVE NOT MADE ANY MODIFICATIONS** it is simple to change your sandbox. Say that you -checked out ctsm1.0.0 but really wanted to have ctsm1.1.0; +checked out ctsm5.2.0 but really wanted to have ctsm5.3.0; you would simply do the following:: - git checkout ctsm1.1.0 + git checkout ctsm5.3.0 ./bin/git-fleximod update You should **not** use this method if you have made any source code diff --git a/bld/README b/bld/README index 1e9517b189..feb0b8495c 100644 --- a/bld/README +++ b/bld/README @@ -4,16 +4,16 @@ CLM build and configure directory and scripts. Scripts to help you prepare to build CLM as a component within CESM, and setup a namelist for it. +This is a lower level script called from with CESM/CIME. + Important files/directories: ---------- Configure and build scripts ---------- (These scripts are also used by the cesm/cime scripts) +--------- Namelist build scripts config_files/clm_phys_vers.pm ------------- Perl module to handle different CLM versions -config_files/config_definition_ctsm.xml --- XML file defining all CTSM configuration items +config_files/config_definition_ctsm.xml --- XML file defining CTSM configuration items (mainly physics version) --------- Scripts to build the namelists ---------- (These scripts are also used by the cesm/cime scripts) build-namelist --- Build the namelists needed @@ -26,17 +26,17 @@ unit_testers --- Directory of scripts to test scipts in this directory ---------- XML Files describing namelists in namelist_files namelist_files/namelist_defaults_ctsm.xml --------- List of default values for the ctsm namelist namelist_files/namelist_defaults_overall.xml ------ List of default values for overall settings -namelist_files/namelist_defaults_usr_files.xml ---- List of default values for the user-files -namelist_files/namelist_definition_ctsm.xml -------- Definition of all namelist items for ctsm +namelist_files/namelist_defaults_usr_files.xml ---- List of default values for the user-files (deprecated) +namelist_files/namelist_definition_ctsm.xml ------- Definition of all namelist items for ctsm namelist_files/namelist_definition.xsl ------------ Describes how to view the xml file as html -namelist_files/namelist_defaults_drydep.xml ------- List of default values for the dry deposition module. namelist_files/use_cases -------------------------- Specific configurations that build-namelist uses namelist_files/use_cases/README ------------------- File explaining the naming convention for use_cases ---------- Driver namelist files, duplicated information from cime/driver/cime_config namelist_files/namelist_defaults_drv.xml ---------- List of default values for driver namelist defaults -namelist_files/namelist_defaults_drydep.xml ------- List of default values for dry deposition fields +namelist_files/namelist_defaults_drydep.xml ------- List of default values for dry deposition and MEGAN fields namelist_files/namelist_defaults_fire_emis.xml ---- List of default values for fire emission fields +namelist_files/namelist_defaults_dust_emis.xml ---- List of default values for the dust emissions module. namelist_files/namelist_definition_drv.xml -------- Definition of all driver namelist items namelist_files/namelist_definition_drv_flds.xml --- Definition of add driver fieldsnamelist items diff --git a/doc/ChangeLog b/doc/ChangeLog index fd46741fec..c5559f7f12 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -4,8 +4,8 @@ Originator(s): erik (Erik Kluzek,UCAR/TSS,303-497-1326) Date: Fri 06 Sep 2024 02:21:22 AM MDT One-line Summary: Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data -Purpose and description of changes ----------------------------------- +Purpose and description of changes since ctsm5.2.0 +-------------------------------------------------- Changes to CTSM: ================ @@ -23,32 +23,11 @@ Contributors ------------ -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.] - -[X] clm6_0 - -[X] clm5_1 - -[X] clm5_0 - -[X] ctsm5_0-nwp - -[X] clm4_5 - +Significant changes to scientifically-supported configurations since ctsm5.2.0 +------------------------------------------------------------------------------ -Bugs fixed ----------- - -List of CTSM issues fixed (include CTSM Issue # and description) [one per line]: - -Notes of particular relevance for users ---------------------------------------- +Notes of particular relevance for users for ctsm5.2.0 to ctsm5.3.0 +------------------------------------------------------------------ Caveats for users (e.g., need to interpolate initial conditions): @@ -62,8 +41,8 @@ Changes to documentation: Things being deprecated (which will be removed): -Notes of particular relevance for developers: ---------------------------------------------- +Notes of particular relevance for developers for ctsm5.2.0 to ctsm5.3.0: +------------------------------------------------------------------------ Caveats for developers (e.g., code that is duplicated that requires double maintenance): @@ -108,8 +87,8 @@ Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_e derecho ---- -Answer changes --------------- +Answer changes ctsm5.2.0 to ctsm5.3.0 +------------------------------------- Changes answers relative to baseline: Yes! New surface datasets so answers change for ALL simulations! @@ -128,12 +107,118 @@ Changes answers relative to baseline: Yes! New surface datasets so answers chang Other details ------------- -[Remove any lines that don't apply. Remove entire section if nothing applies.] List any git submodules updated (cime, rtm, mosart, cism, fates, etc.): +=============================================================== +=============================================================== +Tag name: ctsm5.2.029 +Originator(s): multiple +Date: 10 Sep 2024 +One-line Summary: Update surface datasets: double tag of ctsm5.3.0 + +Purpose and description of changes +---------------------------------- + +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.] + +[X] clm6_0 + +[X] clm5_1 + +[X] clm5_0 + +[X] ctsm5_0-nwp + +[X] clm4_5 + + +Bugs fixed +---------- + +List of CTSM issues fixed (include CTSM Issue # and description) [one per line]: + Fixes #2723 + Partly addresses #2720 + Fixes #2452 + Fixes #2570 + Fixes #2618 + Fixes #423 + Fixes #2734 + Fixes #2744 + Fixes #2502 + +Notes of particular relevance for users +--------------------------------------- + +Caveats for users (e.g., need to interpolate initial conditions): + +Changes to CTSM's user interface (e.g., new/renamed XML or namelist variables): + +Changes made to namelist defaults (e.g., changed parameter values): + glacier_region_behavior updated so that region ID 1 is UNSET + +Changes to the datasets (e.g., parameter, surface or initial files): + parameter file updated + surface datasets updatd + f09 1850 finidat file updated + fire emissions factor file updated + +Changes to documentation: + +Notes of particular relevance for developers: +--------------------------------------------- + +Caveats for developers (e.g., code that is duplicated that requires double maintenance): + +Changes to tests or testing: + VIC tests removed + +Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_esmf python) +---------------- + [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 + +Answer changes +-------------- + +Changes answers relative to baseline: Yes! New surface datasets so answers change for ALL simulations! + + Summarize any changes to answers, i.e., + - what code configurations: ALL + - what platforms/compilers: ALL + - nature of change (roundoff; larger than roundoff/same climate; new climate): + new climate + + If this tag changes climate describe the run(s) done to evaluate the new + climate (put details of the simulations in the experiment database) + - casename: + + URL for LMWG diagnostics output used to validate new climate: + + +Other details +------------- Pull Requests that document the changes (include PR ids): (https://github.com/ESCOMP/ctsm/pull) + #2500 -- ctsm5.3.0: New pft/lai/glc-behavior/soilcolor/fire datasets =============================================================== =============================================================== diff --git a/doc/ChangeSum b/doc/ChangeSum index c592a29382..31642a7378 100644 --- a/doc/ChangeSum +++ b/doc/ChangeSum @@ -1,6 +1,7 @@ Tag Who Date Summary ============================================================================================================================ - ctsm5.3.0 erik 09/06/2024 Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data + ctsm5.3.0 multiple 09/11/2024 Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data + ctsm5.2.029 multiple 09/11/2024 New surface datasets: double tag of ctsm5.3.0 ctsm5.2.028 rgknox 09/05/2024 FATES history flushing update ctsm5.2.027 erik 08/28/2024 Merge b4b-dev ctsm5.2.026 slevis 08/23/2024 Turn on excess ice, explicit AC, Leung_2023 for clm6 From 2f5bd73c2e1f3a6dba959e38db4f63c11d9f180e Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Thu, 12 Sep 2024 15:01:28 -0600 Subject: [PATCH 3/9] Finish the ctsm5.2.029 section --- doc/ChangeLog | 36 +++++++++++++++++++++++++----------- 1 file changed, 25 insertions(+), 11 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index c5559f7f12..988fe4f504 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -120,6 +120,10 @@ One-line Summary: Update surface datasets: double tag of ctsm5.3.0 Purpose and description of changes ---------------------------------- +New surface datasets because of updates in PFT/LAI/soil-color datasets, as well as two fire datasets (AG fire, pearland and the glacier behavior dataset. Also bring in an updated "PPE informed, hand-tuned" parameter file. And turn on Li2024 fire method. Also 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 mkaurfdata_esmf giving identical answers with a change in number of processors. Add in creation of ne0np4.POLARCAP.ne30x4 surface datasets. + +Asides: Remove VIC fields from surface datasets and testing. Add version to the surface datasets. Update the fire emissions factor dataset for the fire emissions testing in CTSM. Remove the --hires_pft option from mksurfdata_esmf as we don't have the datasets for it. + Significant changes to scientifically-supported configurations -------------------------------------------------------------- @@ -143,22 +147,29 @@ Bugs fixed ---------- List of CTSM issues fixed (include CTSM Issue # and description) [one per line]: - Fixes #2723 - Partly addresses #2720 - Fixes #2452 - Fixes #2570 - Fixes #2618 - Fixes #423 - Fixes #2734 - Fixes #2744 - Fixes #2502 + Fixes #2723 -- Version string on CTSM surface datasets to check for compatability + Partly addressed #2752 -- NEON surface datasets are defined in two places -- should just be one in namelist_defaults_ctsm.xml + Partly addresses #2720 -- Make polarcap surface datasets in ctsm5.3.0, remove VR 1850 datasets + Fixes #2452 -- Run mksurfdata_esmf with the new vegetation raw data + Fixes #2570 -- Historical configuration for CLM6 + Fixes #2618 -- Update fire variables on surface dataset + Fixes #423 -- Update fire variables on surface dataset + Fixes #2734 -- Update fire emissions factors + Fixes #2744 -- Soil level clm surface input data for clm5.2.0 have missing values in large domains + Fixes #2502 -- fsurdat: PCT_SAND, PCT_CLAY, ORGANIC differ with different PE layouts on derecho + Fixes #2748 -- Update hillslope datasets for 5.3 Notes of particular relevance for users --------------------------------------- Caveats for users (e.g., need to interpolate initial conditions): + New surface datasets means initial condition files created without ctsm5.3.0 surface + datasets will need to be interpolated Changes to CTSM's user interface (e.g., new/renamed XML or namelist variables): + 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 + For mksurfdata_esmf, the --vic and --hires_pft options were removed Changes made to namelist defaults (e.g., changed parameter values): glacier_region_behavior updated so that region ID 1 is UNSET @@ -166,15 +177,17 @@ Changes made to namelist defaults (e.g., changed parameter values): Changes to the datasets (e.g., parameter, surface or initial files): parameter file updated surface datasets updatd - f09 1850 finidat file updated + f09 1850 finidat file updated (also used for 2000) fire emissions factor file updated Changes to documentation: + Technical Note documentation on glacier region updated Notes of particular relevance for developers: --------------------------------------------- Caveats for developers (e.g., code that is duplicated that requires double maintenance): + Region 1 for glacier region is now undefined on purpose Changes to tests or testing: VIC tests removed @@ -209,9 +222,10 @@ Changes answers relative to baseline: Yes! New surface datasets so answers chang If this tag changes climate describe the run(s) done to evaluate the new climate (put details of the simulations in the experiment database) - - casename: + - casename: slevis ctsm52026_f09_pSASU URL for LMWG diagnostics output used to validate new climate: + https://github.com/NCAR/LMWG_dev/issues/65 Other details From 77105148dc35bf0767b8ae717c2fca8a5b4c53d7 Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Mon, 16 Sep 2024 01:53:20 -0600 Subject: [PATCH 4/9] update description --- doc/ChangeLog | 30 ++++++++++++++++++++++++++++-- 1 file changed, 28 insertions(+), 2 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 988fe4f504..695323904a 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -7,8 +7,34 @@ One-line Summary: Update surface datasets, CN Matrix, CLM60: excess ice on, expl Purpose and description of changes since ctsm5.2.0 -------------------------------------------------- -Changes to CTSM: -================ + +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 defaults for clm6_0 physics: + - Urban explicit A/C turned on + - Snow thermal conductivity is now Sturm_1997 + - New IC file for f09 1850 + - New crop calendars + - Dust emissions is now Leung_2023 + - Excess ice is turned on + - Updates to MEGAN for BVOC's + - 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 + - Pass active glacier (CISM) runoff directly to river model (MOSART) + - Add the option for using matrix for Carbon/Nitrogen BGC spinup New surface datasets: From a25bf74bff9a698df0b73915cbb698c7c5979266 Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Tue, 24 Sep 2024 19:40:48 -0600 Subject: [PATCH 5/9] Update doc/ChangeLog Description of changes to surface datasets... Co-authored-by: Samuel Levis --- doc/ChangeLog | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 695323904a..a104795230 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -40,7 +40,15 @@ Changes to CTSM Answers: New surface datasets: ===================== - +- New surface datasets because of 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. +- 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: ====================================== From 1e75db08fc30a250433b54942fc0ced7b4a045b3 Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Tue, 24 Sep 2024 20:05:47 -0600 Subject: [PATCH 6/9] A few updates --- doc/ChangeLog | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 695323904a..03f58ccc1d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -4,8 +4,8 @@ Originator(s): erik (Erik Kluzek,UCAR/TSS,303-497-1326) Date: Fri 06 Sep 2024 02:21:22 AM MDT One-line Summary: Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data -Purpose and description of changes since ctsm5.2.0 --------------------------------------------------- +Purpose and description of changes since ctsm5.2.005 +---------------------------------------------------- Changes to CTSM Infrastructure: @@ -48,6 +48,8 @@ New input datasets to mksurfdata_esmf: Contributors ------------ + @slevis-lmwg @ekluzek @lawrencepj1 @wwieder @adrifoster @samsrabin @billsacks @lifang0209 @linniahawkins @olyson + Significant changes to scientifically-supported configurations since ctsm5.2.0 ------------------------------------------------------------------------------ @@ -139,7 +141,7 @@ List any git submodules updated (cime, rtm, mosart, cism, fates, etc.): =============================================================== =============================================================== Tag name: ctsm5.2.029 -Originator(s): multiple +Originator(s): multiple (see contributors below) Date: 10 Sep 2024 One-line Summary: Update surface datasets: double tag of ctsm5.3.0 @@ -148,7 +150,7 @@ Purpose and description of changes New surface datasets because of updates in PFT/LAI/soil-color datasets, as well as two fire datasets (AG fire, pearland and the glacier behavior dataset. Also bring in an updated "PPE informed, hand-tuned" parameter file. And turn on Li2024 fire method. Also 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 mkaurfdata_esmf giving identical answers with a change in number of processors. Add in creation of ne0np4.POLARCAP.ne30x4 surface datasets. -Asides: Remove VIC fields from surface datasets and testing. Add version to the surface datasets. Update the fire emissions factor dataset for the fire emissions testing in CTSM. Remove the --hires_pft option from mksurfdata_esmf as we don't have the datasets for it. +Asides: Remove VIC fields from surface datasets and testing. Add version to the surface datasets. Update the fire emissions factor dataset for the fire emissions testing in CTSM. Remove the --hires_pft option from mksurfdata_esmf as we don't have the datasets for it. Also delete mkprocdata_map. Significant changes to scientifically-supported configurations -------------------------------------------------------------- @@ -175,7 +177,8 @@ Bugs fixed List of CTSM issues fixed (include CTSM Issue # and description) [one per line]: Fixes #2723 -- Version string on CTSM surface datasets to check for compatability Partly addressed #2752 -- NEON surface datasets are defined in two places -- should just be one in namelist_defaults_ctsm.xml - Partly addresses #2720 -- Make polarcap surface datasets in ctsm5.3.0, remove VR 1850 datasets + Partly addressed #2672 -- Excess ice testing + Fixes #2720 -- Make polarcap surface datasets in ctsm5.3.0, remove VR 1850 datasets Fixes #2452 -- Run mksurfdata_esmf with the new vegetation raw data Fixes #2570 -- Historical configuration for CLM6 Fixes #2618 -- Update fire variables on surface dataset @@ -184,6 +187,11 @@ List of CTSM issues fixed (include CTSM Issue # and description) [one per line]: Fixes #2744 -- Soil level clm surface input data for clm5.2.0 have missing values in large domains Fixes #2502 -- fsurdat: PCT_SAND, PCT_CLAY, ORGANIC differ with different PE layouts on derecho Fixes #2748 -- Update hillslope datasets for 5.3 + Fixes #2773 -- Deprecate and remove mkprocdata_map + +Contributors +------------ + @slevis-lmwg @ekluzek @lawrencepj1 @wwieder @adrifoster @samsrabin @billsacks @lifang0209 @linniahawkins @olyson Notes of particular relevance for users --------------------------------------- From f120fcd3d145f63025bbfd9d125e28c6e741aa01 Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Tue, 24 Sep 2024 21:36:30 -0600 Subject: [PATCH 7/9] Update contributors and more in the change files --- doc/ChangeLog | 71 +++++++++++++++++++++++++++++++++++---------------- 1 file changed, 49 insertions(+), 22 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 822486c0b6..8c79e548b8 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,12 +1,16 @@ =============================================================== Tag name: ctsm5.3.0 -Originator(s): erik (Erik Kluzek,UCAR/TSS,303-497-1326) +Originator(s): multiple (see below) Date: Fri 06 Sep 2024 02:21:22 AM MDT One-line Summary: Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data Purpose and description of changes since ctsm5.2.005 ---------------------------------------------------- +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. Changes to CTSM Infrastructure: =============================== @@ -16,7 +20,7 @@ Changes to CTSM Infrastructure: Changes to CTSM Answers: ======================== - + Changes to defaults for clm6_0 physics: - Urban explicit A/C turned on - Snow thermal conductivity is now Sturm_1997 @@ -36,28 +40,51 @@ Changes to CTSM Answers: - Pass active glacier (CISM) runoff directly to river model (MOSART) - Add the option for using matrix for Carbon/Nitrogen BGC spinup - New surface datasets: ===================== -- New surface datasets because of 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. +- New surface datasets because of 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. - 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. +- 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. +- 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: ====================================== -Contributors +Contributors (alphabetical order by github handle) ------------ - @slevis-lmwg @ekluzek @lawrencepj1 @wwieder @adrifoster @samsrabin @billsacks @lifang0209 @linniahawkins @olyson - + @adrifoster + @billsacks + @cathyxinchangli + @chrislxj + @dmleung + @ekluzek + @Face2sea + @fang-bowen + @glemieux + @HuiWangWanderInGitHub + @jedwards + @jenniferholm + @jfkok + @KateC + @keerzhang1 + @lawrencepj1 + @lifang0209 + @linniahawkins + @mvdebolskiy + @mvertens + @olyson + @rgknox + @samsrabin + @slevis-lmwg + @wwieder Significant changes to scientifically-supported configurations since ctsm5.2.0 ------------------------------------------------------------------------------ @@ -91,20 +118,20 @@ Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_e build-namelist tests (if CLMBuildNamelist.pm has changed): - derecho - + derecho - PASS python testing (if python code has changed; see instructions in python/README.md; document testing done): - derecho - + derecho - PASS regular tests (aux_clm: https://github.com/ESCOMP/CTSM/wiki/System-Testing-Guide#pre-merge-system-testing): - derecho ----- - izumi ------- + derecho ----- OK + izumi ------- OK fates tests: (give name of baseline if different from CTSM tagname, normally fates baselines are fates--) - derecho ----- - izumi ------- + derecho ----- OK + izumi ------- OK any other testing (give details below): @@ -113,14 +140,14 @@ Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_e (crop-global-SSP2-4.5-ne30 was longest at 6 hr, most completed in XXX hours) ctsm_sci - derecho ---- + derecho ---- OK mosart - derecho ---- - izumi ------ + derecho ---- OK + izumi ------ PASS rtm - derecho ---- + derecho ---- OK Answer changes ctsm5.2.0 to ctsm5.3.0 @@ -240,7 +267,7 @@ Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_e build-namelist tests (if CLMBuildNamelist.pm has changed): - derecho - PASS + derecho - PASS (1433 namelists differ compared to ctsm5.2.028) python testing (if python code has changed; see instructions in python/README.md; document testing done): @@ -374,7 +401,7 @@ Bring b4b-dev branch to main CTSM development. Update cs.status parsing script to make expected BASELINE fails more obvious -Fix some issues with finding IC files for certain lnd_tuning_modes: all for cam7, +Fix some issues with finding IC files for certain lnd_tuning_modes: all for cam7, clm5_0_cam6.0, and clm6_0_cam6.0 Significant changes to scientifically-supported configurations From e86c33a38a25ce1f39e09ef6a480d25fa3bfe439 Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Tue, 24 Sep 2024 23:37:47 -0600 Subject: [PATCH 8/9] Finish descriptions on updates in the Change files --- doc/ChangeLog | 138 ++++++++++++++++++++++++++++++++++++-------------- doc/ChangeSum | 4 +- 2 files changed, 103 insertions(+), 39 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 8c79e548b8..675545633d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,7 +1,7 @@ =============================================================== Tag name: ctsm5.3.0 Originator(s): multiple (see below) -Date: Fri 06 Sep 2024 02:21:22 AM MDT +Date: Tue 24 Sep 2024 11:34:58 PM MDT One-line Summary: Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data Purpose and description of changes since ctsm5.2.005 @@ -43,7 +43,6 @@ Changes to CTSM Answers: New surface datasets: ===================== -- New surface datasets because of 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. - 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. @@ -56,6 +55,7 @@ New 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. Contributors (alphabetical order by github handle) ------------ @@ -84,33 +84,98 @@ Contributors (alphabetical order by github handle) @rgknox @samsrabin @slevis-lmwg + @TeaganKing @wwieder -Significant changes to scientifically-supported configurations since ctsm5.2.0 ------------------------------------------------------------------------------- +Significant changes to scientifically-supported configurations since ctsm5.2.005 +-------------------------------------------------------------------------------- -Notes of particular relevance for users for ctsm5.2.0 to ctsm5.3.0 ------------------------------------------------------------------- +glacier_behavior namelist items changed for clm4_5 and clm5_0 physics +parameter and surface datasets updated for all physics options + +Notes of particular relevance for users for ctsm5.2.005 to ctsm5.3.0 +-------------------------------------------------------------------- Caveats for users (e.g., need to interpolate initial conditions): + With the updated surface datasets all finidat files being used will need to + be run with use_init_interp = TRUE Changes to CTSM's user interface (e.g., new/renamed XML or namelist variables): + New namelist items or options: + fire_method -- new options: li2024gswpfrc,li2024crujra + + new fire options: + max_rh30_affecting_fuel + defo_fire_precip_thresh_bet + defo_fire_precip_thresh_bdt + nonborpeat_fire_precip_denom + borpeat_fire_soilmoist_denom + + new fates options: + fates_harvest_mode + use_fates_lupft + use_fates_potentialveg + flandusepftdat + + new physics options: + hillslope_fsat_equals_zero + urban_explicit_ac + use_prigent_roughness + stream_fldfilename_prigentroughness + stream_meshfile_prigentroughness + excess_ice_coldstart_temp + excess_ice_coldstart_depth + + new cropcal options: + stream_year_last_cropcal_swindows + model_year_align_cropcal_swindows + stream_year_first_cropcal_cultivar_gdds + stream_year_last_cropcal_cultivar_gdds + model_year_align_cropcal_cultivar_gdds + stream_fldFileName_gdd20_baseline + stream_gdd20_seasons + flush_gdd20 + allow_invalid_gdd20_season_inputs + stream_fldFileName_gdd20_season_start + stream_fldFileName_gdd20_season_end + + cropcal options with names changed: + stream_year_first_cropcal => cropcals_rx + stream_year_last_cropcal => cropcals_rx_adapt + model_year_align_cropcal => stream_year_first_cropcal_swindows + + new CN matrix options: + use_matrixcn + use_soil_matrixcn + hist_wrt_matrixcn_diag + spinup_matrixcn + nyr_forcing + nyr_sasu + iloop_avg + + Namelist items removed: + use_fates_logging + use_dynroot + + Changes to XML options: + + LND_TUNING_MODE: New forcing options for cam4.0, cam5.0, and cam7.0 + CLM_BLDNML_OPTS: "-bgc cn" option removed + CLM_ACCELERATED_SPINUP: sasu option added + LND_SETS_DUST_EMIS_DRV_FLDS: New option to determine if CAM or CTSM set dust emission options + PLUMBER2SITE: New option to run for PLUMBER2 tower site locations Changes made to namelist defaults (e.g., changed parameter values): Changes to the datasets (e.g., parameter, surface or initial files): - -Changes to documentation: + parameter files updated + surface datasets updated + many finidat files updated Things being deprecated (which will be removed): - -Notes of particular relevance for developers for ctsm5.2.0 to ctsm5.3.0: ------------------------------------------------------------------------- - -Caveats for developers (e.g., code that is duplicated that requires double maintenance): - -Changes to tests or testing: - + Running with VIC hydrology being deprecated with testing removed + mkprocdata_map was removed + test/tools testing framework was removed Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_esmf python) ---------------- @@ -118,7 +183,7 @@ Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_e build-namelist tests (if CLMBuildNamelist.pm has changed): - derecho - PASS + derecho - PASS (1710 namelists differ from ctsm5.2.005) python testing (if python code has changed; see instructions in python/README.md; document testing done): @@ -136,8 +201,8 @@ Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_e any other testing (give details below): mksurfdata_esmf - derecho ---- run "make all" to create all datasets (completes in XXX hours) - (crop-global-SSP2-4.5-ne30 was longest at 6 hr, most completed in XXX hours) + derecho ---- run "make all" to create all datasets (completes in 6 hours) + (crop-global-SSP2-4.5-ne30 was longest at 6 hr) ctsm_sci derecho ---- OK @@ -150,34 +215,33 @@ Testing summary: release testing (regular ctsm_sci fates mosart rtm mksurfdata_e derecho ---- OK -Answer changes ctsm5.2.0 to ctsm5.3.0 -------------------------------------- - -Changes answers relative to baseline: Yes! New surface datasets so answers change for ALL simulations! - - Summarize any changes to answers, i.e., - - what code configurations: ALL - - what platforms/compilers: ALL - - nature of change (roundoff; larger than roundoff/same climate; new climate): - new climate - - If this tag changes climate describe the run(s) done to evaluate the new - climate (put details of the simulations in the experiment database) - - casename: - - URL for LMWG diagnostics output used to validate new climate: +Simulations to go with ctsm5.3.0: +--------------------------------- + https://github.com/NCAR/LMWG_dev/issues/69 + https://github.com/NCAR/LMWG_dev/issues/65 Other details ------------- -List any git submodules updated (cime, rtm, mosart, cism, fates, etc.): +List git submodules: + +fates = sci.1.78.2_api.36.0.0 +cism = cismwrap_2_2_002 +rtm = rtm1_0_80 +mosart = mosart1.1.02 +mizuRoute = cesm-coupling.n02_v2.1.2 +ccs_config = ccs_config_cesm1.0.0 +cime = cime6.0.246 +cmeps = cmeps0.14.77 +cdeps = cdeps1.0.48 +share = share1.0.19 =============================================================== =============================================================== Tag name: ctsm5.2.029 Originator(s): multiple (see contributors below) -Date: 10 Sep 2024 +Date: Tue 24 Sep 2024 11:34:58 PM MDT One-line Summary: Update surface datasets: double tag of ctsm5.3.0 Purpose and description of changes diff --git a/doc/ChangeSum b/doc/ChangeSum index 31642a7378..ebbab3ce01 100644 --- a/doc/ChangeSum +++ b/doc/ChangeSum @@ -1,7 +1,7 @@ Tag Who Date Summary ============================================================================================================================ - ctsm5.3.0 multiple 09/11/2024 Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data - ctsm5.2.029 multiple 09/11/2024 New surface datasets: double tag of ctsm5.3.0 + ctsm5.3.0 multiple 09/24/2024 Update surface datasets, CN Matrix, CLM60: excess ice on, explicit A/C on, crop calendars, Sturm snow, Leung dust emissions, prigent roughness data + ctsm5.2.029 multiple 09/24/2024 New surface datasets: double tag of ctsm5.3.0 ctsm5.2.028 rgknox 09/05/2024 FATES history flushing update ctsm5.2.027 erik 08/28/2024 Merge b4b-dev ctsm5.2.026 slevis 08/23/2024 Turn on excess ice, explicit AC, Leung_2023 for clm6 From 508a96676db91a734a4890ae7f06a7ae2227bd64 Mon Sep 17 00:00:00 2001 From: Erik Kluzek Date: Tue, 24 Sep 2024 23:59:54 -0600 Subject: [PATCH 9/9] Add the WhatsNew markdown file --- README | 2 +- WhatsNewInCTSM5.3.md | 53 +++++++++++++++++++ .../README.NUOPC_driver.md | 0 3 files changed, 54 insertions(+), 1 deletion(-) create mode 100644 WhatsNewInCTSM5.3.md rename README.NUOPC_driver.md => doc/README.NUOPC_driver.md (100%) diff --git a/README b/README index 0e3464583e..c5c06daae7 100644 --- a/README +++ b/README @@ -76,7 +76,7 @@ README ------------------- This file README.md ---------------- File that displays on github under https::/github.com/ESCOMP/CTSM.git README.rst --------------- File that displays under the project in github README_GITFLEXIMOD.rst --- Information on how to work with git-fleximod for CTSM -WhatsNewinCTSM5.3.md ----- Overview document of the changes between ctsm5.2.0 and ctsm5.3.0 +WhatsNewInCTSM5.3.md ----- Overview document of the changes between ctsm5.2.0 and ctsm5.3.0 CODE_OF_CONDUCT.md ------- Code of Conduct for how to work with each other on the CTSM project Copyright ---------------- CESM Copyright file doc/UpdateChangeLog.pl --- Script to add documentation on a tag to the diff --git a/WhatsNewInCTSM5.3.md b/WhatsNewInCTSM5.3.md new file mode 100644 index 0000000000..b1f753081b --- /dev/null +++ b/WhatsNewInCTSM5.3.md @@ -0,0 +1,53 @@ +Purpose and description of changes since ctsm5.2.005 +---------------------------------------------------- + +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. + +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 defaults for clm6_0 physics: + - Urban explicit A/C turned on + - Snow thermal conductivity is now Sturm_1997 + - New IC file for f09 1850 + - New crop calendars + - Dust emissions is now Leung_2023 + - Excess ice is turned on + - Updates to MEGAN for BVOC's + - 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 + - Pass active glacier (CISM) runoff directly to river model (MOSART) + - Add the option for using matrix for Carbon/Nitrogen BGC spinup + +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 +- 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. + diff --git a/README.NUOPC_driver.md b/doc/README.NUOPC_driver.md similarity index 100% rename from README.NUOPC_driver.md rename to doc/README.NUOPC_driver.md