Earth Prediction Innovation Center (EPIC) , through collaboration with our partners or collaborators at NOAA National Weather Service (NWS) Environmental Modeling Center (EMC), NOAA’s Physical Sciences Laboratory, NSF NCAR’s Developmental Testbed Center (DTC), and the University of Michigan, has overseen the release of three test cases as part of a continued effort to enhance the Unified Forecast System (UFS) Hierarchical System Development (HSD) framework. The first HSD release (November 2024) contained the July 2020 Convective Available Potential Energy (CAPE) case (originally developed as a UFS Case Study by the DTC) and baroclinic instability idealized case (developed by Xiaqiong Zhou of NOAA/NWS/EMC). The second HSD release (June 2025) was a collaboration with the NOAA/NWS/EMC/Hurricane Analysis and Forecast System (HAFS) group and focused on the integration of a regional tropical cyclone case. An aquaplanet idealized case was added in February 2026, which was developed in collaboration with NOAA’s PSL. Furthermore, each HSD release also expanded the user documentation and tests-dev framework of the UFS Weather Model (WM). Additional details about each test case can be found below.
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), initial development of HSD within the UFS WM has focused on atmosphere-only configurations (i.e., FV3-only), with the inclusion of model physics provided through the Community Common Physics Package (CCPP).
Users who wish to utilize or contribute to the UFS HSD framework can begin by obtaining the develop version of the UFS WM. It currently features three test cases (see Section III): one based on a realistic UFS Case Study (originally developed by the Developmental Testbed Center (DTC)), and two idealized configurations. Information on how to set-up and run these test cases is available at UFS Weather Model Users Guide: Hierarchical System Development (HSD) Cases. Additionally, users desiring to add their own cases can familiarize themselves with the framework through the documentation, example cases, and tutorial video: UFS Weather Model Test Case Walkthrough, and then check out the “General Guidelines for Adding a Test Case to the UFS HSD Framework” section of the documentation to learn how to contribute directly to the framework.
The UFS HSD documentation provides the outline of a structured framework for testing and development across a range of idealized or user specific weather model configurations. The test cases outlined in the HSD documentation demonstrate a July 2020 CAPE, baroclinic instability wave, and regional tropical cyclone cases. The documentation for these test cases is accompanied by detailed instructions for input data acquisition, machine and model configuration setups, execution, and output validation. In addition, it offers guidance for extending the HSD framework by adding new test cases, with specifications for model compile options, input data, test case specific physics parametrizations, model configuration set up, and test run execution steps. While the HSD documentation remains a work in progress, it serves as the foundational resource for researchers and developers seeking to engage with and contribute to the rapidly evolving HSD capabilities of the UFS WM as well as other UFS applications.
Apart from the documentation, users can post questions or issues in the UFS WM GitHub Discussions or Issues pages to receive additional support.
Earth Prediction Innovation Center (EPIC) , through collaboration with our partners or collaborators at NOAA National Weather Service (NWS) Environmental Modeling Center (EMC), NOAA’s Physical Sciences Laboratory, NSF NCAR’s Developmental Testbed Center (DTC), and the University of Michigan, has overseen the release of three test cases as part of a continued effort to enhance the Unified Forecast System (UFS) Hierarchical System Development (HSD) framework. The first HSD release (November 2024) contained the July 2020 Convective Available Potential Energy (CAPE) case (originally developed as a UFS Case Study by the DTC) and baroclinic instability idealized case (developed by Xiaqiong Zhou of NOAA/NWS/EMC). The second HSD release (June 2025) was a collaboration with the NOAA/NWS/EMC/Hurricane Analysis and Forecast System (HAFS) group and focused on the integration of a regional tropical cyclone case. An aquaplanet idealized case was added in February 2026, which was developed in collaboration with NOAA’s PSL. Furthermore, each HSD release also expanded the user documentation and tests-dev framework of the UFS Weather Model (WM). Additional details about each test case can be found below.



EPIC, through collaboration with our partners or collaborators at NOAA National Weather Service (NWS) Environmental Modeling Center (EMC) and DTC, has overseen the release of three test cases as part of a continued effort to enhance the UFS HSD framework. The first HSD release (November 2024) contained the July 2020 CAPE case (originally developed as a UFS Case Study by the DTC) and baroclinic instability idealized case (developed by Xiaqiong Zhou of NOAA/NWS/EMC). The second HSD release (June 2025) was a collaboration with the NOAA/NWS/EMC/Hurricane Analysis and Forecast System (HAFS) group and focused on the integration of a regional tropical cyclone case. Furthermore, each HSD release also expanded the user documentation and tests-dev framework of the UFS WM. Additional details about each test case can be found below.



The UFS HSD framework is designed to encourage and support model enhancements through contributions not only from NOAA and NOAA-affiliated developers, but also from the broader NWP community. This includes, but is not limited to, researchers in academia and industry, graduate students, and NWP scientists and developers from other agencies and institutions. To facilitate such contributions, EPIC has developed a video tutorial UFS Weather Model Test Case Walkthrough covering two of the current HSD test cases in the UFS WM, and provides regularly updated technical documentation, including a dedicated section General Guidelines for Adding a Test Case to the UFS HSD Framework that guides the new users on how to integrate their code innovations into the UFS HSD framework. Additionally, a comprehensive training is scheduled for UIFCW 2025 and it will be recorded and posted here once available.
Accelerating
innovation
through
community
modeling
Accelerating
innovation
through
community
modeling
The Earth Prediction Innovation Center will enable the most accurate and reliable operational numerical weather prediction system in the world.
© 2025 EPIC. All rights reserved.