ufs-v1.0.0

ufs-v1.0.1 release for the Short-Range Weather Application

4 March 2021: Short-Range Weather (SRW) Application v1.0.0

Tag ufs-v1.0.0

Release Notes

A release description is provided here.

Known Bugs

• Input source string

  • The model code incorrectly ignores certain pre-processing fields available in the gfs_data.nc file unless the input source string written out by chgres_cube is set to be an FV3GFS Gaussian nemsio file.
  • Temporary fix:
    • This string can be manually set to “FV3GFS GAUSSIAN NEMSIO FILE” for all input sources (while unsatisfactory, this fix was deemed to be the best option to resolve this issue for the release). These changes can be made in the chgres_cube "write_data.F90" routine near line 1317.

• Reading ice mixing ratio from wrfprs HRRR input files

  • chgres_cube does not read in ice mixing ratio (ice_wat) from wrfprs HRRR files because it does not search for the correct grib2 variable code
  • Temporary fix:
    • One option is to use HRRR wrfnat files instead. Ice mixing ratio is properly read from these files.
    • Code can be modified by changing the string "_1_84" to "_1_82" on lines 2609 and 2619 of UFS_UTILS/sorc/chgres_cube.fd/input_data.F90.

• Radiation wrapper

  • A CCPP-physics submodule issue (#565)
  • A unit conversion bug associated with the calculation of density impacts subsequent calculations of effective radius in Thompson MP that is used in RRTMG, impacting shortwave radiative fluxes.
  • A bug fix has been tested in gfsv16_ccpp global experiments and RRFS experiments. The results show significant impacts on the SW radiative fluxes and subsequently temperature when Thompson MP is used.

• Script to generate workflow (generate_FV3LAM_wflow.sh)

  • The ability of this script to catch errors is limited. If errors go unnoticed, it is possible that subsequent tasks (e.g. make_grid) fail.
    • Example: if the make_grid step fails with an error like
      arcx, arcy 0.0000 0.0000
In bestesg_geo; a nonpositive domain parameter, garcx or garcy
STOP Failure flag returned from get_bestesg
    • Inspect generate_FV3LAM_wflow.log for errors such as
      .../constants.sh: line 8: bc: command not found

• Removal of cron job on Cheyenne

  • The automatic removal of the cron job (used to relaunch the workflow) fails on Cheyenne and it will need to be removed by hand when the cycle has completed.

• On some MacOS and Linux platforms, stack limits may result in errors

  • Users must remove stack limits when running on MacOS by using the command ulimit -S -s unlimited, otherwise there may be runtime errors.
  • These errors can manifest in multiple ways; one example is during the execution of the “orog” program:
    ..
nx = 428
IM= 0 /= grid file nx/2= 214
Set IM = 214
JM= 0 /= grid file ny/2= 129
Set JM = 129
Command terminated abnormally.
0.52 real 0.00 user 0.00 sys
ERROR:
From script: "exregional_make_orog.sh"
...
  • Similarly, on Linux, users should set their stacksize to a large enough value (e.g. 65536, which corresponds to the macOS ulimit -S -s unlimited setting) or to “unlimited”:
    • Bash: ulimit -s unlimited
    • Tcsh: stacksize unlimited

• Loading the Python conda environment on Hera and Jet

  • C-shell users may encounter the following error when loading the Python conda environment on Hera and Jet:
    fi: Command not found
  • Note that this does not impact the conda environment and Python plotting still succeeds

• MYNN diagnostic output

  • A reported bug related to setting the bl_mynn_tkebudget control variable in GFS_typedefs.F90. In particular, the bl_mynn_tkebudget variable is not read in via namelist nor set. This should only affect diagnostic output of the MYNN PBL scheme. See this issue for more details.

Limitations / Disclaimers

• Noah-MP is an experimental land surface model that is still in relatively early stages of testing with the RRFS.
• When changing the MPI decomposition (parameter layout = x,y in the model input namelist input.nml), results are bit-for-bit identical for the RRFS_v1alpha suite at all levels of optimization (production/reproducibility/debug flags). For the GFS v15.2 suite, results are bit-for-bit identical only when using reproducibility or debug flags.
• Users may run into instabilities/warning messages during model integration, including near-CFL “Warn_K” messages, segmentation faults, and/or model failures with some model configurations. These limitations are representative of the developmental state of the application. Potential fixes include Increasing the “n_split” namelist parameter to 5 or 6 or decreasing the “dt_atmos” mamelist parameter.
• The SRW App cannot be run at resolutions lower than 3 km because the required topographic fix files for those resolutions are not available.