5. Hierarchical System Development (HSD) Cases

Hierarchical System Development is the ability to engage in development and testing at multiple levels of complexity in numerical weather prediction (NWP) software (such as the UFS). It typically includes multiple entry points into development (e.g., atmospheric physics, ocean and ice dynamics, or data assimilation for land models and other earth system components), and it can include both operationally relevant and idealized configurations.

Although the UFS Weather Model (WM) can be run in any of several configurations, from a single-component atmospheric model to a fully coupled model with multiple earth system components (e.g., atmosphere, ocean, sea-ice, land, mediator), this chapter documents just a few of the cases designed to support hierarchical system development (HSD) within the UFS. Additionally, it explains how to run cases in a container when users do not have access to NOAA RDHPC systems.

• 5.1. July 2020 CAPE Case
  • 5.1.1. Obtaining Data for the July 2020 CAPE Case
    • 5.1.1.1. User-Generated Data
  • 5.1.2. Running the July 2020 CAPE Case
    • 5.1.2.1. Clone the Repository
    • 5.1.2.2. Machine Configuration
    • 5.1.2.3. Test Configuration
    • 5.1.2.4. Baseline Configuration
    • 5.1.2.5. Running Tests
    • 5.1.2.6. Checking Results
• 5.2. Baroclinic Instability Case
  • 5.2.1. Obtaining Data for HSD Cases
  • 5.2.2. Running the Baroclinic Wave Case
    • 5.2.2.1. Clone the Repository
    • 5.2.2.2. Machine Configuration
    • 5.2.2.3. Test Configuration
    • 5.2.2.4. Baseline Configuration
    • 5.2.2.5. Running Tests
    • 5.2.2.6. Checking Results
• 5.3. Idealized, Regional Tropical Cyclone Case
  • 5.3.1. Obtaining Data for HSD Cases
  • 5.3.2. Running the Idealized Tropical Cyclone Test Case
    • 5.3.2.1. Clone the Repository
    • 5.3.2.2. Machine Configuration
    • 5.3.2.3. Test Configuration
    • 5.3.2.4. Running tests
    • 5.3.2.5. Checking Results
• 5.4. Aquaplanet Test Case
  • 5.4.1. Obtaining Data for HSD Cases
  • 5.4.2. Running the Aquaplanet Case
    • 5.4.2.1. Clone the Repository
    • 5.4.2.2. Machine Configuration
    • 5.4.2.3. Running Tests
    • 5.4.2.4. Running Extended Experiments
    • 5.4.2.5. Checking Results
  • 5.4.3. Plotting Script
    • 5.4.3.1. Customizing the Plotting Script
  • 5.4.4. Advanced: Setting Up the Aquaplanet Experiment from Scratch
    • 5.4.4.1. Create Working Directory (optional)
    • 5.4.4.2. Clone Required Repositories
    • 5.4.4.3. Build UFS Weather Model
    • 5.4.4.4. Build UFS_UTILS
    • 5.4.4.5. Generate Initial Atmospheric Data With UFS_UTILS
    • 5.4.4.6. Create Idealized SST Profile Using Aquaplanet Tools
    • 5.4.4.7. Edit Global Ice Data
    • 5.4.4.8. Edit Monthly Ice Data
    • 5.4.4.9. Edit Sea-Land Mask Data
    • 5.4.4.10. Setup Atmospheric Profiles
    • 5.4.4.11. Setup Surface Profiles
    • 5.4.4.12. Prepare Orography Fields
    • 5.4.4.13. Regenerate Initial Conditions
    • 5.4.4.14. Add Noah-MP Variables to Surface Files
    • 5.4.4.15. Copy Initial Conditions to Run Directory
    • 5.4.4.16. Modify Model Source Code
    • 5.4.4.17. Running the 90-Day Spin-Up
• 5.5. General Guidelines for Adding a Test Case to the UFS HSD Framework
  • 5.5.1. General Steps to Add a Test Case
  • 5.5.2. Model Compile Options
  • 5.5.3. Physics
  • 5.5.4. Input Data
  • 5.5.5. Configuration Files
  • 5.5.6. Fix Files
  • 5.5.7. Running the Test Case
• 5.6. Running UFS WM Idealized Cases in a Container
  • 5.6.1. Prerequisites
    • 5.6.1.1. Install Apptainer
  • 5.6.2. Build the Container
    • 5.6.2.1. Set Environment Variables
    • 5.6.2.2. Build the Container
  • 5.6.3. Get Data
  • 5.6.4. Run the Container
    • 5.6.4.1. Set Up the Container
    • 5.6.4.2. Configure the Experiment
    • 5.6.4.3. Run the Experiment

Currently, users can find information on running the following HSD cases:

• The July 2020 CAPE Case

• The Baroclinic Instability Case

• The Idealized, Regional Tropical Cyclone Case

• The Aquaplanet Case

For a full list of supported WM configurations, view the rt.conf file.

Attention

This chapter is a work in progress. There are a multitude of options for configuring the UFS WM, and this chapter merely details a few supported configurations. It will be expanded over time to include a wide variety of idealized test cases for use in research and testing.