UFS Short-Range Weather App Users Guide

• 1. Background Information
  • 1.1. Introduction
    • 1.1.1. User’s Guide Organization
    • 1.1.2. SRW App Documentation Conventions
    • 1.1.3. Component Documentation
    • 1.1.4. User Support and Contributions to Development
    • 1.1.5. Future Direction
  • 1.2. Technical Overview
    • 1.2.1. Prerequisites for Using the SRW Application
    • 1.2.2. Code Repositories and Directory Structure
  • 1.3. SRW Application Components
    • 1.3.1. UFS Preprocessing Utilities (UFS_UTILS)
    • 1.3.2. Forecast Model
    • 1.3.3. Unified Post Processor (UPP)
    • 1.3.4. METplus Verification Suite
    • 1.3.5. Air Quality Modeling (AQM) Utilities
    • 1.3.6. NOAA Emission and eXchange Unified System (NEXUS)
    • 1.3.7. Unified Workflow Tools
    • 1.3.8. Build System and Workflow
• 2. Building, Running, and Testing the SRW App
  • 2.1. Quick Start Guide
    • 2.1.1. Install the HPC-Stack
    • 2.1.2. Building and Running the UFS SRW Application
  • 2.2. Container-Based Quick Start Guide
    • 2.2.1. Download the Container
    • 2.2.2. Download and Stage the Data
    • 2.2.3. Generate the Forecast Experiment
    • 2.2.4. New Experiment
  • 2.3. Building the SRW App
    • 2.3.1. Install the Prerequisite Software Stack
    • 2.3.2. Download the UFS SRW Application Code
    • 2.3.3. Check Out External Components
    • 2.3.4. Set Up the Environment and Build the Executables
    • 2.3.5. Run an Experiment
  • 2.4. Running the SRW App
    • 2.4.1. Download and Stage the Data
    • 2.4.2. Grid Configuration
    • 2.4.3. Generate the Forecast Experiment
    • 2.4.4. Run the Workflow
  • 2.5. Testing the SRW App
    • 2.5.1. WE2E Test Categories
    • 2.5.2. Running the WE2E Tests
    • 2.5.3. Checking Test Status and Summary
    • 2.5.4. WE2E Test Information File
    • 2.5.5. Modifying the WE2E System
  • 2.6. Tutorials
    • 2.6.1. Sample Forecast #1: Severe Weather Over Indianapolis
    • 2.6.2. Sample Forecast #2: Cold Air Damming
    • 2.6.3. Sample Forecast #3: Southern Plains Winter Weather Event
    • 2.6.4. Sample Forecast #4: Halloween Storm
    • 2.6.5. Sample Forecast #5: Hurricane Barry
  • 2.7. METplus Verification Sample Cases
    • 2.7.1. Introduction
    • 2.7.2. Prerequisites
    • 2.7.3. Indianapolis Severe Weather Case
  • 2.8. Air Quality Modeling (SRW-AQM)
    • 2.8.1. Quick Start Guide (SRW-AQM)
    • 2.8.2. Additional Tasks for AQM
    • 2.8.3. WE2E Test for AQM
• 3. Customizing the Workflow
  • 3.1. Workflow Parameters: Configuring the Workflow in config.yaml and config_defaults.yaml
    • 3.1.1. USER Configuration Parameters
    • 3.1.2. PLATFORM Configuration Parameters
    • 3.1.3. WORKFLOW Configuration Parameters
    • 3.1.4. NCO-Specific Variables
    • 3.1.5. MAKE_GRID Configuration Parameters
    • 3.1.6. MAKE_OROG Configuration Parameters
    • 3.1.7. MAKE_SFC_CLIMO Configuration Parameters
    • 3.1.8. GET_EXTRN_ICS Configuration Parameters
    • 3.1.9. GET_EXTRN_LBCS Configuration Parameters
    • 3.1.10. MAKE_ICS Configuration Parameters
    • 3.1.11. MAKE_LBCS Configuration Parameters
    • 3.1.12. FORECAST Configuration Parameters
    • 3.1.13. RUN_POST Configuration Parameters
    • 3.1.14. RUN_PRDGEN Configuration Parameters
    • 3.1.15. PLOT_ALLVARS Configuration Parameters
    • 3.1.16. Global Configuration Parameters
  • 3.2. Input and Output Files
    • 3.2.1. Input Files
    • 3.2.2. Output Files
    • 3.2.3. Downloading and Staging Input Data
  • 3.3. Limited Area Model (LAM) Grids: Predefined and User-Generated Options
    • 3.3.1. Predefined Grids
    • 3.3.2. Creating User-Generated Grids
    • 3.3.3. Changing the Number of Vertical Levels
  • 3.4. Defining an SRW App Workflow
    • 3.4.1. The Jinja2 Template
    • 3.4.2. The rocoto section of config.yaml
    • 3.4.3. The tasks Subsection
    • 3.4.4. Defining a Task
    • 3.4.5. Defining Dependencies
    • 3.4.6. Defining a Metatask
    • 3.4.7. SRW-Defined Jinja2 Filters Used by YAML Interface
    • 3.4.8. SRW-Defined PyYAML Constructors Used by YAML Interface
    • 3.4.9. Order of Precedence
  • 3.5. Template Variables
    • 3.5.1. Generic Example
    • 3.5.2. Graphics Plotting Example
• 4. Reference
  • 4.1. Rocoto Introductory Information
    • 4.1.1. rocotorun
    • 4.1.2. rocotostat
    • 4.1.3. rocotocheck
    • 4.1.4. rocotorewind
    • 4.1.5. rocotoboot
  • 4.2. FAQ
    • 4.2.1. How do I define an experiment name?
    • 4.2.2. How do I change the Physics Suite Definition File (SDF)?
    • 4.2.3. How do I change the grid?
    • 4.2.4. How can I select which workflow tasks to run?
    • 4.2.5. How do I turn on/off the cycle-independent workflow tasks?
    • 4.2.6. How do I restart a DEAD task?
    • 4.2.7. How can I clean up the SRW App code if something went wrong?
    • 4.2.8. How can I run a new experiment?
    • 4.2.9. How can I add a physics scheme (e.g., YSU PBL) to the UFS SRW App?
    • 4.2.10. How can I troubleshoot issues related to ICS/LBCS generation for a predefined 3-km grid?
  • 4.3. Glossary