Get Code: UFS Weather Model banner image

UFS Weather Model

On This Page:

Welcome

The Unified Forecast System (UFS) is a community-based, coupled, comprehensive Earth modeling system. NOAA’s operational model suite for numerical weather prediction (NWP) is quickly transitioning to the UFS from a number of different modeling systems. The UFS enables research, development, and contribution opportunities within the broader Weather Enterprise (including government, industry, and academia). For more information about the UFS, visit the UFS Portal.

Description

The UFS Weather Model (WM) is a prognostic model that can be used for short- and medium-range research and operational forecasts. It can be run as an atmosphere-only model or as an atmospheric model coupled with one or more additional components, such as a wave or ocean model.

The UFS WM is constantly evolving, and new features are added at a rapid pace. Users can find those features in the develop branch, but documentation may be behind the latest updates. The UFS WM is tagged frequently for public and operational releases. The ufs-srw-v3.0.0 tag of the WM is the most recent public release of the UFS WM, which was released as part of the UFS Short-Range Weather (SRW) Application v3.0.0. This tag represents a snapshot of a continuously evolving system undergoing open development. Key architectural elements of the UFS Weather Model include:

  • The Finite-Volume Cubed-Sphere (FV3) dynamical core – the computational part of the atmospheric model that solves the equations of fluid motion.
  • The Flexible Modeling System (FMS) – a software framework for supporting the efficient development, construction, execution, and scientific interpretation of atmospheric, oceanic, and climate system models. It is used for functions such as parallelization. 
  • The Common Community Physics Package (CCPP) – a framework and library of physics schemes that support interoperable atmospheric physics (i.e., numerical methods approximating the effects of small-scale processes such as clouds, turbulence, radiation, and their interactions). 
  • Stochastic Physics schemes – apply randomized perturbations to the physical tendencies, or physical parameters, of a model in order to compensate for model uncertainty. 

The Weather Model is currently used in NOAA’s operational Global Forecast System (GFS). Additionally, the UFS Short-Range Weather (SRW) Application uses the Weather Model in its v3.0.0 public release (April 2025).

Getting Started

Before running the UFS Weather Model, users should determine which of the four levels of support is applicable to their system. Generally, Level 1 & 2 systems are restricted to those with access through NOAA and its affiliates. These systems are named (e.g., Hera, Orion, Derecho). However, most users can take advantage of containers to operate the UFS WM on any system.

The Getting Started section of the UFS WM wiki is a good place for new users on Level 1 systems to begin. It provides details on how to clone the UFS Weather Model and run a regression test (RT). Users on other systems may also find it useful with some modification. The Building and Running chapter in the User’s Guide provides additional detail on RT test scripts and other relevant information. 

Documentation & User Support

The UFS Weather Model User’s Guide has the most comprehensive information on the UFS Weather Model, including links to more thorough technical documentation for its components. Users may need different versions of the User’s Guide (UG) depending on their goals:

Version

Description

The UFS WM documentation for the head of the develop branch. This may have gaps and errors. 

The UFS WM documentation for the most recent SRW App release (v3.0.0).

The UFS WM documentation for the most recent SRW App release (v2.2.0).

The UFS WM documentation for the SRW App v2.1.0 release. 

Developer Support

  • Some supported configurations of the WM are documented in the Configurations chapter of the User’s Guide. The full list of tested configurations is listed in the WM’s rt.conf file, which contains all regression tests (RTs). 
  • The User’s Guide includes information on building and running the WM, including information on the use of RT scripts. 
  • The WM Wiki contains developer information, including information on supported platforms, regression testing policies & procedures, and tutorials. It also contains a diagram of the repository’s Hierarchical Repository Structure and sections for new users.
  • The Debugging Guide is a general guide to debugging Earth System Modeling software.

Releases

The UFS Weather Model is typically released as part of a UFS application, rather than in standalone mode. The ufs-srw-v3.0.0 tag of the WM  is the most recent public release of the UFS WM, which was released as part of the UFS SRW Application v3.0.0.

Release Date: Placeholder

Release Description:Placeholder

Known Issues:

  • Placeholder

Documentation:

Release Date: Placeholder

Release Description:Placeholder

Known Issues:

  • Placeholder

Documentation: