Skip to content

Commit

Permalink
update # of CCPP suites
Browse files Browse the repository at this point in the history
  • Loading branch information
gspetro-NOAA committed Aug 16, 2023
1 parent 9aaafc4 commit 51d7350
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 3 deletions.
5 changes: 3 additions & 2 deletions docs/UsersGuide/source/Reference/FAQ.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,14 +30,15 @@ See :numref:`Section %s <UserSpecificConfig>` and/or :numref:`Section %s <DirPar
How do I change the Physics Suite Definition File (SDF)?
=========================================================

The SDF is set in the ``workflow:`` section of the ``config.yaml`` file using the variable ``CCPP_PHYS_SUITE``. The four supported physics suites for the SRW Application as of the v2.1.0 release are:
The SDF is set in the ``workflow:`` section of the ``config.yaml`` file using the variable ``CCPP_PHYS_SUITE``. The five supported physics suites for the SRW Application are:

.. code-block:: console
FV3_GFS_v16
FV3_RRFS_v1beta
FV3_HRRR
FV3_WoFS_v0
FV3_RAP
When users run the ``generate_FV3LAM_wflow.py`` script, the SDF file is copied from its location in the forecast
model directory to the experiment directory ``$EXPTDIR``. For more information on the :term:`CCPP` physics suite parameters, see :numref:`Section %s <CCPP_Params>`.
Expand Down Expand Up @@ -247,7 +248,7 @@ Then, users can configure a new experiment by updating the environment variables
How can I add a physics scheme (e.g., YSU PBL) to the UFS SRW App?
====================================================================

At this time, there are ten physics suites available in the SRW App, :ref:`four of which are fully supported <CCPP_Params>`. However, several additional physics schemes are available in the UFS Weather Model (WM) and can be enabled in the SRW App. The CCPP Scientific Documentation details the various `namelist options <https://dtcenter.ucar.edu/GMTB/v6.0.0/sci_doc/_c_c_p_psuite_nml_desp.html>`__ available in the UFS WM, including physics schemes, and also includes an `overview of schemes and suites <https://dtcenter.ucar.edu/GMTB/v6.0.0/sci_doc/allscheme_page.html>`__.
At this time, there are ten physics suites available in the SRW App, :ref:`five of which are fully supported <CCPP_Params>`. However, several additional physics schemes are available in the UFS Weather Model (WM) and can be enabled in the SRW App. The CCPP Scientific Documentation details the various `namelist options <https://dtcenter.ucar.edu/GMTB/v6.0.0/sci_doc/_c_c_p_psuite_nml_desp.html>`__ available in the UFS WM, including physics schemes, and also includes an `overview of schemes and suites <https://dtcenter.ucar.edu/GMTB/v6.0.0/sci_doc/allscheme_page.html>`__.
To enable an additional physics scheme, such as the YSU PBL scheme, in the SRW App, users must modify ``ufs-srweather-app/parm/FV3.input.yml`` and set the variable corresponding to the desired physics scheme to *True* under the physics suite they would like to use (e.g., ``do_ysu = True``).

It may be necessary to disable another physics scheme, too. For example, when using the YSU PBL scheme, users should disable the default SATMEDMF PBL scheme (*satmedmfvdifq*) by setting the ``satmedmf`` variable to *False* in the ``FV3.input.yml`` file.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -306,7 +306,7 @@ CCPP Parameter
| ``"FV3_RRFS_v1beta"``
| ``"FV3_HRRR"``
| ``"FV3_WoFS_v0"``
| ``"FV3_RAP"`` (limited support)
| ``"FV3_RAP"``
Other valid values can be found in the ``ush/valid_param_vals.yaml`` file, but users can not expect full support for these schemes.

Expand Down

0 comments on commit 51d7350

Please sign in to comment.