2. Building, Running, and Testing the SRW App

• 2.1. Quick Start Guide
  • 2.1.1. Install the Prerequisite Software 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.1.1. Prerequisites
    • 2.2.1.2. Working in the Cloud or on HPC Systems
    • 2.2.1.3. Build the Container
    • 2.2.1.4. Start Up the Container
  • 2.2.2. Download and Stage the Data
  • 2.2.3. Generate the Forecast Experiment
    • 2.2.3.1. Stage the Container
    • 2.2.3.2. Configure the Workflow
    • 2.2.3.3. Generate the Workflow
    • 2.2.3.4. Troubleshooting
  • 2.2.4. New Experiment
  • 2.2.5. Appendix
    • 2.2.5.1. Sample Commands for Working in the Cloud or on HPC Systems
    • 2.2.5.2. Allocate a Compute Node
• 2.3. Building the SRW App
  • 2.3.1. Install the Prerequisite Software Stack
    • 2.3.1.1. Background
    • 2.3.1.2. Instructions
  • 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.4.1. devbuild.sh Approach
    • 2.3.4.2. CMake Approach
    • 2.3.4.3. Additional Details for Building on MacOS or Generic Linux
  • 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.3.1. Load the Conda/Python Environment
    • 2.4.3.2. Set Experiment Configuration Parameters
    • 2.4.3.3. Generate the SRW App Workflow
    • 2.4.3.4. Description of Workflow Tasks
  • 2.4.4. Run the Workflow
    • 2.4.4.1. Run the Workflow Using Rocoto
    • 2.4.4.2. Run the Workflow Using Stand-Alone Scripts
• 2.5. Testing the SRW App
  • 2.5.1. Introduction to Workflow End-to-End (WE2E) Tests
    • 2.5.1.1. What is a WE2E test?
    • 2.5.1.2. WE2E Test Categories
    • 2.5.1.3. WE2E Test Information File
  • 2.5.2. Running the WE2E Tests
    • 2.5.2.1. About the Test Script (run_WE2E_tests.py)
    • 2.5.2.2. Using the Test Script
    • 2.5.2.3. Checking Test Status and Summary
  • 2.5.3. Modifying the WE2E System
    • 2.5.3.1. Modifying an Existing Test
    • 2.5.3.2. Adding a New Test
• 2.6. Tutorials
  • 2.6.1. Sample Forecast #1: Severe Weather Over Indianapolis
    • 2.6.1.1. Weather Summary
    • 2.6.1.2. Data
    • 2.6.1.3. Load the Workflow
    • 2.6.1.4. Configuration
    • 2.6.1.5. Compare and Analyze Results
    • 2.6.1.6. Try It!
  • 2.6.2. Sample Forecast #2: Cold Air Damming
    • 2.6.2.1. Weather Summary
    • 2.6.2.2. Tutorial Content
  • 2.6.3. Sample Forecast #3: Southern Plains Winter Weather Event
    • 2.6.3.1. Weather Summary
    • 2.6.3.2. Tutorial Content
  • 2.6.4. Sample Forecast #4: Halloween Storm
    • 2.6.4.1. Weather Summary
    • 2.6.4.2. Data
    • 2.6.4.3. Load the workflow
    • 2.6.4.4. Configuration
    • 2.6.4.5. How to Analyze Results
    • 2.6.4.6. Set Up Verification
    • 2.6.4.7. Compare
    • 2.6.4.8. Temperature
    • 2.6.4.9. Dew Point
  • 2.6.5. Sample Forecast #5: Hurricane Barry
    • 2.6.5.1. Weather Summary
    • 2.6.5.2. Tutorial Content
  • 2.6.6. Sample Forecast #6: Choose Your Own Adventure!
    • 2.6.6.1. Weather Summary
    • 2.6.6.2. Preliminary Steps
    • 2.6.6.3. Data
    • 2.6.6.4. Download the SRW App
    • 2.6.6.5. Create a Regional Grid
    • 2.6.6.6. Load the Workflow
    • 2.6.6.7. Configuration
    • 2.6.6.8. Analyze Results
    • 2.6.6.9. How Did We Do?
    • 2.6.6.10. Improving the Forecast
• 2.7. METplus Verification Sample Cases
  • 2.7.1. Introduction
  • 2.7.2. Prerequisites
  • 2.7.3. Indianapolis Severe Weather Case
    • 2.7.3.1. Description
    • 2.7.3.2. Set Up Verification
    • 2.7.3.3. Compare
• 2.8. Air Quality Modeling (SRW-AQM)
  • 2.8.1. Quick Start Guide (SRW-AQM)
    • 2.8.1.1. Download the Code
    • 2.8.1.2. Checkout Externals
    • 2.8.1.3. Build the SRW App with AQM
    • 2.8.1.4. Load the srw_app Environment
    • 2.8.1.5. Configure and Experiment
    • 2.8.1.6. Generate the Workflow
    • 2.8.1.7. Run the Workflow
    • 2.8.1.8. Experiment Output
  • 2.8.2. Additional Tasks for AQM
    • 2.8.2.1. Structure of SRW-AQM Workflow
    • 2.8.2.2. Pre-processing Tasks of SRW-AQM
    • 2.8.2.3. Post-processing Tasks of SRW-AQM
  • 2.8.3. WE2E Test for AQM
• 2.9. SRW Smoke & Dust (SRW-SD) Features
  • 2.9.1. Quick Start Guide (SRW-SD)
    • 2.9.1.1. Build the SRW & Load the srw_app Environment
    • 2.9.1.2. Configure an Experiment
    • 2.9.1.3. Predefined Grid Support in SRW-SD
    • 2.9.1.4. Additional SRW-SD Tasks
    • 2.9.1.5. Generate and Run the Workflow
    • 2.9.1.6. Experiment Output
• 2.10. Community Fire Behavior Module (UFS FIRE)
  • 2.10.1. Quick Start Guide (UFS FIRE)
    • 2.10.1.1. Download the Code
    • 2.10.1.2. Checkout Externals
    • 2.10.1.3. Build the SRW App with Fire Behavior Enabled
    • 2.10.1.4. Load the srw_app Environment
    • 2.10.1.5. Configure Experiment
    • 2.10.1.6. Additional boundary conditions file
    • 2.10.1.7. Specifying a fire ignition
    • 2.10.1.8. Example fire configuration
    • 2.10.1.9. Generate the Workflow
    • 2.10.1.10. Run the Workflow
    • 2.10.1.11. Experiment Output
  • 2.10.2. WE2E Tests for FIRE