ufs-srw-v3.0.0

The Earth Prediction Innovation Center (EPIC) and the Unified Forecast System (UFS) community are proud to announce the public release of the Short-Range Weather (SRW) Application (App) v3.0.0. This release is an update to the v2.2.0 release from October 2023 and reflects a number of changes currently available in the SRW App develop branch. The Application is designed for short-range (up to two days) regional forecasts located anywhere on the globe. The new release includes the following updates:

• Integration of Community Fire Behavior Model, developed by the CFBM group at NSF-NCAR:
  • Enabled fire simulation on a very high-resolution fire modeling grid nested within the atmospheric domain
  • Updated documentation and workflow end-to-end (WE2E) test to reflect the two-way coupling feature
• Integration of Smoke and Dust (SD) Capabilities to the SRW App develop branch
  • Added a new SD WE2E test, a sample configuration YAML file (config.smoke_dust.yaml), and a separate Conda environment (sd_environment.yml)
  • Added the FV3_HRRR_gf physics suite for SD capabilities
  • Ported SD features to all Tier-1 platforms
  • Completed various SD-related script updates and bug fixes
  • Integration of verification options for smoke and dust forecast fields
• Miscellaneous enhancements, including:
  • Physical parameterizations: UFS Weather Model updated with the latest developments in physical parameterizations. Includes the RRFS_sas physics suite for the Rapid Refresh Forecast System (RRFS) v1. RRFS v1 is a high-resolution limited-area NOAA developmental model being proposed for operational implementation at the National Weather Service.
  • Newly added/supported grids: The SUBCONUS_CO_3km (3km grid over Colorado) and SUBCONUS_CO_1km (1km grid over Colorado) predefined grids were created for UFS FIRE but can be used by any experiments
  • Verification (VX): Simplified verification tasks, improved METplus configuration, and added the MET_ensemble_verification_winter_wx test
  • Workflow: Added option to install Miniforge for SRW environments (srw_app, srw_graphics, srw_aqm); replaced Unified Workflow (UW) CLI with API calls in Python scripts.
  • Data: Reorganized S3 data bucket structure for better versioning and data management
  • Graphics: Improved plotting for better visibility and ensemble outputs
  • Testing & CI/CD: Improved Jenkinsfile handling, skill-score metrics, and platform node skipping; added remaining UFS case studies as WE2E tests.
  • Dependencies: Upgraded SRW App to spack-stack 1.6.0
  • Updated UFS Weather Model and component hashes
  • Miscellaneous bug fixes since the SRW App v2.2.0 release, including issues related to verification, CI/CD, cloud instances, and dependencies.
• Documentation updates and enhancements:
  • Documentation for fire and SD capabilities
  • Addition of technical documentation and documentation testing via GitHub Actions
  • New tutorials:
    • Halloween Storm with METplus verification
    • Gulf Coast Blizzard with public data and user-defined grid
• Updated container for the v3.0.0 release

The v3.0.0 User's Guide has been updated to reflect these improvements to the Application, and numerous test cases with all associated data files are also available to the public in the SRW App data bucket. Interested users can get support by submitting a question through the GitHub Discussions Q & A page.

production/AQM.v7.0.8_fix_rave: Enhancement of Fire-Emission Job

A fix of the operational fire emission job failure due to duplicate of RAVE data files

production/AQM.v7.0.8

AQMv7.0.8 aims to support the upgrade of RAVE v2 along with bug fixes for AQM model, bias-correction bull's eye issue and WMO files for hourly average O3.

production/AQM.v7.0.7

This release/tag brings in the latest changes made to the production code delivered to NCO in support of the AQMv7.0 implementation.

production/AQM.v7.0.1

Production AQM v7.0.1

ufs-srw-v2.2.0

The Earth Prediction Innovation Center (EPIC) and the Unified Forecast System (UFS) community are proud to announce the public release of the Short-Range Weather Application (SRW App) version 2.2.0. This release is an update to the version 2.1.0 release from November 2022 and reflects a number of changes currently available in the SRW App develop branch. The Application is designed for short-range (up to two days) regional forecasts located anywhere on the globe. The new release includes the following updates:

