Technical FAQs
Frequently Asked Questions for the Earth Prediction Innovation Center and Unified Forecast System Communities
We plan on supporting major commercial CSPs like Google Cloud, AWS and Microsoft Azure. EPIC will also support Gaea, Hera, Jet, Orion and other non-commercial high-performance computing platforms.
We have a Cloud Cost Estimator tool available at https://epic.noaa.gov/get-involved/user-support/ that is updated frequently to assist in estimating costs. UFS code is otherwise provided free of charge.
We have User Support forums available at https://epic.noaa.gov/internal-forums/.
Information about how to use UFS code can be found at the resources listed below:
UFS Short-Range Weather Application 2.0.0
Release Date: 06/23/2022
Release Description: The SRW Application v2.0.0 includes a prognostic atmospheric model, pre- and post-processing, and a community workflow for running the system end-to-end. These components are documented within this User’s Guide and supported through a community forum (https://forums.ufscommunity.org/). New and improved capabilities for this release include the addition of a verification package (METplus) for both deterministic and ensemble simulations and support for four Stochastically Perturbed Perturbation (SPP) schemes. Future work will expand the capabilities of the application to include data assimilation (DA) and a forecast restart/cycling capability.
Documentation:
- UFS Short-Range Weather App Users Guide v1.0 documentation https://ufs-srweather-app.readthedocs.io/en/ufs-v1.0.0/
UFS Short-Range Weather Application Wiki https://github.com/ufs-community/ufs-srweather-app/wiki
Short-Range Weather (SRW) Application Releaase Notes and Known Bugs https://github.com/ufs-community/ufs-srweather-app/wiki/Release-Notes-and-Known-Bugs
- Earth System Modeling Framework (ESMF) reference documentation v8.0.0 http://www.earthsystemmodeling.org/esmf_releases/public/ESMF_8_0_0/ESMF_refdoc/
- UFS Utilities Documentation v2.0.0 Users Guide (includes all UFS utilities) https://noaa-emcufs-utils.readthedocs.io/en/ufs-v2.0.0/
- UFS Utilities v1.1.0, chgres_cube documentation https://ufs-utils.readthedocs.io/en/ufs-v1.1.0/
- UFS Utilities v1.0.0, chgres_cube documentation https://ufs-utils.readthedocs.io/en/ufs-v1.0.0/
- UFS Community Website https://ufscommunity.org/
- UFS Community Wiki https://github.com/ufs-community/ufs/wiki
- UFS Weather Model Wiki https://github.com/ufs-community/ufs-weather-model/wiki
- NCEPLIBS Wiki https://github.com/NOAA-EMC/NCEPLIBS/wiki
- Release Notes and Known Bugs https://github.com/NOAA-EMC/NCEPLIBS-external/wiki/All-Releases%3A-Release-Notes-and-Known-Bugs
- NCEPLIBS-External Wiki https://github.com/NOAA-EMC/NCEPLIBS-external/wiki
- Release Notes and Known Bugs https://github.com/NOAA-EMC/NCEPLIBS-external/wiki/All-Releases%3A-Release-Notes-and-Known-Bugs
The most recent release is v2.0 and a full list of updates/changes can be found at – https://ufs-weather-model.readthedocs.io/en/ufs-v2.0.0/
Previous releases are available to you, but we recommend using v2 for the latest and greatest features!
UFS Version 1.1.0 Release Users’ Guide https://ufs-weather-model.readthedocs.io/en/ufs-v1.1.0/
- FV3 Documentation for V 1.1.0 https://noaa-emc.github.io/FV3_Dycore_ufs-v1.1.0/html/index.html
- Stochastic Physics Users’ Guide https://stochastic-physics.readthedocs.io/en/ufs-v1.1.0/
UFS Version 1.0.0 Release Users’ Guide https://ufs-weather-model.readthedocs.io/en/ufs-v1.0.0/
- FV3 Documentation for V 1.0.0 https://noaa-emc.github.io/FV3_Dycore_ufs-v1.0.0/html/index.html
- Stochastic Physics Users’ Guide https://stochastic-physics.readthedocs.io/en/ufs-v1.0.0/
UFS Community Website: https://ufscommunity.org/
UFS Weather Model Wiki – https://github.com/ufs-community/ufs-weather-model/wiki
NCEPLIBS Wiki – https://github.com/NOAA-EMC/NCEPLIBS/wiki
NCEPLIBS Release Notes and Known Bugs – https://github.com/NOAA-EMC/NCEPLIBS-external/wiki/All-Releases%3A-Release-Notes-and-Known-Bugs
NCEPLIBS-External Wiki – https://github.com/NOAA-EMC/NCEPLIBS-external/wiki
UPP Version 9.0.0 Users’ Guide https://upp.readthedocs.io/en/upp-v9.0.0/
UPP Version 1.1.0 Users’ Guide https://upp.readthedocs.io/en/ufs-v1.1.0/
UPP Version 1.0.0 Users’ Guide https://upp.readthedocs.io/en/ufs-v1.0.0/
Version 5.0 release (released in 2020 with the SRW App v1)
https://ccpp-techdoc.readthedocs.io/en/v5.0.0/
Version 4.0 release (released in 2019 with the MRW App v1)
Version 5.0 release (released in 2020 with the SRW App v1)
https://dtcenter.ucar.edu/GMTB/v5.0.0/sci_doc/index.html
Version 4.0 release (released in 2019 with the MRW App v1)
https://dtcenter.org/GMTB/v4.0/sci_doc/
Users’ Guides
v1.1.0 (LATEST RELEASE) https://ufs-mrweather-app.readthedocs.io/en/ufs-v1.1.0/
v1.0.0 https://ufs-mrweather-app.readthedocs.io/en/ufs-v1.0.0/
Wiki for the UFS Medium-Range Weather Application
https://github.com/ufs-community/ufs-mrweather-app/wiki
Release Notes and Known Bugs for the Medium Range Weather Application
https://github.com/ufs-community/ufs-mrweather-app/wiki/All-Releases%3A-Release-Notes-and-Known-Bugs
CIME Documentation
v1.1.0 (LATEST RELEASE) http://esmci.github.io/cime/versions/ufs_release_v1.1/html/index.html
v1.0.0 http://esmci.github.io/cime/versions/ufs_release_v1.0/html/index.html
ESMF Manual
http://www.earthsystemmodeling.org/esmf_releases/public/ESMF_8_0_0/ESMF_refdoc/
Other Questions
While UFS application community releases do not currently support outputting satellite fields through the post-processing (UPP) utility, the stand-alone release of UPP can be utilized to output these fields if desired.
Stand-alone release of UPP https://github.com/NOAA-EMC/UPP/releases/tag/upp_v9.0.1
Things to consider when outputting satellite products:
- Not all physics configurations are supported for outputting satellite products.
- For regional runs, ensure the satellite field of view overlaps some part of your domain.
Note: Satellite output capabilities are available in the UFS-SRW develop branch, but are not yet supported to the community – stay tuned!
There are a few possibilities as to why a requested field may not be found in the UPP output.
- The field may be dependent on the model.
- Certain fields are dependent on model configuration, such as physics choices.
- A field may be missing from the model output that is required for outputting the requested field.
If it is suspected that UPP failed (e.g. no UPP output was produced), the best way to diagnose the issue is to consult the UPP log file created during runtime for any errors.
If using the run_upp script for a stand-alone UPP run, this log file, located in the /postprd directory, will be called upp.fHHH.out, where HHH refers to each forecast hour being processed.
For the UFS applications, these log files can be found in the experiment directory under log/run_post_f*.log for SRW or in the run directory for MRW.
UPP output is in standard Grib2 format and can be interpolated to another grid using the 3rd party utility wgrib2. Some basic examples can also be found in the UPP Users Guide.
If the desired variable is already available in the UPP code, then all that would be needed is to add that variable to the postcntrl.xml file and remake the postxconfig-NT.txt file that UPP reads.
postxconfig-NT.txt file https://upp.readthedocs.io/en/upp-v9.0.0/InputsOutputs.html#creating-the-flat-text-file
Please note that some variables may be dependent on model and/or physics used.
If the desired variable is not already available in the UPP code, then it can be added following the instructions for adding a new variable in the UPP users guide.
Add a new variable to UPP output https://upp.readthedocs.io/en/upp-v9.0.0/AddNewVariable.html