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

Add GEFS regression test suite from EP5r2 configuration/case + Update UPP with new variables #2442

Merged
merged 127 commits into from
Feb 27, 2025
Merged
Changes from 1 commit
Commits
Show all changes
127 commits
Select commit Hold shift + click to select a range
3597334
Update gocart rc to match
NickSzapiro-NOAA May 6, 2024
3cf9825
Update tests/parm/params_grib2_tbl_new to match
NickSzapiro-NOAA May 6, 2024
611db6c
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Jun 6, 2024
949aa06
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Jun 12, 2024
d6c416e
Trying to use EP5 restart files. Errors in gocart
NickSzapiro-NOAA Jun 13, 2024
9452bab
Missing warm start files for ATM
NickSzapiro-NOAA Jun 14, 2024
a89de00
Runs 6 hours
NickSzapiro-NOAA Jun 17, 2024
dfa5f5f
Closing input and output diffs to EP5 control
NickSzapiro-NOAA Jun 18, 2024
46f6338
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Jun 18, 2024
a2fdc73
Merge remote-tracking branch 'ufs-community/develop' into RT_bmark_gefs
NickSzapiro-NOAA Jul 30, 2024
b5a1f3c
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Aug 2, 2024
d874760
Update hash submodules
NickSzapiro-NOAA Aug 5, 2024
eda282a
Warm start ATM. New date
NickSzapiro-NOAA Aug 5, 2024
17f243b
Match gocart rc. Add matching stochastic to global_control.nml.IN. Do…
NickSzapiro-NOAA Aug 8, 2024
e6d4338
Ignore FV3 restart checksum. Set stochastic parameters. Errors in goc…
NickSzapiro-NOAA Aug 12, 2024
af58885
Modify ExtData and AERO_ExtData.rc (thanks to Li Pan!)
NickSzapiro-NOAA Aug 13, 2024
16f07f4
Organize input data
NickSzapiro-NOAA Aug 16, 2024
ebce5b8
Sunset INPUTDATA_ROOT_BMIC
NickSzapiro-NOAA Aug 17, 2024
9c21cb3
Add gefs rc in tests/parm/gocart/gefs/
NickSzapiro-NOAA Aug 19, 2024
4f18d35
Rename cpld_bmark_p8 to cpld_bmark_gefs
NickSzapiro-NOAA Aug 19, 2024
f3994f6
Configurable MOM6 PARALLEL_RESTARTFILES
NickSzapiro-NOAA Aug 19, 2024
4440e09
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Aug 19, 2024
27301c7
MOM6_PARALLEL_RESTARTFILE in default_vars.sh
NickSzapiro-NOAA Aug 19, 2024
3eb100f
Initial restart test. More edits
NickSzapiro-NOAA Aug 22, 2024
591481c
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Aug 22, 2024
646da3d
IAU and restart tweaks. HR2 noahmptable
NickSzapiro-NOAA Aug 23, 2024
a18e3eb
Edit LIST_FILES in tests/tests/cpld_bmark_gefs
NickSzapiro-NOAA Aug 24, 2024
29293f5
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Aug 24, 2024
9c70853
Fix Linter braces ${...} error in tests/run_test.sh
NickSzapiro-NOAA Aug 24, 2024
3c64322
Fix Linter curly braces ${...} error in fv3_conf/cpld_control_run.IN
NickSzapiro-NOAA Aug 24, 2024
5740af4
don't use nbits for atm. link ExtData before pointing to optics files…
NickSzapiro-NOAA Aug 24, 2024
48cb656
atparse ATM_IGNORE_RST_CKSUM
NickSzapiro-NOAA Aug 24, 2024
3f1af92
atparse MOM6_INIT_FROM_Z in parm/MOM_input_025.IN
NickSzapiro-NOAA Aug 24, 2024
9d6a34a
Copy into INPUT/MOM6_IC_TS.nc for BMIC. Unclear if needed
NickSzapiro-NOAA Aug 27, 2024
0f71b05
MOM6_INIT_FROM_Z=True and CICE_USE_RESTART_TIME=.true. in tests/cpld_…
NickSzapiro-NOAA Aug 28, 2024
e90f12b
Merge remote-tracking branch 'ufs-community/develop' into RT_bmark_gefs
NickSzapiro-NOAA Sep 8, 2024
3bd6afc
Correct subcomponent hashes
NickSzapiro-NOAA Sep 8, 2024
ac67b15
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Sep 10, 2024
356734f
06Z warm start
NickSzapiro-NOAA Sep 12, 2024
6304a5a
atparse OCNSPPT,EPBL in nam_stochy
NickSzapiro-NOAA Sep 12, 2024
e6db585
Dependent run xxx_stoch.res.nc already copied from RESTART to INPUT
NickSzapiro-NOAA Sep 12, 2024
199a05d
Add PERT_RADTEND setting
NickSzapiro-NOAA Sep 14, 2024
9835f09
Revert MOM_input changes
NickSzapiro-NOAA Sep 14, 2024
2f67540
Add PERT_MP flag
NickSzapiro-NOAA Sep 14, 2024
40fb70d
restart reproduces from fhrot 9 but not 6
NickSzapiro-NOAA Sep 17, 2024
b2b203d
Merge remote-tracking branch 'ufs-community/develop' into RT_bmark_gefs
NickSzapiro-NOAA Sep 17, 2024
4f7528a
Replace test cpld_restart_bmark_p8
NickSzapiro-NOAA Sep 17, 2024
a879fc6
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Sep 19, 2024
c554277
GEFS prototype RT suite
NickSzapiro-NOAA Sep 19, 2024
7a10596
Suite in rt.conf
NickSzapiro-NOAA Sep 19, 2024
0c1b253
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Sep 20, 2024
f92c860
Update the inline post control files for gefs.
WenMeng-NOAA Sep 23, 2024
54c07dd
Merge pull request #4 from WenMeng-NOAA/upp_control_gefs
NickSzapiro-NOAA Sep 24, 2024
4ea5899
Use updated postxconfig files and generate aerosol fields for inline …
NickSzapiro-NOAA Sep 24, 2024
f94c8a2
Remove duplicate ln ExtData in fv3_conf/cpld_control_run.IN (again?)
NickSzapiro-NOAA Sep 30, 2024
925fc73
Copy optics*nc ExtData to run_dir only if BMIC
NickSzapiro-NOAA Sep 30, 2024
70a774b
-D32BIT=ON for GEFS suite in rt.conf
NickSzapiro-NOAA Oct 3, 2024
8b30674
Try change stacksize/threads in cpld_control_gefs
NickSzapiro-NOAA Oct 3, 2024
fd1b302
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Oct 4, 2024
3b95d9e
Template diag_table_gefsv13.IN with MOM6_OUTPUT_DIR and MOM6_OUTPUT_FH
NickSzapiro-NOAA Oct 15, 2024
1dea91c
default_vars MOM6_OUTPUT_FH=6
NickSzapiro-NOAA Oct 15, 2024
b72d660
MOM6_OUTPUT_FH=3 in cpld_debug_gefs
NickSzapiro-NOAA Oct 15, 2024
33970ac
Merge 'ufs-community/develop' into RT_bmark_gefs
NickSzapiro-NOAA Oct 18, 2024
b0f6702
Use renamed (atparsed) diag_table. MV2_SHMEM_COLL_NUM_COMM=128 doesn'…
NickSzapiro-NOAA Oct 19, 2024
cf02de2
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Oct 21, 2024
18d5644
cleanup GEFS RT suite
NickSzapiro-NOAA Oct 21, 2024
6126e6e
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Oct 25, 2024
370bb8c
Increase WAV_tasks. Increase debug WLCLK
NickSzapiro-NOAA Oct 31, 2024
98eb6dc
Merge remote-tracking branch 'ufs-community/develop' into RT_bmark_gefs
NickSzapiro-NOAA Nov 13, 2024
5053bf0
Add spptint to parm/global_control.nml.IN
NickSzapiro-NOAA Nov 13, 2024
5a85bd4
Bring in g-w changes PR
NickSzapiro-NOAA Nov 13, 2024
93b1251
no aerosol radiative feedback
NickSzapiro-NOAA Nov 13, 2024
401950a
Add {skeb,shum,sppt}int variables to parm/global_control.nml.IN
NickSzapiro-NOAA Nov 13, 2024
430ec1c
Set DT_ATMOS again (until SEDI_SEMI bug in export_ugwpv1 is fixed)
NickSzapiro-NOAA Nov 14, 2024
f13bee2
Need STOCHINI in input.nml for reproducibility if stochy on
NickSzapiro-NOAA Nov 15, 2024
bfa4753
Merge 'ufs-community/develop' into RT_bmark_gefs
NickSzapiro-NOAA Nov 22, 2024
53027ee
Set WW3_restartnc='false' to continue with binary WW3 restarts, for now
NickSzapiro-NOAA Nov 23, 2024
43cfc63
Use UPP post files for GEFS
NickSzapiro-NOAA Nov 23, 2024
d134fdc
Fix type in paths in upp
NickSzapiro-NOAA Nov 23, 2024
d0ab2d3
cp params_grib2_tbl_new from upp as well
NickSzapiro-NOAA Nov 25, 2024
e87ea29
Add change thread test to gefs suite
NickSzapiro-NOAA Nov 25, 2024
4f62b30
Use WW3 netcdf in GEFS RT suite
NickSzapiro-NOAA Nov 26, 2024
5358109
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Nov 27, 2024
e70666a
Remove duplicate pert_, iau settings already in HIDE in global_contro…
NickSzapiro-NOAA Nov 27, 2024
11c4bc7
Merge branch 'ufs-community:develop' into RT_bmark_gefs
NickSzapiro-NOAA Dec 3, 2024
b752321
Add temporary suite_gefs.conf for pre-test
NickSzapiro-NOAA Dec 3, 2024
ffc0ab7
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Dec 24, 2024
2314b16
Maintain cpld_control_gefs...update ufs.configure, remove HIDEs
Dec 27, 2024
3bfe17b
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Jan 8, 2025
c264aba
Default WLCLK except for debug
NickSzapiro-NOAA Jan 8, 2025
9eaccb7
Increase WAV_tasks, on hercules need to avoid WAV segfault in ESMF_Me…
NickSzapiro-NOAA Jan 10, 2025
adcd843
Keep WAV fix under RT_GEFS in cpld_control_run.IN
NickSzapiro-NOAA Jan 27, 2025
7208b4f
Remove custom INPUTDATA_ROOT_WW3 in rt.sh
NickSzapiro-NOAA Jan 27, 2025
7ae6f21
Turn off some cpld_*_gefs in rt.conf
NickSzapiro-NOAA Jan 27, 2025
f715294
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Jan 27, 2025
ee47a4a
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Jan 29, 2025
0b4ea78
Fix typos in fv3_conf/cpld_control_run.IN
NickSzapiro-NOAA Jan 29, 2025
a489115
Remove duplicate s2swa compile in rt.conf
NickSzapiro-NOAA Jan 29, 2025
ad82d9f
Increase scope of BMIC and remove FV3BMIC in default_vars
NickSzapiro-NOAA Jan 29, 2025
ccf930a
Separate WAV_IC and WAV_FIX if BMIC in fv3_conf/cpld_control_run.IN f…
NickSzapiro-NOAA Jan 29, 2025
a8fdd42
Tests pass bfb on hera, except for GEFS (as expected) and cpld_contro…
NickSzapiro-NOAA Jan 29, 2025
4ee7341
Tests pass on hera
NickSzapiro-NOAA Jan 31, 2025
aecbe97
Update test_changes.list
NickSzapiro-NOAA Jan 31, 2025
ad1e73f
GEFS RTs under s2swa_32bit compile in rt.conf
NickSzapiro-NOAA Feb 1, 2025
4c93f6b
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Feb 5, 2025
d316a71
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Feb 21, 2025
e1c0018
Merge branch 'develop' into RT_bmark_gefs
NickSzapiro-NOAA Feb 24, 2025
82cabf1
No longer need to set DT_ATMOS twice in cpld_control_gefs
NickSzapiro-NOAA Feb 24, 2025
69ba000
Remove comments in fv3_conf/cpld_control_run.IN
NickSzapiro-NOAA Feb 24, 2025
103bf2f
Fix cannot move error in compile.sh
NickSzapiro-NOAA Feb 24, 2025
6ff8923
Update paths for staged input data in fv3_conf/cpld_control_run.IN
NickSzapiro-NOAA Feb 24, 2025
2314900
Enable cpld_dcp_gefs in rt.conf
NickSzapiro-NOAA Feb 24, 2025
6ee836a
FV3 feature branch for upp update. Merge of #2599 from JesseMeng-NOAA
NickSzapiro-NOAA Feb 24, 2025
910f3ce
Fix typo in fv3_conf/cpld_control_run.IN
NickSzapiro-NOAA Feb 24, 2025
1d6d3fa
Fix typo in rsync change in compile.sh
NickSzapiro-NOAA Feb 24, 2025
f41b1b2
Update test_changes.list for GEFS RT + UPP update
NickSzapiro-NOAA Feb 24, 2025
974301e
Update bl_date.conf
jkbk2004 Feb 24, 2025
8295fa2
add orion RT log: passed
jkbk2004 Feb 25, 2025
0974a45
add derecho RT log: passed
jkbk2004 Feb 25, 2025
514302f
add hercules RT log: passed
jkbk2004 Feb 25, 2025
7febadc
add hera RT log passed
FernandoAndrade-NOAA Feb 26, 2025
551a150
add gaeac6 RT log passed
FernandoAndrade-NOAA Feb 26, 2025
5b0bc82
add wcoss2 RT log passed. disable cpld_dcp_gefs_intel on wcoss2
DusanJovic-NOAA Feb 27, 2025
727f44a
add acorn RT log passed. disable cpld_dcp_gefs_intel on acorn
DusanJovic-NOAA Feb 27, 2025
6a5e50d
Delete tests/suite_gefs.conf
NickSzapiro-NOAA Feb 27, 2025
79af95b
Disable cpld_dcp_gefs on gaeac5 too
NickSzapiro-NOAA Feb 27, 2025
b3a60de
Update FV3 hash. Revert .gitmodules
NickSzapiro-NOAA Feb 27, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Merge 'ufs-community/develop' into RT_bmark_gefs
NickSzapiro-NOAA committed Nov 22, 2024
commit bfa47538a27da6e973d9349f9f736c00140e41a8
1 change: 1 addition & 0 deletions NOAHMP-interface/CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -13,6 +13,7 @@ list(APPEND _noahmp_cap_files noahmp/drivers/nuopc/lnd_comp_kind.F90

# CCPP interface
list(APPEND _noahmp_ccpp_files noahmp/drivers/ccpp/noahmpdrv.F90
noahmp/drivers/ccpp/lnd_iau_mod.F90
noahmp/drivers/ccpp/sfc_diff.f
noahmp/drivers/ccpp/machine.F
noahmp/drivers/ccpp/noahmp_tables.f90
8 changes: 3 additions & 5 deletions doc/UsersGuide/source/BuildingAndRunning.rst
Original file line number Diff line number Diff line change
@@ -452,7 +452,7 @@ Running the Model

.. attention::
Although the following discussions are general, users may not be able to execute the script successfully "as is" unless they are on a
`Tier-1 platform <https://github.com/ufs-community/ ufs-weather-model/wiki/Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`__.
:wm-wiki:`Tier-1 platform <Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`.

.. _UsingRegressionTest:

@@ -504,8 +504,7 @@ or (2) create a new file (e.g., ``my_rt.conf``), add the tests, and execute ``./
On NOAA RDHPCS
------------------

On `Tier-1 platforms <https://github.com/ufs-community/ufs-weather-model/wiki
/Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`__, users can run
On :wm-wiki:`Tier-1 platforms <Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`, users can run
regression tests by editing the ``rt.conf`` file and executing:

.. code-block:: console
@@ -733,8 +732,7 @@ operational requirement test. The only difference is that the ``opnReqTest`` scr
The ``tests/opnReqTests`` directory contains
opnReqTest-specific lower-level scripts used to set up run configurations.

On `Tier-1 platforms <https://github.com/ufs-community/ ufs-weather-model/wiki
/Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`_, tests can
On :wm-wiki:`Tier-1 platforms <Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`, tests can
be run by invoking

.. code-block:: console
170 changes: 170 additions & 0 deletions doc/UsersGuide/source/CAPE2020.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,170 @@
.. role:: raw-html(raw)
:format: html

.. _cape-2020:

*********************
July 2020 CAPE Case
*********************

The July 2020 CAPE case is an atmosphere-only forecast run at C48 resolution with 127 vertical levels. It is set to run a 24-hour forecast from 2020-07-23 at 0z using the `FV3_GFS_v16 <https://dtcenter.ucar.edu/GMTB/v7.0.0/sci_doc/_g_f_s_v16_page.html>`_ physics suite and default values from the WM's `default_vars.sh <https://github.com/ufs-community/ufs-weather-model/blob/develop/tests/default_vars.sh>`_ ``export_fv3_v16`` function.

The original July 2020 CAPE case illustrated a shortcoming of the Global Forecast System (GFS) v16 --- low Convective Available Potential Energy (CAPE) predictions during summertime (:cite:t:`SunEtAl2024`). :cite:t:`SunEtAl2024` (2024) used this case study to investigate the low CAPE bias in the GFS and determined that "the GFS simulates smaller surface latent heat flux and larger surface sensible heat flux than the observations" due to "slightly drier-than-observed soil moisture" within the offline Global Data Assimilation System (GDAS) initial conditions used in the study. This resulted in less latent heat and moisture being fed back to the lower levels of the atmosphere and ultimately changed the overall vertical profile of the atmosphere, which lowered CAPE values relative to the older GFS v15.2.

The UFS WM and its subcomponents have undergone signficant changes since the original July 2020 CAPE case study was posted and since :cite:t:`SunEtAl2024`'s experiment, so the current GFS v16 CAPE bias may have shifted. However, users may still wish to run this case and then experiment with different (potentially user-generated) initial conditions, a coupled land surface model (LSM), or other factors to explore elements that improve or worsen CAPE bias. Additionally, :cite:t:`SunEtAl2024`'s findings only apply to this case study, so users may wish to expand their research to include other warm-season cases.

============================================
Obtaining Data for the July 2020 CAPE Case
============================================

.. include:: ./doc-snippets/hsd_data.rst

.. _chgres-data:

User-Generated Data
---------------------

.. attention::

The following instructions apply only to users with access to :term:`HPSS` on :term:`RDHPCS`. In the future, there are plans to expand options for access to raw initial conditions data for other users.

Users who have access to :term:`HPSS` can generate initial conditions (:term:`ICs`) for a particular forecast case (date) and resolution by downloading the raw GFS data and converting it to the appropriate resolution using the the UFS_UTILS ``gdas_init`` utility. ``gdas_init`` pulls the input data required by ``chgres_cube`` from HPSS and then runs the ``chgres_cube`` utility to create coldstart initial conditions for the desired resolution and number of vertical levels. Users who already have access to raw GFS ICs can use just the ``chgres_cube`` utility to perform the conversion on their existing data. Users may wish to refer to the `UFS_UTILS User's Guide <https://noaa-emcufs-utils.readthedocs.io/en/latest/ufs_utils.html>`_ for more information.

.. note::

In order to generate all necessary configuration, data, input, and fix files to run a configuration similar to the July 2020 CAPE case for another date (still C48 resolution), the user first needs to run the base ``ufs_test.sh`` script for the default July 2020 CAPE case as described in :numref:`Section %s <run-2020-cape>`.

To generate coldstart ICs via the UFS_UTILS ``gdas_init``/``chgres_cube`` utilities on an :term:`RDHPCS` with :term:`HPSS` access (e.g., Hera or Jet), the user can run the following commands:

.. code-block:: console

git clone https://github.com/ufs-community/UFS_UTILS.git
cd UFS_UTILS/fix
./link_fixdirs.sh emc <platform>
cd ..
./build_all.sh
cd util/gdas_init

where ``<platform>`` is Hera or Jet.

Then, users will need to edit the ``config`` file to:

* Set paths for data extraction and converted files (``EXTRACT_DIR`` and ``OUTDIR``, respectively)
* Set ``yy/mm/dd/hh`` to desired forecast start time +6 hours
* Set ``CDUMP`` to ``gfs`` to generate GFS ICs
* Set ``LEVS`` to 128
* Set ``EXTRACT_DATA`` to ``yes`` (unless data is already staged in ``EXTRACT_DIR``)
* Set ``CRES_HIRES`` to desired resolution for coldstart files (e.g., ``C192``)

These variables are documented in more detail in the `UFS_UTILS gdas_init documentation <https://noaa-emcufs-utils.readthedocs.io/en/latest/ufs_utils.html#configure-for-your-experiment>`_.

In the machine-specific driver (e.g., ``driver.jet.sh``), users will need to set ``PROJECT_CODE`` to an account that the user can use for submitting batch jobs.

After configuring the utility, users can run the driver script:

.. code-block:: console

./driver.<platform>.sh

These steps will (1) pull raw GFS data from HPSS into ``EXTRACT_DIR`` and then (2) convert the raw data to coldstart ICs (placed in ``OUTDIR/gfs.YYYYMMDD/HH/model_data/atmos/input``). The converted coldstart ICs can then be used as input data for certain UFS WM regression tests (RTs) of corresponding model resolution and configuration (e.g., C48 GFS coldstart data in the ``control_c48.v2.sfc`` RT).

.. note::

Note that since 6/4/24, the ``develop`` branch of UFS_UTILS generates only version 2 (v2) surface (sfc) files via ``gdas_init`` and ``chgres_cube``. Therefore, successful integration of the converted coldstart files has only been achieved using the recently added ``v2.sfc`` WM RTs (see e.g., :wm-repo:`control_c48.v2.sfc <blob/develop/tests/tests/control_c48.v2.sfc>` and PRs :wm-repo:`#2005 <pull/2005>` and :wm-repo:`#1977 <issues/1977>`). Since the v2 surface files are significantly different from the v1 surface file format, the user may need to re-configure the higher resolution test case to ensure that fix files, physics suite, and other input data used are consistent with v2 surface files.

.. _run-cape:

=================================
Running the July 2020 CAPE Case
=================================

This section explains how to run the July 2020 CAPE case described above using the ``ufs_test.sh`` script.

Clone the Repository
--------------------

.. include:: ./doc-snippets/clone_hsd.rst

Machine Configuration
-----------------------

.. include:: ./doc-snippets/hsd_machine_config.rst

.. _cape-config:

Test Configuration
----------------------

The July 2020 CAPE case can be run as-is without adjusting the configuration. Users may also choose to run a similar configuration for a different date or the same July 2020 CAPE case at a higher resolution.

Different Date
^^^^^^^^^^^^^^^^

Users may choose to run a similar UFS WM configuration for different dates with user-generated :term:`ICs` (see :numref:`Section %s <chgres-data>` for instructions on downloading this data from :term:`HPSS`). In this case, users will need to copy the ``gfs*.nc`` and ``sfc*.nc`` files from ``OUTDIR/gfs.YYYYMMDD/HH/model_data/atmos/input`` into the ``INPUT`` directory of a UFS WM run directory. (The run directory is set in ``create_xml.py`` as ``${PTMP}/${USER}/FV3_RT/rt_${pid}`` for HSD cases.) Note that this will only work when the run directory uses ICs of the same resolution.

Additionally, users will need to adjust the model start time in the ``model_configure`` file. For example:

.. code-block::

start_year: 2019
start_month: 06
start_day: 15
start_hour: 06
start_minute: 0
start_second: 0
nhours_fcst: 24
fhrot: 0
...

Different Resolution
^^^^^^^^^^^^^^^^^^^^^^

If users choose to run the July 2020 CAPE case at higher resolutions, they can generate GFS ICs at C192, C384, or C768 resolutions following the instructions :ref:`above <chgres-data>`. However, they will also need to ensure that the experiment configuration files (i.e., ``${UFS_WM}/tests-dev/test_cases/tests/2020_CAPE`` and ``${UFS_WM}/tests-dev/test_cases/exp_conf/2020_CAPE``), input namelist, physics suites, and ``fv3_conf/*.IN`` file are consistent and configured properly for their desired resolution. Configurations at these higher resolutions are untested, and users can expect to do significant troubleshooting to make them work.

When changing resolution, it is recommended that users view the :wm-repo:`control_c192 <blob/develop/tests/tests/control_c192>`, :wm-repo:`control_c384 <blob/develop/tests/tests/control_c384>`, or :wm-repo:`control_c768 <blob/develop/tests/tests/control_c768>` test files as a starting point. Those test files will provide guidance on variable settings and ``model_configure``/input namelist settings. Additionally, users will need to ensure that the ``FV3_RUN`` file (named ``2020_CAPE.IN`` for the 2020_CAPE experiment) points to the correct input data. Users can modify the ``parm/fv3_conf`` files associated with the sample ``control_*`` tests to enable use of v2 surface data (as in the :wm-repo:`control_c48.v2.sfc <blob/develop/tests/tests/control_c48.v2.sfc>` or :wm-repo:`2020_CAPE <blob/develop/tests-dev/test_cases/tests/2020_CAPE>` cases). Any new or modified test file, input namelist, or ``*.IN`` file should be placed in the appropriate directory in ``tests-dev/exp_conf`` so that the files are correctly propagated into the ``tests-dev`` directory when invoking the ``-s`` argument with ``ufs_test.sh``.

.. attention::

Although it is *possible* to adjust the July 2020 CAPE case to run at non-default resolutions, this is unsupported functionality. Users may experiment with the capability but will need to commit to significant troubleshooting/experimentation to run the case at those resolutions.

Baseline Configuration
----------------------

.. include:: ./doc-snippets/hsd_baseline_config.rst

.. _run-2020-cape:

Running Tests
-------------

.. include:: ./doc-snippets/hsd_run_tests.rst

Examples
^^^^^^^^^^

A user with access to the ``epic`` account can run the ``2020_CAPE`` test case with the ``intel`` compiler on an :term:`RDHPCS` where they have access using the following command:

.. code-block:: console

./ufs_test.sh -a epic -s -c -k -r -n "2020_CAPE intel"

Running Multiple Cases
^^^^^^^^^^^^^^^^^^^^^^^^

.. include:: ./doc-snippets/hsd_run_multiple.rst

.. _check-results:

Checking Results
-----------------

.. include:: ./doc-snippets/hsd_check_results.rst

For example, to monitor progress or check results for the ``2020_CAPE_intel`` case, run:

.. code-block:: console

tail -f ${UFS_WM}/tests-dev/run_dir/2020_CAPE_intel/err
tail -f ${UFS_WM}/tests-dev/run_dir/2020_CAPE_intel/out

.. include:: ./doc-snippets/hsd_notes.rst
2 changes: 1 addition & 1 deletion doc/UsersGuide/source/CodeOverview.rst
Original file line number Diff line number Diff line change
@@ -31,7 +31,7 @@ Currently, Level 1 (or Tier-1) platforms for regression testing are:
* Hercules (Intel/GNU compilers)
* AWS Docker container (Intel)

More information is available in the `UFS WM wiki <https://github.com/ufs-community/ufs-weather-model/wiki/Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`__.
More information is available in the :wm-wiki:`UFS WM wiki <Regression-Test-Policy-for-Weather-Model-Platforms-and-Compilers>`.

Level 2-4 Systems
===================
Loading
You are viewing a condensed version of this merge commit. You can view the full changes here.