UFS Short-Range Weather App Users Guide

• 1. Introduction
  • 1.1. How to Use This Document
  • 1.2. Prerequisites for Using the SRW Application
    • 1.2.1. Background Knowledge Prerequisites
    • 1.2.2. Software/Operating System Requirements
  • 1.3. SRW App Components Overview
    • 1.3.1. Pre-Processor Utilities and Initial Conditions
    • 1.3.2. Forecast Model
    • 1.3.3. Unified Post-Processor (UPP)
    • 1.3.4. METplus Verification Suite
    • 1.3.5. Visualization Example
    • 1.3.6. Build System and Workflow
  • 1.4. Code Repositories and Directory Structure
    • 1.4.1. Hierarchical Repository Structure
    • 1.4.2. Directory Structure
    • 1.4.3. Experiment Directory Structure
  • 1.5. User Support, Documentation, and Contributions to Development
  • 1.6. Future Direction
• 2. Quick Start Guide
  • 2.1. Install the HPC-Stack
  • 2.2. Building and Running the UFS SRW Application
• 3. Container-Based Quick Start Guide
  • 3.1. Download the Container
    • 3.1.1. Prerequisites:
    • 3.1.2. Working in the Cloud or on HPC Systems
    • 3.1.3. Build the Container
    • 3.1.4. Allocate a Compute Node
    • 3.1.5. Start Up the Container
  • 3.2. Download and Stage the Data
  • 3.3. Generate the Forecast Experiment
    • 3.3.1. Activate the Regional Workflow
    • 3.3.2. Configure the Workflow
    • 3.3.3. Generate the Workflow
    • 3.3.4. Troubleshooting
  • 3.4. New Experiment
  • 3.5. Plot the Output
• 4. Building the SRW App
  • 4.1. Install the Prerequisite Software Stack
    • 4.1.1. Background
    • 4.1.2. Instructions
  • 4.2. Download the UFS SRW Application Code
  • 4.3. Check Out External Components
  • 4.4. Set Up the Environment and Build the Executables
    • 4.4.1. devbuild.sh Approach
    • 4.4.2. CMake Approach
    • 4.4.3. Additional Details for Building on MacOS or Generic Linux
  • 4.5. Run an Experiment
• 5. Running the SRW App
  • 5.1. Download and Stage the Data
  • 5.2. Grid Configuration
  • 5.3. Generate the Forecast Experiment
    • 5.3.1. Load the Conda Environment for the Regional Workflow
    • 5.3.2. Set Experiment Configuration Parameters
    • 5.3.3. Generate the Regional Workflow
    • 5.3.4. Description of Workflow Tasks
  • 5.4. Run the Workflow
    • 5.4.1. Run the Workflow Using Rocoto
    • 5.4.2. Run the Workflow Using Stand-Alone Scripts
  • 5.5. Plot the Output
• 6. SRW Application Components
  • 6.1. Pre-processor Utilities and Initial Conditions
  • 6.2. Forecast Model
  • 6.3. Post-processor
  • 6.4. METplus Verification Suite
  • 6.5. Visualization Example
  • 6.6. Build System and Workflow
• 7. Input and Output Files
  • 7.1. Input Files
    • 7.1.1. Initial and Boundary Condition Files
    • 7.1.2. Pre-processing (UFS_UTILS)
    • 7.1.3. UFS Weather Model
    • 7.1.4. Unified Post Processor (UPP)
    • 7.1.5. Workflow
  • 7.2. Output Files
    • 7.2.1. Initial and boundary condition files
    • 7.2.2. Pre-processing (UFS_UTILS)
    • 7.2.3. UFS Weather Model
    • 7.2.4. Unified Post Processor (UPP)
  • 7.3. Downloading and Staging Input Data
    • 7.3.1. Static Files
    • 7.3.2. Initial Condition/Lateral Boundary Condition File Formats and Source
    • 7.3.3. Initial and Lateral Boundary Condition Organization
    • 7.3.4. Default Initial and Lateral Boundary Conditions
    • 7.3.5. Running the App for Different Dates
    • 7.3.6. Staging Initial Conditions Manually
    • 7.3.7. Coexistence of Multiple Files for the Same Date
    • 7.3.8. Best Practices for Conserving Disk Space and Keeping Files Safe
• 8. Limited Area Model (LAM) Grids: Predefined and User-Generated Options
  • 8.1. Predefined Grids
    • 8.1.1. Predefined 3-km CONUS Grid
    • 8.1.2. Predefined SUBCONUS Grid Over Indianapolis
    • 8.1.3. Predefined 13-km Grid
    • 8.1.4. Predefined 25-km Grid
  • 8.2. Creating User-Generated Grids
    • 8.2.1. Code Example
