Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[develop] Updating ConfigWorkflow.rst file to reflect changes to Config defaults #1157

Merged
merged 11 commits into from
Dec 10, 2024
24 changes: 16 additions & 8 deletions doc/UsersGuide/CustomizingTheWorkflow/ConfigWorkflow.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ The following is a list of the parameters in the ``config_defaults.yaml`` file.

.. _user:

USER Configuration Parameters
=================================
USER-Related Configuration Parameters
======================================

If non-default parameters are selected for the variables in this section, they should be added to the ``user:`` section of the ``config.yaml`` file.

Expand Down Expand Up @@ -252,7 +252,7 @@ WORKFLOW Configuration Parameters

If non-default parameters are selected for the variables in this section, they should be added to the ``workflow:`` section of the ``config.yaml`` file.

``WORKFLOW_ID``: (Default: ``''``)
``WORKFLOW_ID``: (Default: "")
Unique ID for the workflow run that will be set in ``setup.py``.

``RELATIVE_LINK_FLAG``: (Default: "--relative")
Expand Down Expand Up @@ -360,6 +360,9 @@ Set File Name Parameters
``AQM_RC_TMPL_FN``: (Default: "aqm.rc")
Template file name of resource file for NOAA Air Quality Model (AQM).

``FIRE_NML_FN``: (Default: "namelist.fire")
Name of namelist file for UFS_FIRE capability.

Set File Path Parameters
----------------------------

Expand Down Expand Up @@ -390,6 +393,8 @@ Set File Path Parameters
``AQM_RC_TMPL_FP``: (Default: ``'{{ [user.PARMdir, AQM_RC_TMPL_FN]|path_join }}'``)
Path to the ``AQM_RC_TMPL_FN`` file.

``FIRE_NML_BASE_FP``: (Default: ``'{{ [user.PARMdir, FIRE_NML_FN]|path_join }}'``)
Path to the ``FIRE_NML_FN`` file in the ``parm`` directory.

*Experiment Directory* Files and Paths
------------------------------------------
Expand All @@ -411,6 +416,9 @@ This section contains files and paths to files that are staged in the experiment
``FV3_NML_STOCH_FP``: (Default: ``'{{ [EXPTDIR, [FV3_NML_FN, "_stoch"]|join ]|path_join }}'``)
Path to a namelist file that includes stochastic physics namelist parameters.

``FIRE_NML_FP``: (Default: ``'{{ [EXPTDIR, FIRE_NML_FN]|path_join }}'``)
Path to the ``FIRE_NML_FN`` file in the experiment directory.

``FCST_MODEL``: (Default: "ufs-weather-model")
Name of forecast model. Valid values: ``"ufs-weather-model"`` | ``"fv3gfs_aqm"``

Expand Down Expand Up @@ -994,7 +1002,7 @@ Vertical Coordinate Parameters
``LEVP``: (Default: 65)
Number of vertical levels in the atmosphere. In order to change this
number, the user will additionally need to create a vertical coordinate
distribution file; this process is described in :numref:`Section %s <VerticalLevels>`
distribution file; this process is described in :numref:`Section %s <VerticalLevels>`.
This value should be the same in both ``make_ics`` and ``make_lbcs``.

``VCOORD_FILE``: (Default: ``"{{ workflow.FIXam }}/global_hyblev.l65.txt"``)
Expand All @@ -1020,7 +1028,7 @@ Vertical Coordinate Parameters
``LEVP``: (Default: 65)
Number of vertical levels in the atmosphere. In order to change this
number, the user will additionally need to create a vertical coordinate
distribution file; this process is described in :numref:`Section %s <VerticalLevels>`
distribution file; this process is described in :numref:`Section %s <VerticalLevels>`.
This value should be the same in both ``make_ics`` and ``make_lbcs``.

``VCOORD_FILE``: (Default: ``"{{ workflow.FIXam }}/global_hyblev.l65.txt"``)
Expand Down Expand Up @@ -1134,7 +1142,7 @@ Write-Component (Quilting) Parameters
``PRINT_ESMF``: (Default: false)
Flag that determines whether to output extra (debugging) information from :term:`ESMF` routines. Note that the write component uses ESMF library routines to interpolate from the native forecast model grid to the user-specified output grid (which is defined in the model configuration file ``model_configure`` in the forecast run directory). Valid values: ``True`` | ``False``

``PE_MEMBER01``: (Default: ``'{{ OMP_NUM_THREADS_RUN_FCST * (LAYOUT_Y * LAYOUT_X + WRTCMP_write_groups * WRTCMP_write_tasks_per_group) if QUILTING else OMP_NUM_THREADS_RUN_FCST * (LAYOUT_Y * LAYOUT_X)}}'``)
``PE_MEMBER01``: (Default: ``'{{ OMP_NUM_THREADS_RUN_FCST * (LAYOUT_Y * LAYOUT_X + WRTCMP_write_groups * WRTCMP_write_tasks_per_group) + fire.FIRE_NUM_TASKS if QUILTING else OMP_NUM_THREADS_RUN_FCST * (LAYOUT_Y * LAYOUT_X) + fire.FIRE_NUM_TASKS}}'``)
The number of MPI processes required by the forecast. When QUILTING is true, it is calculated as:

.. math::
Expand Down Expand Up @@ -2143,7 +2151,7 @@ Non-default parameters for the Community Fire Behavior Model (CFBM) in SRW are s
.. note::
If ``FIRE_NUM_IGNITIONS > 1``, the following variables should be lists with one entry for each ignition

``FIRE_IGNITION_ROS`` (Default: 0.0)
``FIRE_IGNITION_ROS`` (Default: 0.5)
gspetro-NOAA marked this conversation as resolved.
Show resolved Hide resolved
Ignition rate of spread (Rothermel parameterization)

``FIRE_IGNITION_START_LAT`` (Default: 40.609)
Expand All @@ -2164,7 +2172,7 @@ Non-default parameters for the Community Fire Behavior Model (CFBM) in SRW are s
``FIRE_IGNITION_START_TIME`` (Default: 6480)
Start time of ignition(s) in seconds (counting from the beginning of the simulation)

``FIRE_IGNITION_START_TIME`` (Default: 7000)
``FIRE_IGNITION_END_TIME`` (Default: 7000)
End time of ignition(s) in seconds (counting from the beginning of the simulation)


Expand Down
Loading