• Bug fixes since the v2.1.0 release
• Addition of the supported FV3_RAP physics suite (PR #811) and support for the RRFS_NA_13km predefined grid
• Addition of FV3_GFS_v17_p8 physics suite (PR #574)
• Updates to CCPP that target the top of the main branch (which is ahead of CCPP v6.0.0). View a detailed summary of CCPP updates that came in ahead of the SRW App v2.2.0 release.
• Expansion of Level 1 platforms to include Derecho, Hercules, and Gaea C5 (PRs #894, #898, #911)
• Transition to spack-stack modulefiles for most supported platforms to align with the UFS WM shift to spack-stack (PRs #913 and #941)
• Overhaul of WE2E testing suite (see, e.g., PRs #686, #732, #864, #871)
• Improvements to the CI/CD automated testing pipeline (see, e.g., PRs #707 and #847)
• Incorporation of additional METplus verification capabilities (PRs #552, #614, #757, #853)
• Integration of the Unified Workflow's templater tool (PR #793)
• Ability to create a user-defined custom workflow (PR #676)
• Option to use a custom vertical coordinate file with different distribution of vertical layers (PR #813) and documentation on how to use this feature (PR #888)
• Incorporation of plotting tasks into the workflow (PR #482); addition of ability to plot on both CONUS and smaller regional grid (PR #560)
• Addition of a sample verification case (PR #500) with documentation
• A new tutorial chapter in the documentation (PR #584)
• Incorporation of UFS Case Studies within the WE2E framework (PRs #736 and #822)
• Air Quality Modeling (AQM) capabilities (unsupported but available; see PR #613)
• Miscellaneous documentation updates to reflect the changes above

The v2.2.0 User's Guide has been updated to reflect these improvements to the Application, and numerous test cases with all associated data files are also available to the public in the SRW App data bucket). Interested users can get support by submitting a question through the GitHub Discussions Q & A page.

Known Issues

• The v2.2.0 container does not run on Derecho.
• The path to the container on Derecho should be /glade/work/epicufsrt/contrib/containers

production/AQM.v7.0.0

• Production AQM v7.0.0

ufs-srw-v2.1.0

The Earth Prediction Innovation Center (EPIC) and the Unified Forecast System (UFS) community are proud to announce the public release of the UFS Short-Range Weather (UFS SRW) Application version 2.1.0. This release is an update to the version 2.0.0 release from June 2022 and reflects a number of changes currently available at the head of the UFS SRW development branch. The Application is designed for short-range (up to two days) regional forecasts located anywhere on the globe. The new release includes the following updates:

• Conversion to a Python workflow (from the former shell workflow)
• Improved container support, including the option to run across compute nodes using Rocoto
• Updates to physical parameterizations within the Common Community Physics Package (CCPP) (see detailed description here)
• Support for the Unified Post Processor (UPP) to be run inline
• Addition of a multi-purpose code clean-up script (devclean.sh)
• Improved support for the METplus verification suite

The User's Guide, available here, has been updated to reflect these improvements to the Application, and numerous test cases with all associated data files are also available to the public here. Interested users can get support by submitting a question through the Q&A Category on the ufs-srweather-app GitHub Discussions page.

Known Issues

• When building a PDF of the v2.1.0 documentation locally, an error in the conf.py file causes the subtitle to read "Release v1.0." However, the contents of the documentation are correct for v2.1.0. If users want their PDF to reflect the correct version number, they can change line #30 of ufs-srweather-app/docs/UsersGuide/source/conf.py from release = 'v1.0' to release = 'v2.1.0' and rerun the command to generate the document.

ufs-srw-v2.0.0

24 June 2022: Short-Range Weather (SRW) Application v2.0.0

Release Notes

The UFS Community is proud to announce the public release (version 2.0.0) of the UFS Short-Range Weather Application. This newly updated weather application is designed for short-range (up to two days) regional forecasts located anywhere on the globe. It contains the Common Community Physics Package (CCPP) v6.0.0, version 10.1.0 of the Unified Post Processor (UPP) and version 3.0.0 of the UFS Weather Model. Documentation has been significantly enhanced and numerous test cases with all associated data files are now available to the public. The application is highly portable and detailed instructions describe how to build and run on a wide variety of platforms, including Ubuntu Linux and MacOS.

Documentation: User's Guide v2.0.0

Known Issues

• On MacOS, users must run brew install bash before using brew to upgrade bash. MacOS users also need to run brew install gsed.

• Bash/dash issue: On some systems, .sh points to bin/dash instead of bin/bash. On these systems, users can run sed -i -e 's/bin\/sh/bin\/bash/g' *.sh to resolve the issue.

• On Gaea: The staged data path in regional_workflow/ush/machine/gaea.sh must be updated from ncep to ncep_shared if users do not have access to the ncep directory. To do this, change staged_data_dir to "/lustre/f2/pdata/ncep_shared/UFS_SRW_App/v2p0/".

• When users build the HPC-Stack for use with the SRW App v2.0.0, they should clone the HPC-Stack srw-public-v2 branch as follows:

  git clone -b release/srw-public-v2 https://github.com/NOAA-EMC/hpc-stack.git

• Known WE2E Test Failures: Some failed tests will pass if run a second time individually. The following tests consistently fail:

  Platform	Test	Failure Stage	Error Message	What was done?
  Cheyenne (gnu)	specify_DOT_OR_USCORE	run_fcst	FATAL from PE4: set_group_update: mpp_domains_stack overflow, call mpp_domains_set_stack_size( 3013795) from all PEs.	Increased domains_stack_size in input.nml and the test still crashes
  Jet (Intel)	pregen_grid_orog_sfc_climo	run_fcst	FATAL from PE4: NetCDF: Start+count exceeds dimension bound: netcdf_read_data_2d: file:INPUT/C403_grid.tile7.halo3.nc- variable:x

ufs-v1.0.1

ufs-v1.0.1 release with updated versions of UPP, regional workflow, updated Users Guide.

16 September 2021: Short-Range Weather (SRW) Application v1.0.1

Tag ufs-v1.0.1

Release Notes

A bug fix release for the UFS Short-Range Weather (SRW) Application v1.0.1 was publicly released on 9/16/2021. Bug fixes related to:

• addressing a runtime error that occurs due to an lmod update on Hera (PR #542),
• resolving a filter_topo failure by removing "refine_ratio = ${refine_ratio}" in scripts/exregional_make_orog.sh (PR #547), and
• adding an array index for 'cycle_status' to the launch script (launch_FV3LAM_wflow.sh; PR #513)

are included in this release.

Updated documentation is available and now includes information on running the SRW App release using a Docker container (new Chapter 11).

The authoritative UFS SRW App umbrella repository is located at: https://github.com/ufs-community/ufs-srweather-app.