Update "What's New in CTSM 5.3" #2789

samsrabin · 2024-09-25T18:08:19Z

Description of changes

Rearranging a bit to highlight things that users probably care about more than software engineers.
Removing line breaks, as this harms searchability.
Using hash marks as Markdown headers instead of title underlines, as these are easier to understand.

It might be easier for further discussion to take place in a Google Doc for now... I've made one here.

Specific notes

Contributors other than yourself, if any: @ekluzek

CTSM Issues Fixed: None

Are answers expected to change (and if so in what way)? No

Any User Interface Changes (namelist or namelist defaults changes)? No

Does this create a need to change or add documentation? Did you do so? No

Testing performed, if any: None needed.

Remaining questions/tasks

Add links to PRs/issue throughout, so that users can get more information.
Move to docs directory?

samsrabin · 2024-09-25T18:09:00Z

WhatsNewInCTSM5.3.md

-  - Snow thermal conductivity is now Sturm_1997
-  - New IC file for f09 1850
+  - Snow thermal conductivity method is now `Sturm_1997`
+  - New initial conditions file for f09 ("1-degree") 1850, with more in progress


“with more in progress”—yes?

Yes, correct.

samsrabin · 2024-09-25T18:09:23Z

WhatsNewInCTSM5.3.md

+- Surface datasets now provided for the `ne0np4.POLARCAP.ne30x4` grid.
+- Surface datasets now have their version number embedded to prevent mismatch of surface dataset and CTSM version.
+- Remove the `--hires_pft` option from `mksurfdata_esmf` as we don't have the datasets for it.
+- Remove `VIC` fields from surface datasets.


What are (were) VIC fields?

VIC is an alternative hydrological parameterization that you could turn on, that we are deprecating. It required a few fields on the surface datasets to be used. This added complexity to both surface datasets as well as testing for it. So removing it simplifies a bunch of things all around.

We could look for what fields were added to the surface datasets, but I think just saying they ware removed is sufficient here.

samsrabin · 2024-09-25T18:10:01Z

WhatsNewInCTSM5.3.md

  - Updates to BGC fire method

 Changes for all physics versions:
-
  - Parameter files updated
  - FATES parameter file updated
  - Glacier region 1 is now undefined


"Glacier region 1 is now undefined": What does this mean in terms of answer changes? Why should users care?

This is something I need to look at more carefully to describe accurately. We also might want to get Bill to help make sure we are accurate.

samsrabin · 2024-09-25T18:10:18Z

WhatsNewInCTSM5.3.md


- 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
+- 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


"With new surface datasets the following GLC fields...": What does this mean in terms of answer changes? Why should users care?

Same as above.

This is a good way to frame it by the way "why should users care"?. That's a good way to handle everything here.

samsrabin · 2024-09-25T18:11:49Z

WhatsNewInCTSM5.3.md

+- Fix an important bug on soil fields that was there since `ctsm5.2.0`. This has the side effect of `mksurfdata_esmf` now giving identical answers with a change in number of processors, as it should.
+- Surface datasets now provided for the `ne0np4.POLARCAP.ne30x4` grid.
+- Surface datasets now have their version number embedded to prevent mismatch of surface dataset and CTSM version.
+- Remove the `--hires_pft` option from `mksurfdata_esmf` as we don't have the datasets for it.


Is --hires_pft removal maybe not worth mentioning? If the datasets aren't available, was anyone using it? Moreover, this tool change doesn’t fit with the substantive changes to surface datasets described in the rest of the section.

Good question. I thought it worth mentioning for users of mksurfdata_esmf because it was a user visible option that we took away. Hence, it's good to explain why. The point is it was an option that wasn't functional so we removed it, and we'll return it when it is functional.

samsrabin · 2024-09-25T18:12:59Z

WhatsNewInCTSM5.3.md

  - Pass active glacier (CISM) runoff directly to river model (MOSART)
-  - Add the option for using matrix for Carbon/Nitrogen BGC spinup
+  - Add the option for using Matrix CN method for Carbon/Nitrogen BGC spinup


Since CN Matrix is an option, does it really fit in the “answer changes” section?

Good point, it only changes answers when turned on, which normally is just for spinup.

samsrabin · 2024-09-25T18:13:49Z

WhatsNewInCTSM5.3.md


- 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
+- 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.


So mksurfdata_esmf can now make land-use timeseries files back to 1700. Have any of those actually been made?

We did make 1700 for f09. I'm pretty sure we have them in the namelist defaults. Although I'd have to check.

samsrabin · 2024-09-25T18:14:06Z

WhatsNewInCTSM5.3.md


-New surface datasets:
-=====================
+## New surface datasets


