Version 1.13.0

We are pleased to announce the release of version 1.13.0 of UFS_UTILS.

The UFS_UTILS project contains utilities for the NCEP models.

Highlights In This Release:

• Update directory variables to be consistent with the global workflow. (See #897).
• global_cycle - Remove fractional grid check on adding land increments. (See #895).
• chgres_cube - Update to recognize WMO template for rotated lat/lon grids. (See #901).
• orog - Update to read UMD mask, GMTED2010 and RAMP topography in NetCDF. (See #786).
• Add support for IPLIB version 5. (See #910).
• gdas_init utility - Bug fix. Point to correct input grid orography directory. Required when using v15/GDAS and v16 retro/GDAS data. (See #908).

The full list of changes can be found at: https://github.com/ufs-community/UFS_UTILS/projects/16

Complete documentation can be found at https://ufs-community.github.io/UFS_UTILS/ver-1.13.0/index.html

And here: https://noaa-emcufs-utils.readthedocs.io/en/ufs_utils_1_13_0/

Version 1.12.0

We are pleased to announce the release of version 1.12.0 of UFS_UTILS.

The UFS_UTILS project contains utilities for the NCEP models.

Highlights In This Release:

• cpld_gridgen program - The ESMF weights used to remap the tripole ocean and ice output to rectilinear grids were fixed to properly remap the tripole seam region. (See #857 and #864).
• chgres_cube program
  • Minor code updates to allow compilation with GNU v10 without the "-fallow-argument-mismatch" compiler flag. (See #471).
• Use new spack-stack based library suite on Hera, Jet, S4 and Orion. (See #859, #875 and #884).
• Port to Hercules. (See #878).
• Updates needed to use version 202310127 of the orography 'fixed' files. (See #867).
• Update grid generation process for coupled grids (See #825) and to prevent coastal lakes. (See #854).
• global_cycle program
  • Update the GSI land increment file name to append the MPI task number. (See #887).
  • Support Noah-MP and fractional grids. (See #549).

The full list of changes can be found at: https://github.com/ufs-community/UFS_UTILS/projects/15

Complete documentation can be found at https://ufs-community.github.io/UFS_UTILS/ver-1.12.0/index.html

And here: https://noaa-emcufs-utils.readthedocs.io/en/ufs_utils_1_12_0/

Version 1.11.0

We are pleased to announce the release of version 1.11.0 of UFS_UTILS.

The UFS_UTILS project contains utilities for the NCEP models.

Highlights In This Release:

• Update build script:
  • For NOAA cloud service providers. (See #831).
  • Performs a git submodule update to check out required submodules. (See #818 and #826).
  • Make script more flexible. (See #836).
• Update GDAS_INIT utility for new coldstart directory structure. (See #817).
• Updates to global_cycle program
  • Works for Noah-MP land model restart files. (See #761).
  • Option to update Noah-MP soil moisture and soil temperature from GSI increments. (See #832)
• New Github action workflows for Intel, Gnu and macOS. (See #668, #841, #756, #842)
• New VIIRS vegetation type and BNU soil type data. New higher-resolution version of the GFS soil substrate data. (See #821 and #803)
• Use new EPIC-maintained library stack on Hera and Orion. (See #789)
• Update FVCOM to use 32-bit surface file. (See #847)
• Add new readthedocs.yaml file required by 'ReadTheDocs'. (See #860).
• Add check to orog.fd code to prevent undefined 'mask' and 'orography' values when processing grids near and finer than 1km. (See #714).

The full list of changes can be found at: https://github.com/ufs-community/UFS_UTILS/projects/14

Complete documentation can be found at https://ufs-community.github.io/UFS_UTILS/ver-1.11.0/index.html

And here: https://noaa-emcufs-utils.readthedocs.io/en/ufs_utils_1_11_0/

Version 1.10.0

We are pleased to announce the release of version 1.10.0 of UFS_UTILS.

The UFS_UTILS project contains utilities for the NCEP models.

Highlights In This Release:

Build-Related Updates:

• Upgrade to new EPIC-maintained hpc-stack on Jet. (See #770).
• Update to IPLIB v4.0.0. (Updates are backwards compatible with IPLIB v3). (See #242)
• Remove support for retired machine ODIN. (See #779).
• Update build module for Cheyenne. (See #783).
• Use latest Cray modules on WCOSS2. (See #787).
• Option to build only application specific utilities. (See #776).

Program Updates:

• chgres_cube
  • Add logic to detect duplicate vertical levels in GRIB2 files. Stop program when detected. (See #763)
  • Process winds as x/y/z components to reduce memory. Upgrade to ESMF v8.4. (See #633)
  • Remove 'goto' statements by updating to latest MSIS library. (See #759).
  • Bug fix in subroutine "search_many". (See #797).
• cpld_gridgen
  • Output new grid resolutions. (See #768).
• GDAS INIT utility
  • Optionally use the 'fractional' orography data. (See #741.)
  • Move the copy of the coldstart files to a common script. (See #772).
  • Reorder ENKF outputs to align with new global workflow structure. (See #762).
• FVCOM_TOOLS
  • Eliminate dependency on module module_nwp_base.f90. Eliminates a
    segmentation fault when running with GNU. (See #596).
• global_cycle
  • The write component was updated to remove the NetCDF "checksum" attribute from the restart files. (See #781).
  • Some initial updates to support the Noah-MP LSM. (See #761).
• sfc_climo_gen
  • Optionally output the fraction of each vegetation and soil
    type at a model point. (See #709).

The full list of changes can be found at: https://github.com/ufs-community/UFS_UTILS/projects/11

Complete documentation can be found at https://ufs-community.github.io/UFS_UTILS/ver-1.10.0/index.html

And here: https://noaa-emcufs-utils.readthedocs.io/en/ufs_utils_1_10_0/

Version 1.9.0

We are pleased to announce the release of version 1.9.0 of UFS_UTILS.

The UFS_UTILS project contains utilities for the NCEP models.

Complete documentation can be found at https://ufs-community.github.io/UFS_UTILS/ver-1.9.0/index.html

And here: https://noaa-emcufs-utils.readthedocs.io/en/ufs_utils_1_9_0/

New This Release

• Improve logic in regression test driver script (add check for git clone failures). (See #680)
• Incorporate "weight_gen" utility from the global-workflow. (See #673)
• Update global_cycle to use the latest CCPP version of sfcsub.F. (See #670)
• Update CMake build to install binaries to any directory. (See #686).
• chgres_cube updates:
  • Output netcdf4 files instead of netcdf classic. (See #689).
  • Split input_data.F90 module into atm_input_data.F90, nst_input_data.F90 and sfc_input_data.F90. (See #460).
  • Remove compiler warnings when using GNU compiler. (See #736).
• Prevent unit test failures by increasing the timeout threshold to download the input data from the server. (See #691).
• Add CMake test support for WCOSS2. (See #690).
• Updates required for the reorganization of the 'fixed' file directories. (See #687).
• Fix error handling ./fix/link_fixdirs.sh. (See #700.)
• Run the "grid_gen" consistency tests in parallel instead of serially. (See #696).
• Updated to run WCOSS2 consistency tests under a role account. (See #710).
• Options to create model grids using the following new surface data data:
  • High-resolution (30 sec.) MODIS vegetation data and STATSGO soil type data. (See #702).
  • High-resolution (30 sec.) global and Northern Hemisphere versions of the VIIRS vegetation data. Previously, the 30 sec. data was only available for CONUS. (See #699)
  • High-resolution (30 sec.) global Beijing Normal University soil type data. (See #709).
  • CLM 0.05-degree soil color data. (See #720).
• Remove negative bias in the orographic asymmetry fields produced by the orog_gsl program. (See #716).
• Update GDAS initialization utility for GFS v16.3. (See #722).
• Update make_hgrid, fregrid and make_solo_mosaic for grid nesting. Required for HAFS v1. (See #751).

The full list of changes can be found at: https://github.com/ufs-community/UFS_UTILS/projects/10

ops-gfsv16.3.0

We are pleased to announce the release of ops-gfsv16.3.0.

Note: this release is an older version of UFS_UTILS that was only created to support the operational GFS v16.3.0.

General users are directed to use the latest release version - "Version X.Y.Z."

New to this release:

• The ./sorc/link_fixdirs.sh script of the ops-gfsv16.2.1 tag was updated as follows:
  • Perform a copy when run in NCO mode.
  • Remove references to WCOSS1.
  • Point to the gfs v16.3.0 fixed directories.

Fixes #694

Version 1.8.0

We are pleased to announce the release of version 1.8.0 of UFS_UTILS.

The UFS_UTILS project contains utilities for the NCEP models.

Complete documentation can be found at https://ufs-community.github.io/UFS_UTILS/ver-1.8.0/index.html

And here: https://noaa-emcufs-utils.readthedocs.io/en/ufs_utils_1_8_0/

New This Release

• Port to WCOSS2. (See #559).
• chgres_cube -
  • Fix bug when processing GEFS GRIB2 data. (See #651).
• Update GDAS INIT utility for GFS v16 HPSS tar ball name change. (See #662).
• Update GitHub workflows to use latest versions of 'macOS' and ubuntu. (See #674).
• Remove all references to now retired machines WCOSS-Dell and WCOSS-Cray. (See #665).
• Replace default sea ice climatology file in ./ush/global_cycle.sh with new National Ice Center IMS-based climatology. (See #661).
• Update ./fix/link_fixdirs.sh to point to new fixed directories. (See #659).

The full list of changes can be found at: https://github.com/ufs-community/UFS_UTILS/projects/9

Version 1.7.0

We are pleased to announce the release of version 1.7.0 of UFS_UTILS.

The UFS_UTILS project contains utilities for the NCEP models.

Complete documentation can be found at https://ufs-community.github.io/UFS_UTILS/ver-1.7.0.

New This Release

• chgres_cube -
  • New function 'rh2spfh_gfs' to convert from relative humidity to
    specific humidity using a formula consistent with the GFS v15/v16 GRIB2 files. (See #565)
  • New unit test for routine 'read_vcoord_info'. (See #499)
  • Simplify surface processing by using ESMF field bundles. (See #504).
  • Fix segmentation fault in routine 'read_input_sfc_grib2_file'. (See #584 )
  • Upgrade to ESMF v8.2.0. (See #621)
  • Call routine 'convert_omega' on all MPI tasks. (See #626).
  • Replace wgrib2 library with G2 library. (See #591)
• global_cycle
  • New option to add snow depth increments from the JEDI output
    increment file. The default is to not read in or apply the increments. (See #561)
  • Point to CCPP physics version of sfcsub.F instead of using local copy. (See #424)
• Instructions for writing unit tests. (See #573).
• Instructional template for pull requests. (See #575).
• Bug fix to the filter_topo code for regional grids. (See #105).
• Updated Fortran compiler flags for GNU v10 and newer. (See #551 and #554).
• fvcom_tools
  • Option to process 'warm' or 'coldstart files. Allow the user to select a specific
    time slice through the command line. (See #586).
  • Updated to process sub-domain restart files. (See #623).
• Updates to run consistency tests on Hera, Jet and Orion under a 'role' account. Previously,
  they were run under a personal account. (See #600).
• Build modules were updated to be 'lua' compliant. (See #613).
• Update build system to download all unit test data. (See #630).
• Move to Intel 2022 compiler on Hera, Jet and Orion. (See #634)
• New coupled model utility cpld_gridgen. (See #143).

The full list of changes can be found at: https://github.com/ufs-community/UFS_UTILS/projects/6

ops-gfsv16.2.1

We are pleased to announce the release of ops-gfsv16.2.1.

Note: this release is an older version of UFS_UTILS that was only created to support the operational GFS v16.2.0.

General users are directed to use the latest release version - "Version X.Y.Z."

New to this release:

• The ops-gfsv16.2.0 tag has been updated to use the HPC-stack on Orion and Hera.
• The nemsio utilities were removed as they are not used by the global workflow.

Fixes #629.

ops-gfsv16.2.0

We are pleased to announce the release of ops-gfsv16.2.0.

Note: this release is an older version of UFS_UTILS that was only created to support the operational GFS v16.2.0 (port to WCOSS2).

General users are directed to use the latest release version - "Version X.Y.Z".

New to this release:

• The ops-gfsv16.0.0 tag has been ported to WCOSS2.
• References to jlogfiles were removed from all operational scripts per NCO requirement.
• The build modules for Jet, Hera, Orion, WCOSS-Dell and WCOSS2 were converted to be 'lua' compliant. Default library version numbers may be overridden via environment variables.
• Turn off build of obsolete global_chgres program.

For details, see #580.