Skip to content

Commit

Permalink
[develop]: Add Hercules info to docs (#137)
Browse files Browse the repository at this point in the history
* update intro w/code additions since v1.2.0

* update tech overview dir structure

* add info on manual vs auto submission

* several misc changes

* add plotting info

* update plotting info

* add plot images, add extlinks, misc other

* add Rocoto chapter, misc edits

* rm workflow section in DA chapter

* add misc

* minor conf.py updates

* add ConfigWorkflow chapter

* explain task parameters & configuration

* update testing ch

* update glossary

* add configworkflow chapter

* update file paths & misc in Model ch

* misc minor update in Model ch

* Update DA ch

* Update letkf_land.yaml info

* fix broken intersphinx link

* update jedi doc version

* DA ch updates

* misc minor edits

* update wflow dir structure diagram

* update wflow dir structure diagram

* add new chapters to introduction

* misc minor Intro edits

* misc tech overview edits

* misc tech overview updates

* rm uw from hierarchical repo structure?

* update table 1.1

* update L1 Build/Run ch

* L1 Build/Run ch minor/misc updates

* update container chapter

* misc minor edits

* ConfigWorkflow updates

* minor updates to reference chs

* minor misc fixes

* minor misc updates

* update docs w/changes from PR #129

* update docs w/changes from PR #129

* update docs w/changes from PR #129

* rm mention of 2019 case

* remove ERA5 model input file section

* rm vector2tile info

* add info on grid description files to DA chapter/IODA section

* rm run without rocoto section

* update wording re: landdaroot

* fix missing ref to run w/o Rocoto section

* update executable list

* update docs w/Hercules info

* add Hercules in Build/Run title
  • Loading branch information
gspetro-NOAA authored Aug 14, 2024
1 parent 5904221 commit f7769d6
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 17 deletions.
11 changes: 8 additions & 3 deletions doc/source/BackgroundInfo/TechnicalOverview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -68,17 +68,22 @@ Preconfigured (Level 1) systems for Land DA already have the required external l
- *spack-stack* Installation
- *jedi-bundle* Installation
* - Hera
- intel/2021.5.0 /
- intel/2021.5.0
- impi/2021.5.1
- /scratch1/NCEPDEV/nems/role.epic/spack-stack/spack-stack-1.6.0/envs/unified-env-rocky8/install/modulefiles/Core
- /scratch2/NAGAPE/epic/UFS_Land-DA_Dev/jedi_v7
* - Orion
- intel/2021.9.0 /
- intel/2021.9.0
- impi/2021.9.0
- /work/noaa/epic/role-epic/spack-stack/orion/spack-stack-1.6.0/envs/unified-env-rocky9/install/modulefiles/Core
- /work/noaa/epic/UFS_Land-DA_Dev/jedi_v7_stack1.6
* - Hercules
- intel/2021.9.0
- impi/2021.9.0
- /work/noaa/epic/role-epic/spack-stack/hercules/spack-stack-1.6.0/envs/unified-env/install/modulefiles/Core
- /work2/noaa/epic/UFS_Land-DA_Dev/jedi_v7_hercules
* - Container
- intel-oneapi-compilers/2021.8.0 /
- intel-oneapi-compilers/2021.8.0
- intel-oneapi-mpi/2021.8.0
- /opt/spack-stack/ (inside the container)
- /opt/jedi-bundle (inside the container)
Expand Down
26 changes: 12 additions & 14 deletions doc/source/BuildingRunningTesting/BuildRunLandDA.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _BuildRunLandDA:

************************************
Land DA Workflow (Hera & Orion)
************************************
***************************************
Land DA Workflow (Hera/Orion/Hercules)
***************************************

This chapter provides instructions for building and running basic Land DA cases for the Unified Forecast System (:term:`UFS`) Land DA System using a Jan. 3-4, 2000 00z sample case using :term:`GSWP3` data with the UFS Noah-MP land component.

Expand Down Expand Up @@ -77,8 +77,6 @@ Build the Land DA System
Additionally, the ``exec`` directory will contain the following executables:

* ``apply_incr.exe``
* ``ufsLand.exe``
* ``vector2tile_converter.exe``
* ``tile2tile_converter.exe``
* ``ufs_model``

Expand Down Expand Up @@ -138,15 +136,15 @@ Data

.. _Level1Data:

.. table:: Level 1 RDHPCS Data
.. list-table:: Level 1 RDHPCS Data
:header-rows: 1

+-----------+--------------------------------------------------+
| Platform | Data Location |
+===========+==================================================+
| Hera | /scratch2/NAGAPE/epic/UFS_Land-DA_Dev/inputs |
+-----------+--------------------------------------------------+
| Orion | /work/noaa/epic/UFS_Land-DA_Dev/inputs |
+-----------+--------------------------------------------------+
* - Platform
- Data Location
* - Hera
- /scratch2/NAGAPE/epic/UFS_Land-DA_Dev/inputs
* - Hercules & Orion
- /work/noaa/epic/UFS_Land-DA_Dev/inputs

Users who have difficulty accessing the data on Hera or Orion may download it according to the instructions in :numref:`Section %s <GetDataC>`. Its subdirectories are soft-linked to the ``fix`` directory of ``land-DA_workflow`` by the build script ``sorc/app_build.sh``.

Expand Down Expand Up @@ -316,7 +314,7 @@ where ``YYYYMMDD`` is the cycle date, and ``<model_ver>`` is the model version (
Plotting Results
-----------------

Additionally, in the ``plot`` subdirectory, users will find images depicting the results of the ``analysis`` task for each cycle as a scatter plot (``hofx_oma_YYYMMDD_scatter.png``) and as a histogram (``hofx_oma_YYYYMMDD_histogram.png``).
Additionally, in the ``plot`` subdirectory, users will find images depicting the results of the ``analysis`` task for each cycle as a scatter plot (``hofx_oma_YYYYMMDD_scatter.png``) and as a histogram (``hofx_oma_YYYYMMDD_histogram.png``).

The scatter plot is named OBS-ANA (i.e., Observation Minus Analysis [OMA]), and it depicts a map of snow depth results. Blue points indicate locations where the observed values are less than the analysis values, and red points indicate locations where the observed values are greater than the analysis values. The title lists the mean and standard deviation of the absolute value of the OMA values.

Expand Down

0 comments on commit f7769d6

Please sign in to comment.