Should this section title also mention land-use timeseries files?

Yes. I think of "surface datasets" describing both, but for clarity you could spell out both fsurdat and flanduse_timeseries files.

samsrabin · 2024-09-25T18:15:18Z

WhatsNewInCTSM5.3.md


-Changes to CTSM Answers:
-========================
+## Changes to CTSM answers


This section should mention new surface datasets and land-use timeseries files. Are those only used in clm6_0 physics or all physics versions?

All physics versions.

ekluzek

This is great. Love the cleanup here.

ekluzek · 2024-10-10T09:51:33Z

WhatsNewInCTSM5.3.md


-New surface datasets:
-=====================
+## New surface datasets


Yes. I think of "surface datasets" describing both, but for clarity you could spell out both fsurdat and flanduse_timeseries files.

ekluzek · 2024-10-10T09:53:28Z

WhatsNewInCTSM5.3.md

  - Updates to BGC fire method

 Changes for all physics versions:
-
  - Parameter files updated
  - FATES parameter file updated
  - Glacier region 1 is now undefined


This is something I need to look at more carefully to describe accurately. We also might want to get Bill to help make sure we are accurate.

ekluzek · 2024-10-10T09:54:27Z

WhatsNewInCTSM5.3.md


- 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
+- 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


Same as above.

This is a good way to frame it by the way "why should users care"?. That's a good way to handle everything here.

ekluzek · 2024-10-10T09:55:20Z

WhatsNewInCTSM5.3.md


- 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
+- 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.


We did make 1700 for f09. I'm pretty sure we have them in the namelist defaults. Although I'd have to check.

ekluzek · 2024-10-10T09:57:21Z

WhatsNewInCTSM5.3.md

+- Fix an important bug on soil fields that was there since `ctsm5.2.0`. This has the side effect of `mksurfdata_esmf` now giving identical answers with a change in number of processors, as it should.
+- Surface datasets now provided for the `ne0np4.POLARCAP.ne30x4` grid.
+- Surface datasets now have their version number embedded to prevent mismatch of surface dataset and CTSM version.
+- Remove the `--hires_pft` option from `mksurfdata_esmf` as we don't have the datasets for it.


Good question. I thought it worth mentioning for users of mksurfdata_esmf because it was a user visible option that we took away. Hence, it's good to explain why. The point is it was an option that wasn't functional so we removed it, and we'll return it when it is functional.

ekluzek · 2024-10-10T10:01:29Z

WhatsNewInCTSM5.3.md

+- Surface datasets now provided for the `ne0np4.POLARCAP.ne30x4` grid.
+- Surface datasets now have their version number embedded to prevent mismatch of surface dataset and CTSM version.
+- Remove the `--hires_pft` option from `mksurfdata_esmf` as we don't have the datasets for it.
+- Remove `VIC` fields from surface datasets.


VIC is an alternative hydrological parameterization that you could turn on, that we are deprecating. It required a few fields on the surface datasets to be used. This added complexity to both surface datasets as well as testing for it. So removing it simplifies a bunch of things all around.

We could look for what fields were added to the surface datasets, but I think just saying they ware removed is sufficient here.

Update WhatsNewInCTSM5.3.md

89e9f32

samsrabin added documentation additions or edits to user-facing documentation bfb bit-for-bit labels Sep 25, 2024

samsrabin commented Sep 25, 2024

View reviewed changes

ekluzek approved these changes Oct 10, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update "What's New in CTSM 5.3" #2789

Update "What's New in CTSM 5.3" #2789

samsrabin commented Sep 25, 2024 •

edited

Loading

samsrabin Sep 25, 2024

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024 •

edited

Loading

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024 •

edited

Loading

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024 •

edited

Loading

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024

ekluzek Oct 10, 2024

samsrabin Sep 25, 2024

ekluzek Oct 10, 2024

ekluzek left a comment

ekluzek Oct 10, 2024

ekluzek Oct 10, 2024

ekluzek Oct 10, 2024

ekluzek Oct 10, 2024

ekluzek Oct 10, 2024

ekluzek Oct 10, 2024

Update "What's New in CTSM 5.3" #2789

Are you sure you want to change the base?

Update "What's New in CTSM 5.3" #2789

Conversation

samsrabin commented Sep 25, 2024 • edited Loading

Description of changes

Specific notes

Remaining questions/tasks

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

samsrabin Sep 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

samsrabin Sep 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

samsrabin Sep 25, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ekluzek left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

samsrabin commented Sep 25, 2024 •

edited

Loading

samsrabin Sep 25, 2024 •

edited

Loading

samsrabin Sep 25, 2024 •

edited

Loading

samsrabin Sep 25, 2024 •

edited

Loading