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]: Add Hercules info to docs #137

Merged
merged 62 commits into from
Aug 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
62 commits
Select commit Hold shift + click to select a range
acce91b
update intro w/code additions since v1.2.0
gspetro-NOAA Jun 14, 2024
332fe05
Merge branch 'develop' of https://github.com/ufs-community/land-DA_wo…
gspetro-NOAA Jun 14, 2024
56b4483
update tech overview dir structure
gspetro-NOAA Jul 2, 2024
c12eb3b
add info on manual vs auto submission
gspetro-NOAA Jul 2, 2024
f2639fd
several misc changes
gspetro-NOAA Jul 5, 2024
4db3bc4
add plotting info
gspetro-NOAA Jul 8, 2024
bf343fa
update plotting info
gspetro-NOAA Jul 8, 2024
9ea7ce7
add plot images, add extlinks, misc other
gspetro-NOAA Jul 9, 2024
e45555a
add Rocoto chapter, misc edits
gspetro-NOAA Jul 10, 2024
02f3246
rm workflow section in DA chapter
gspetro-NOAA Jul 11, 2024
5c8a82d
add misc
gspetro-NOAA Jul 11, 2024
323e795
minor conf.py updates
gspetro-NOAA Jul 11, 2024
a48cfea
add ConfigWorkflow chapter
gspetro-NOAA Jul 11, 2024
071cad1
explain task parameters & configuration
gspetro-NOAA Jul 12, 2024
ddccaf9
update testing ch
gspetro-NOAA Jul 16, 2024
76f3968
update glossary
gspetro-NOAA Jul 16, 2024
786d6fd
add configworkflow chapter
gspetro-NOAA Jul 16, 2024
69ee11b
update file paths & misc in Model ch
gspetro-NOAA Jul 16, 2024
12ccb8b
misc minor update in Model ch
gspetro-NOAA Jul 16, 2024
778ecd5
Update DA ch
gspetro-NOAA Jul 17, 2024
21ae278
Update letkf_land.yaml info
gspetro-NOAA Jul 17, 2024
03692d2
fix broken intersphinx link
gspetro-NOAA Jul 17, 2024
3df81b1
update jedi doc version
gspetro-NOAA Jul 17, 2024
ed9465a
DA ch updates
gspetro-NOAA Jul 17, 2024
065c15e
misc minor edits
gspetro-NOAA Jul 17, 2024
6dcb318
Merge branch 'ufs-community:develop' into text/us-215
gspetro-NOAA Jul 18, 2024
e783edf
update wflow dir structure diagram
gspetro-NOAA Jul 19, 2024
1363c92
Merge branch 'text/us-215' of github.com:gspetro-NOAA/land-DA_workflo…
gspetro-NOAA Jul 19, 2024
fcdbc36
update wflow dir structure diagram
gspetro-NOAA Jul 19, 2024
9e2e891
add new chapters to introduction
gspetro-NOAA Jul 24, 2024
0fa3832
misc minor Intro edits
gspetro-NOAA Jul 24, 2024
422fbe7
misc tech overview edits
gspetro-NOAA Jul 25, 2024
38e4273
misc tech overview updates
gspetro-NOAA Jul 25, 2024
a959756
rm uw from hierarchical repo structure?
gspetro-NOAA Jul 25, 2024
818bbb6
update table 1.1
gspetro-NOAA Jul 25, 2024
8f7b1e5
update L1 Build/Run ch
gspetro-NOAA Jul 25, 2024
bc19c48
L1 Build/Run ch minor/misc updates
gspetro-NOAA Jul 25, 2024
fa4342b
update container chapter
gspetro-NOAA Jul 25, 2024
0544826
misc minor edits
gspetro-NOAA Jul 25, 2024
f885141
ConfigWorkflow updates
gspetro-NOAA Jul 29, 2024
b3f19c0
minor updates to reference chs
gspetro-NOAA Jul 29, 2024
0ebe51b
minor misc fixes
gspetro-NOAA Jul 29, 2024
fa0b8b0
minor misc updates
gspetro-NOAA Jul 30, 2024
f56d91c
update docs w/changes from PR #129
gspetro-NOAA Aug 5, 2024
a9b0bac
update docs w/changes from PR #129
gspetro-NOAA Aug 5, 2024
5671e7b
update docs w/changes from PR #129
gspetro-NOAA Aug 5, 2024
ac1804e
rm mention of 2019 case
gspetro-NOAA Aug 5, 2024
6c5d384
remove ERA5 model input file section
gspetro-NOAA Aug 8, 2024
f689823
rm vector2tile info
gspetro-NOAA Aug 8, 2024
818be75
add info on grid description files to DA chapter/IODA section
gspetro-NOAA Aug 8, 2024
e98cb6e
rm run without rocoto section
gspetro-NOAA Aug 8, 2024
a492e38
update wording re: landdaroot
gspetro-NOAA Aug 8, 2024
418761d
Merge branch 'ufs-community:develop' into text/us-215
gspetro-NOAA Aug 8, 2024
7598604
fix missing ref to run w/o Rocoto section
gspetro-NOAA Aug 12, 2024
595175a
Merge branch 'text/us-215' of github.com:gspetro-NOAA/land-DA_workflo…
gspetro-NOAA Aug 12, 2024
6925995
Merge branch 'ufs-community:develop' into text/us-215
gspetro-NOAA Aug 12, 2024
1cc2d5a
Merge branch 'text/us-215' of github.com:gspetro-NOAA/land-DA_workflo…
gspetro-NOAA Aug 12, 2024
463279c
update executable list
gspetro-NOAA Aug 12, 2024
a32c2b1
update docs w/Hercules info
gspetro-NOAA Aug 13, 2024
f37896f
Merge branch 'ufs-community:develop' into text/us-215
gspetro-NOAA Aug 13, 2024
4f79f35
add Hercules in Build/Run title
gspetro-NOAA Aug 14, 2024
40bdd05
Merge branch 'text/us-215' of github.com:gspetro-NOAA/land-DA_workflo…
gspetro-NOAA Aug 14, 2024
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
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
Loading