• 9. Workflow Parameters: Configuring the Workflow in config.yaml and config_defaults.yaml
  • 9.1. USER Configuration Parameters
  • 9.2. PLATFORM Configuration Parameters
    • 9.2.1. Machine-Dependent Parameters
    • 9.2.2. Parameters for Running Without a Workflow Manager
    • 9.2.3. METplus Parameters
    • 9.2.4. Test Directories
  • 9.3. WORKFLOW Configuration Parameters
    • 9.3.1. Cron-Associated Parameters
    • 9.3.2. Directory Parameters
    • 9.3.3. Pre-Processing File Separator Parameters
    • 9.3.4. Set File Name Parameters
    • 9.3.5. CCPP Parameter
    • 9.3.6. Grid Generation Parameters
    • 9.3.7. Forecast Parameters
    • 9.3.8. Pre-Existing Directory Parameter
    • 9.3.9. Verbose Parameter
    • 9.3.10. Debug Parameter
    • 9.3.11. Compiler
    • 9.3.12. Verification Parameters
  • 9.4. NCO-Specific Variables
  • 9.5. WORKFLOW SWITCHES Configuration Parameters
    • 9.5.1. Baseline Workflow Tasks
    • 9.5.2. Verification Tasks
  • 9.6. MAKE_GRID Configuration Parameters
    • 9.6.1. Basic Task Parameters
    • 9.6.2. ESGgrid Settings
    • 9.6.3. GFDLgrid Settings
  • 9.7. MAKE_OROG Configuration Parameters
  • 9.8. MAKE_SFC_CLIMO Configuration Parameters
  • 9.9. GET_EXTRN_ICS Configuration Parameters
    • 9.9.1. Basic Task Parameters
    • 9.9.2. File and Directory Parameters
    • 9.9.3. NOMADS Parameters
  • 9.10. GET_EXTRN_LBCS Configuration Parameters
    • 9.10.1. Basic Task Parameters
    • 9.10.2. File and Directory Parameters
    • 9.10.3. NOMADS Parameters
  • 9.11. MAKE_ICS Configuration Parameters
    • 9.11.1. Basic Task Parameters
    • 9.11.2. FVCOM Parameter
  • 9.12. MAKE_LBCS Configuration Parameters
  • 9.13. FORECAST Configuration Parameters
    • 9.13.1. Basic Task Parameters
    • 9.13.2. Model Configuration Parameters
    • 9.13.3. Computational Parameters
    • 9.13.4. Write-Component (Quilting) Parameters
    • 9.13.5. Predefined Grid Parameters
    • 9.13.6. Aerosol Climatology Parameter
    • 9.13.7. Fixed File Parameters
  • 9.14. RUN_POST Configuration Parameters
    • 9.14.1. Basic Task Parameters
    • 9.14.2. Subhourly Post Parameters
    • 9.14.3. Customized Post Configuration Parameters
  • 9.15. GET_OBS_CCPA Configuration Parameters
  • 9.16. GET_OBS_MRMS Configuration Parameters
  • 9.17. GET_OBS_NDAS Configuration Parameters
  • 9.18. VX_GRIDSTAT Configuration Parameters
  • 9.19. VX_GRIDSTAT_REFC Configuration Parameters
  • 9.20. VX_GRIDSTAT_RETOP Configuration Parameters
  • 9.21. VX_GRIDSTAT_03h Configuration Parameters
  • 9.22. VX_GRIDSTAT_06h Configuration Parameters
  • 9.23. VX_GRIDSTAT_24h Configuration Parameters
  • 9.24. VX_POINTSTAT Configuration Parameters
  • 9.25. VX_ENSGRID Configuration Parameters
  • 9.26. VX_ENSGRID_REFC Configuration Parameters
  • 9.27. VX_ENSGRID_MEAN Configuration Parameters
  • 9.28. VX_ENSGRID_MEAN_03h Configuration Parameters
  • 9.29. VX_ENSGRID_MEAN_06h Configuration Parameters
  • 9.30. VX_ENSGRID_MEAN_24h Configuration Parameters
  • 9.31. VX_ENSGRID_PROB Configuration Parameters
  • 9.32. VX_ENSGRID_PROB_03h Configuration Parameters
  • 9.33. VX_ENSGRID_PROB_06h Configuration Parameters
  • 9.34. VX_ENSGRID_PROB_24h Configuration Parameters
  • 9.35. VX_ENSPOINT Configuration Parameters
  • 9.36. VX_ENSPOINT_MEAN Configuration Parameters
  • 9.37. VX_ENSPOINT_PROB Configuration Parameters
  • 9.38. Global Configuration Parameters
    • 9.38.1. Community Radiative Transfer Model (CRTM) Parameters
    • 9.38.2. Ensemble Model Parameters
    • 9.38.3. Stochastic Physics Parameters
    • 9.38.4. Halo Blend Parameter
• 10. Rocoto Introductory Information
  • 10.1. rocotorun
  • 10.2. rocotostat
  • 10.3. rocotocheck
  • 10.4. rocotorewind
  • 10.5. rocotoboot
• 11. Workflow End-to-End (WE2E) Tests
  • 11.1. Supported Tests
  • 11.2. Running the WE2E Tests
  • 11.3. The WE2E Test Information File
  • 11.4. Checking Test Status
  • 11.5. Modifying the WE2E System
    • 11.5.1. Modifying an Existing Test
    • 11.5.2. Adding a New Test
    • 11.5.3. Adding a New WE2E Test Category
    • 11.5.4. Creating Alternate Names for a Test
• 12. Graphics Generation
  • 12.1. Loading the Environment
  • 12.2. Cartopy Shapefiles
  • 12.3. Running the Plotting Scripts
    • 12.3.1. Plotting Output from One Experiment
    • 12.3.2. Plotting Differences from Two Experiments
  • 12.4. Submitting Plotting Scripts Through a Batch System
• 13. FAQ
  • 13.1. How do I define an experiment name?
  • 13.2. How do I change the Physics Suite Definition File (SDF)?
  • 13.3. How do I change the grid?
  • 13.4. How do I turn on/off the cycle-independent workflow tasks?
  • 13.5. How do I know if I correctly modified config.yaml?
  • 13.6. How do I restart a DEAD task?
  • 13.7. How can I clean up the SRW App code if something went wrong?
  • 13.8. How can I run a new experiment?
• 14. Glossary