From d160e65b671171c8cc16208720e1a7eb730988fc Mon Sep 17 00:00:00 2001 From: Sam Rabin Date: Fri, 6 Oct 2023 09:18:50 -0600 Subject: [PATCH 1/5] Minor text fixes. --- .../Running-with-excess-ground-ice.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst index 23677965a5..2267d524e5 100644 --- a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst +++ b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst @@ -7,13 +7,13 @@ =================================== -Excess ground ice can be toggled with ``use_excess_ice`` namelist option. By default this option is ``.fasle.``. When +Excess ground ice can be toggled with ``use_excess_ice`` namelist option. By default this option is ``.false.``. When ``use_excess_ice`` is true, CTSM needs initial excess ice amount within soil layers to initialize. A second namelist option`use_excess_ice_streams` exists to control this process (``.false.`` is default). If ``.true.`` and use_excess_ice is ``.true.``, initial conditions will be read from a data-stream file (default is based :ref:`on IPA map from 1997 `). This is useful, since in this way, a run with excess ground ice can be started from a restart or initial dataset, that does not include excess ground ice. If the run is a continue-run, excess ice variables will **always** be expected on a restart file. -.. note:: Excess ice ammount provided by the stream file is expressed in excess ice concentration (%) and does not have a vertical distribution. Each soil layer beneath 0.5 m or (maximum active layer depth from the previous year if it is greater) down to bedrock will receive the same concentration but the ice mass will be scaled by the soil layer depth. Both naturally vegetated and crop columns get excess ice. +.. note:: Excess ice amount provided by the stream file is expressed in excess ice concentration (%) and does not have a vertical distribution. Each soil layer beneath 0.5 m (or maximum active layer depth from the previous year if it is greater) down to bedrock will receive the same concentration, but the ice mass will be scaled by the soil layer depth. Both naturally vegetated and crop columns get excess ice. Since presence of excess ice within the soil significantly alters heat diffusion within it, when starting from initial conditions where excess ice was not present, an additional spinup is required. @@ -31,7 +31,7 @@ Example: Crop Simulation > ./case.setup - # turn on excess ice and it's "stream" initialization + # turn on excess ice and its "stream" initialization > echo "use_excess_ice=.true." >> user_nl_clm > echo "use_excess_ice_streams=.true." >> user_nl_clm From bae7793ef7720e9c64367bc67c4c22adbe9810c0 Mon Sep 17 00:00:00 2001 From: Sam Rabin Date: Fri, 6 Oct 2023 09:20:23 -0600 Subject: [PATCH 2/5] Markup fixes. --- .../running-special-cases/Running-with-excess-ground-ice.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst index 2267d524e5..f126c00abc 100644 --- a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst +++ b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst @@ -8,7 +8,7 @@ Excess ground ice can be toggled with ``use_excess_ice`` namelist option. By default this option is ``.false.``. When -``use_excess_ice`` is true, CTSM needs initial excess ice amount within soil layers to initialize. A second namelist option`use_excess_ice_streams` exists to control this process (``.false.`` is default). If ``.true.`` and use_excess_ice is ``.true.``, +``use_excess_ice`` is true, CTSM needs initial excess ice amount within soil layers to initialize. A second namelist option ``use_excess_ice_streams`` exists to control this process (``.false.`` is default). If ``.true.`` and ``use_excess_ice`` is ``.true.``, initial conditions will be read from a data-stream file (default is based :ref:`on IPA map from 1997 `). This is useful, since in this way, a run with excess ground ice can be started from a restart or initial dataset, that does not include excess ground ice. If the run is a continue-run, excess ice variables will **always** be expected on a restart file. From 5dfd8db7e336db36f81f8afcb7604e68461b04c6 Mon Sep 17 00:00:00 2001 From: Sam Rabin Date: Fri, 6 Oct 2023 09:20:30 -0600 Subject: [PATCH 3/5] Remove hyphens from title. --- .../running-special-cases/Running-with-excess-ground-ice.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst index f126c00abc..10b7f3ee98 100644 --- a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst +++ b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst @@ -3,7 +3,7 @@ .. include:: ../substitutions.rst =================================== - Running-with-excess-ground-ice + Running with excess ground ice =================================== From 15c4efc5e43ca1debc709689cb69789ae5221cad Mon Sep 17 00:00:00 2001 From: Sam Rabin Date: Fri, 6 Oct 2023 09:21:51 -0600 Subject: [PATCH 4/5] Use complete relative path to cime/scripts from top level of checkout. --- .../running-special-cases/Running-with-excess-ground-ice.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst index 10b7f3ee98..be818f8f14 100644 --- a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst +++ b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst @@ -25,7 +25,7 @@ Example: Crop Simulation ------------------------------------ :: - > cd scripts + > cd cime/scripts > ./create_newcase -case I1850Clm50BgcCrop_with_exice -res f19_g17_gl4 -compset I1850Clm50BgcCrop > cd I1850Clm50BgcCrop_with_exice From 9e633dcdfc00244b2be74f03ef7f45dfc4cdd718 Mon Sep 17 00:00:00 2001 From: Sam Rabin Date: Fri, 6 Oct 2023 09:23:05 -0600 Subject: [PATCH 5/5] Remove EOL whitespace. --- .../Running-with-excess-ground-ice.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst index be818f8f14..d0b29f8682 100644 --- a/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst +++ b/doc/source/users_guide/running-special-cases/Running-with-excess-ground-ice.rst @@ -7,11 +7,11 @@ =================================== -Excess ground ice can be toggled with ``use_excess_ice`` namelist option. By default this option is ``.false.``. When -``use_excess_ice`` is true, CTSM needs initial excess ice amount within soil layers to initialize. A second namelist option ``use_excess_ice_streams`` exists to control this process (``.false.`` is default). If ``.true.`` and ``use_excess_ice`` is ``.true.``, -initial conditions will be read from a data-stream file (default is based :ref:`on IPA map from 1997 `). +Excess ground ice can be toggled with ``use_excess_ice`` namelist option. By default this option is ``.false.``. When +``use_excess_ice`` is true, CTSM needs initial excess ice amount within soil layers to initialize. A second namelist option ``use_excess_ice_streams`` exists to control this process (``.false.`` is default). If ``.true.`` and ``use_excess_ice`` is ``.true.``, +initial conditions will be read from a data-stream file (default is based :ref:`on IPA map from 1997 `). This is useful, since in this way, a run with excess ground ice can be started from a restart or initial dataset, that does not include excess ground ice. -If the run is a continue-run, excess ice variables will **always** be expected on a restart file. +If the run is a continue-run, excess ice variables will **always** be expected on a restart file. .. note:: Excess ice amount provided by the stream file is expressed in excess ice concentration (%) and does not have a vertical distribution. Each soil layer beneath 0.5 m (or maximum active layer depth from the previous year if it is greater) down to bedrock will receive the same concentration, but the ice mass will be scaled by the soil layer depth. Both naturally vegetated and crop columns get excess ice.