Skip to content

Commit

Permalink
minor CAPE 2020 & container updates
Browse files Browse the repository at this point in the history
  • Loading branch information
@gspetro-NOAA
gspetro-NOAA committed Nov 19, 2024
1 parent 1d91c15 commit da5619f
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 16 deletions.
2 changes: 1 addition & 1 deletion doc/UsersGuide/source/CAPE2020.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The July 2020 CAPE case is an atmosphere-only forecast run at C48 resolution wit

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 factors 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.
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
Expand Down
40 changes: 25 additions & 15 deletions doc/UsersGuide/source/HSDcontainer.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -105,19 +105,21 @@ On many NOAA :term:`RDHPCS`, a container named ``ubuntu22.04-intel-wm-dev-hsd-te

.. table:: Locations of Pre-Built Containers

+-----------------+--------------------------------------------------------+
| Machine | File location |
+=================+========================================================+
| Gaea | /gpfs/f5/epic/world-shared/containers |
+-----------------+--------------------------------------------------------+
| Hera | /scratch1/NCEPDEV/nems/role.epic/containers |
+-----------------+--------------------------------------------------------+
| Jet | /mnt/lfs5/HFIP/hfv3gfs/role.epic/containers |
+-----------------+--------------------------------------------------------+
| NOAA Cloud | /contrib/EPIC/containers |
+-----------------+--------------------------------------------------------+
| Orion/Hercules | /work/noaa/epic/role-epic/contrib/containers |
+-----------------+--------------------------------------------------------+
+--------------------+--------------------------------------------------------+
| Machine | File location |
+====================+========================================================+
| Gaea | /gpfs/f5/epic/world-shared/containers |
+--------------------+--------------------------------------------------------+
| Hera | /scratch1/NCEPDEV/nems/role.epic/containers |
+--------------------+--------------------------------------------------------+
| Jet | /mnt/lfs5/HFIP/hfv3gfs/role.epic/containers |
+--------------------+--------------------------------------------------------+
| NOAA Cloud [#fn]_ | /contrib/EPIC/containers |
+--------------------+--------------------------------------------------------+
| Orion/Hercules | /work/noaa/epic/role-epic/contrib/containers |
+--------------------+--------------------------------------------------------+

.. [#fn] The CAPE case can run on the NOAA Cloud ParallelWorks (PW) platforms, but the baroclinic wave case cannot.
Users can simply set an environment variable to point to the container:

Expand All @@ -134,7 +136,7 @@ If users prefer, they may copy the container to their local working directory. F
Other Systems
----------------

On other systems, users can build the Singularity container from a public Docker :term:`container` image or download the ``ubuntu22.04-intel-wm-dev-hsd-test.img`` container from the `UFS Hierarchical Testing Framework (HTF) Data Bucket <https://registry.opendata.aws/noaa-ufs-htf-pds/>`_. Downloading may be faster depending on the download speed on the user's system. However, the container in the data bucket is the ``release/public-v2.0.0`` container rather than an updated ``develop`` branch container.
On other systems, users can build the Singularity container from a public Docker :term:`container` image or download the ``ubuntu22.04-intel-wm-dev-hsd-test.img`` container from the `UFS Hierarchical Testing Framework (HTF) Data Bucket <https://registry.opendata.aws/noaa-ufs-htf-pds/>`_. Downloading may be faster depending on the download speed on the user's system. Note that the container in the data bucket is from the November 20, 2024 ``develop`` branch.

To download from the data bucket, users can run:

Expand Down Expand Up @@ -228,12 +230,13 @@ Run the ``stage-rt.sh`` script with the proper arguments.

.. code-block:: console
./stage-rt.sh -c=<compiler> -m=<mpi_implementation> -i=$img
./stage-rt.sh -c=<compiler> -m=<mpi_implementation> [-p=<platform>] -i=$img
where:

* ``-c`` is the compiler on the user's local machine (e.g., ``intel/2022.1.2``)
* ``-m`` is the :term:`MPI` on the user's local machine (e.g., ``impi/2022.1.2``)
* ``-p`` refers to the local machine/platform (e.g., ``hera``, ``jet``, ``gaea``, ``noaacloud``). Required for Gaea and Jet only.
* ``-i`` is the full path to the container image (e.g., ``$img`` or ``$HSD/ubuntu22.04-intel-wm-dev-hsd-test.img``).

.. note::
Expand All @@ -250,9 +253,16 @@ When this command runs, ``stage-rt.sh`` will print the following message to the
Creating ufs_singularity.intel.lua
Tricking ufs_test.sh file
Updating various files with host paths
Done
Additionally, the user should see the ``ufs-weather-model`` directory in the ``$HSD`` directory (``ls``).

.. note::

Gaea and Jet:
* Gaea uses a different compiler and MPI to run with the container: ``-c=intel-classic/2023.2.0 -m=cray-mpich/8.1.28``
* On Jet, ``cd`` to ``/mnt`` first before navigating to individual user workspaces to use the container.

.. _ConfigureExptC:

Configure the Experiment
Expand Down

0 comments on commit da5619f

Please sign in to comment.