|
1 | 1 | =============================================================== |
| 2 | +Tag name: ctsm5.4.018 |
| 3 | +Originator(s): erik (Erik Kluzek,UCAR/TSS,303-497-1326) |
| 4 | +Date: Wed Feb 11 11:54:03 AM MST 2026 |
| 5 | +One-line Summary: Quick fix so that we can use Nitrogen Deposition sent from the ATM model |
| 6 | + |
| 7 | +Purpose and description of changes |
| 8 | +---------------------------------- |
| 9 | + |
| 10 | +Add the ndep_inparm namelist to drv_flds_in, so that CTSM can turn on ndep from the ATM model. Also turn on using the ndep from the ATM model for the cam LndTuningMode testmods. And make sure ndep comes from CAM when we are coupled to CAM. |
| 11 | + |
| 12 | +Significant changes to scientifically-supported configurations |
| 13 | +-------------------------------------------------------------- |
| 14 | + |
| 15 | +Does this tag change answers significantly for any of the following physics configurations? No |
| 16 | +(Details of any changes will be given in the "Answer changes" section below.) |
| 17 | + |
| 18 | + [Put an [X] in the box for any configuration with significant answer changes.] |
| 19 | + |
| 20 | +[ ] clm6_0 |
| 21 | + |
| 22 | +[ ] clm5_0 |
| 23 | + |
| 24 | +[ ] ctsm5_0-nwp |
| 25 | + |
| 26 | +[ ] clm4_5 |
| 27 | + |
| 28 | + |
| 29 | +Bugs fixed |
| 30 | +---------- |
| 31 | + |
| 32 | +List of CTSM issues fixed (include CTSM Issue # and description) [one per line]: |
| 33 | + Fixes Add ndep_inparm namelist to drv_flds_in #3742 |
| 34 | + Fixes When coupled to CAM, ndep is still read in from CTSM rather than using what CAM is sending #3737 |
| 35 | + Fixes Ndep from ATM is now hard coded to 2 fields #3743 |
| 36 | + Fixes Have testmods with cam LndTuningMode use ndep from ATM #3744 |
| 37 | + Fixes Add CLM_NDEP_FROM_CPL XML variable #3747 |
| 38 | + Fixes Difference between ndep from CTSM streams and from DATM is significant #3748 |
| 39 | + Some work on Move settings from use_cases to namelist_defaults #605 |
| 40 | + |
| 41 | +Notes of particular relevance for users |
| 42 | +--------------------------------------- |
| 43 | +Caveats for users (e.g., need to interpolate initial conditions): |
| 44 | + Now you can trigger whether Nitrogen Deposition is coming from the ATM model or read inside of CTSM |
| 45 | + (before it was ALWAYS read in) |
| 46 | + This only matters for Bgc or BgcCrop compsets |
| 47 | + You can see if ndep is coming from ATM or CTSM by doing this in your case: |
| 48 | + ./xmlquery CLM_NDEP_FROM_CPL |
| 49 | + # (will be TRUE if coming from either DATM or CAM, FALSE if read internally in CTSM |
| 50 | + grep ndep CaseDocs/* |
| 51 | + # If the above is FALSE for an I compset you'll see matches in: datm_in and lnd_in |
| 52 | + # If the above is TRUE when coupled to CAM you'll see matches in: atm_in and drv_flds_in |
| 53 | + # (and in lnd_in, but just for the empty namelist: &ndepdyn_nml) |
| 54 | + |
| 55 | + The lnd.log file also will explicitly say whether ndep is coming from ATM or read by CTSM |
| 56 | + |
| 57 | +Changes to CTSM's user interface (e.g., new/renamed XML or namelist variables): |
| 58 | + New XML variable: CLM_NDEP_FROM_CPL |
| 59 | + For I compsets this is set to FALSE, but when coupled to CAM it's set to TRUE |
| 60 | + |
| 61 | +Changes made to namelist defaults (e.g., changed parameter values): |
| 62 | + None from the user perspective, unless you try to run with CLM_NML_USE_CASE==UNSET |
| 63 | + |
| 64 | +Changes to documentation: |
| 65 | + Updated notes on ndep |
| 66 | + |
| 67 | +Notes of particular relevance for developers: |
| 68 | +--------------------------------------------- |
| 69 | + |
| 70 | +Caveats for developers (e.g., code that is duplicated that requires double maintenance): |
| 71 | + Settings for ndep moved from the use_case files to namelist_defaults_ctsm |
| 72 | + ndep_list added to namelist_definition_drv_flds.xml |
| 73 | + |
| 74 | +Changes to tests or testing: |
| 75 | + clm*cam*LndTuningMode testmods changed to have ndep come from the ATM model (so DATM) |
| 76 | + build-namelist tester updated to accomidate the addition of CLM_NDEP_FROM_CPL |
| 77 | + |
| 78 | + |
| 79 | +Testing summary: regular |
| 80 | +---------------- |
| 81 | + |
| 82 | + [PASS means all tests PASS; OK means tests PASS other than expected fails.] |
| 83 | + |
| 84 | + build-namelist tests (if CLMBuildNamelist.pm has changed): |
| 85 | + |
| 86 | + derecho - OK (some changes relative to ctsm5.4.018) |
| 87 | + |
| 88 | + regular tests (aux_clm: https://github.com/ESCOMP/CTSM/wiki/System-Testing-Guide#pre-merge-system-testing): |
| 89 | + |
| 90 | + derecho ----- OK |
| 91 | + izumi ------- OK |
| 92 | + |
| 93 | +If the tag used for baseline comparisons was NOT the previous tag, note that here: |
| 94 | + |
| 95 | + |
| 96 | +Answer changes |
| 97 | +-------------- |
| 98 | + |
| 99 | +Changes answers relative to baseline: yes (just when coupled to CAM or the CAM LndTuningMode testmods are used) |
| 100 | + |
| 101 | + Summarize any changes to answers, i.e., |
| 102 | + - what code configurations: Only BGC cases for when Coupled to CAM / CAM LND_TUNING_MODE |
| 103 | + - what platforms/compilers: All |
| 104 | + - nature of change: same climate, changes Nitrogen deposition |
| 105 | + |
| 106 | + We didn't run simulations but as the change to ndep is a normalized RMS of 1.e-4 we felt it should be OK |
| 107 | + |
| 108 | +Other details |
| 109 | +------------- |
| 110 | + |
| 111 | +Pull Requests that document the changes (include PR ids): |
| 112 | +(https://github.com/ESCOMP/ctsm/pull) |
| 113 | + |
| 114 | + #3745 -- allows ndep to come from ATM model |
| 115 | + |
| 116 | +=============================================================== |
| 117 | +=============================================================== |
2 | 118 | Tag name: ctsm5.4.017 |
3 | 119 | Originator(s): slevis (Samuel Levis,UCAR/TSS,303-665-1310) |
4 | 120 | Date: Mon Feb 9 12:34:51 PM MST 2026 |
|
0 commit comments