diff --git a/doc/source/BackgroundInfo/Introduction.rst b/doc/source/BackgroundInfo/Introduction.rst index 4e09e26f..ebdd5fea 100644 --- a/doc/source/BackgroundInfo/Introduction.rst +++ b/doc/source/BackgroundInfo/Introduction.rst @@ -32,8 +32,8 @@ This User's Guide is organized into four sections: (1) *Background Information*; Background Information ======================== - * This chapter (Introduction) provides background information on the Unified Forecast System (:term:`UFS`) and the NoahMP model. - * :numref:`Chapter %s ` (Technical Overview) outlines prerequisites, user support levels, and directory structure. + * This chapter (Introduction) provides user support information and background information on the Unified Forecast System (:term:`UFS`) and the Noah-MP model. + * :numref:`Chapter %s ` (Technical Overview) outlines prerequisites, supported systems, and directory structure. Building, Running, and Testing the Land DA System =================================================== @@ -45,12 +45,15 @@ Building, Running, and Testing the Land DA System Customizing the Workflow ========================= + * :numref:`Chapter %s: Available Workflow Configuration Parameters ` explains all of the user-configurable options currently available in the workflow configuration file (``land_analysis*.yaml``). * :numref:`Chapter %s: Model ` provides information on input data and configuration parameters in the Noah-MP LSM and its Vector-to-Tile Converter. * :numref:`Chapter %s: DA Framework ` provides information on the DA system, required data, and configuration parameters. Reference =========== + * :numref:`Chapter %s: Rocoto ` provides background information on the Rocoto workflow manager as used in Land DA. + * :numref:`Chapter %s: FAQ ` addresses frequently asked questions. * :numref:`Chapter %s: Glossary ` lists important terms. User Support and Documentation diff --git a/doc/source/Reference/FAQ.rst b/doc/source/Reference/FAQ.rst index 6b6d28fa..89434c08 100644 --- a/doc/source/Reference/FAQ.rst +++ b/doc/source/Reference/FAQ.rst @@ -17,23 +17,23 @@ On platforms that utilize Rocoto workflow software (including Hera and Orion), i .. code-block:: console - rocotostat -w land_analysis.xml -d land_analysis.db - CYCLE TASK JOBID STATE EXIT STATUS TRIES DURATION - ============================================================================= - 200001030000 prepexp 16779414 SUCCEEDED 0 1 11.0 - 200001030000 prepobs 16779415 SUCCEEDED 0 1 0.0 - 200001030000 prepbmat 16779416 SUCCEEDED 0 1 9.0 - 200001030000 runana 16779434 SUCCEEDED 0 1 68.0 - 200001030000 runfcst - DEAD 256 1 2186.0 + $ rocotostat -w land_analysis.xml -d land_analysis.db + CYCLE TASK JOBID STATE EXIT STATUS TRIES DURATION + ======================================================================================= + 200001030000 prep_obs 61746034 SUCCEEDED 0 1 11.0 + 200001030000 pre_anal 61746035 SUCCEEDED 0 1 13.0 + 200001030000 analysis 61746081 SUCCEEDED 0 1 76.0 + 200001030000 post_anal 61746109 SUCCEEDED 0 1 4.0 + 200001030000 plot_stats 61746110 SUCCEEDED 0 1 70.0 + 200001030000 forecast 61746128 DEAD 256 1 - -This means that the dead task has not completed successfully, so the workflow has stopped. Once the issue has been identified and fixed (by referencing the log files), users can re-run the failed task using the ``rocotorewind`` command: -.. COMMENT: Where are the log files actually? +This means that the dead task has not completed successfully, so the workflow has stopped. Once the issue has been identified and fixed (by referencing the log files in ``$LANDDAROOT/ptmp/test/com/output/logs/run_``), users can re-run the failed task using the ``rocotorewind`` command: .. code-block:: console - rocotorewind -w land_analysis.xml -d land_analysis.db -v 10 -c 200001030000 -t runfcst + rocotorewind -w land_analysis.xml -d land_analysis.db -v 10 -c 200001030000 -t forecast where ``-c`` specifies the cycle date (first column of ``rocotostat`` output) and ``-t`` represents the task name (second column of ``rocotostat`` output). After using ``rocotorewind``, the next time ``rocotorun`` is used to