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. Prerequisites
    • 2.2.1.1. Singularity/Apptainer Installation
    • 2.2.1.2. Compiler and MPI Requirements
  • 2.2.2. Download and Stage Input Data
  • 2.2.3. Intel-Based Container Workflow
    • 2.2.3.1. Obtain or Build the Intel-Based Singularity Container
    • 2.2.3.2. Start the Intel Container and Retrieve a Staging Script
    • 2.2.3.3. Generate the Forecast Experiment
    • 2.2.3.4. Configure the Workflow
    • 2.2.3.5. Generate the Workflow
  • 2.2.4. GNU-Based Container Workflow
    • 2.2.4.1. Build the GNU Container from Docker Hub
    • 2.2.4.2. Download the UFS SRW App and Submodules
    • 2.2.4.3. Enter the GNU Container with Platform-Specific Bindings
    • 2.2.4.4. Build SRW Executables and Conda Environments
    • 2.2.4.5. Use Wrapper Scripts and Runtime Environment Files
    • 2.2.4.6. Link Executables to Wrapper Scripts
    • 2.2.4.7. Add Loading Host Modules to the Workflow Modulefile
    • 2.2.4.8. Prepare Configuration Files
    • 2.2.4.9. Generate Workflow
  • 2.2.5. Run the SRW Test Case
  • 2.2.6. Troubleshooting
  • 2.2.7. Appendix
    • 2.2.7.1. Working on the Cloud or HPC Systems
    • 2.2.7.2. Allocating 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.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 (UFS-AQM)
  • 2.8.1. Quick Start Guide (UFS-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.8.4. AQM Use Cases
    • 2.8.4.1. Acquiring Use Case Data
    • 2.8.4.2. Running a Use Case
  • 2.8.5. MELODIES MONET (MM) Evaluation
    • 2.8.5.1. How to Run the MM Evaluation
• 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