Merge branch 'develop' into ejh_readme

.github/workflows/Spack.yml

@@ -0,0 +1,53 @@
+# This is a CI workflow for the NCEPLIBS-grib_util project.
+#
+# This workflow builds grib_util with Spack, including installing with the "--test
+# root" option to run the CTest suite. It also has a one-off job that validates
+# the recipe by ensuring that every CMake option that should be set in the
+# Spack recipe is so set.
+#
+# Alex Richert, Sep 2023
+name: Spack
+on:
+  push:
+    branches:
+    - develop
+  pull_request:
+    branches:
+    - develop
+
+jobs:
+  # This job builds with Spack using every combination of variants and runs the CTest suite each time
+  Spack:
+
+    strategy:
+      matrix:
+        os: ["ubuntu-latest"]
+        openmp: ["+openmp", "~openmp"]
+        ip_spec: ["^ip@5.0.0", "^ip@4.2.0 ^sp@2.4.0"]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+
+    - name: "Build Spack package"
+      uses: NOAA-EMC/ci-test-spack-package@develop
+      with:
+        package-name: grib-util
+        package-variants: +tests ${{ matrix.openmp }} ^bacio@2.6.0 ^w3emc@2.10.0 ^g2@develop ^g2c@develop +utils +build_v2_api ${{ matrix.ip_spec }}
+        custom-recipe: spack/package.py
+        use-repo-cache: true
+        spack-compiler: gcc
+        repo-cache-key-suffix: ${{ matrix.os }}-${{ matrix.openmp }}-${{ matrix.ip_spec }}-1
+
+
+  # This job validates the Spack recipe by making sure each cmake build option is represented
+  recipe-check:
+    runs-on: ubuntu-latest
+
+    steps:
+
+    - name: recipe-check
+      uses: NOAA-EMC/ci-check-spack-recipe@develop
+      with:
+        recipe-file: package/spack/package.py
+        cmakelists-txt: package/CMakeLists.txt
+        ignore-list: ENABLE_DOCS,FTP_TEST_FILES,FTP_LARGE_TEST_FILES,FTP_EXTRA_TEST_FILES

src/tocgrib2/docs/user_guide.md

@@ -1,4 +1,4 @@
-# tocgri2
+# tocgrib2
 
 # Introduction
 
@@ -15,6 +15,26 @@ they want the entire GRIB2 message containing the requested field
 field (extract=.true.). Both options return the same message if the
 requested field is the only field in the GRIB2 message.
 
+This program is used by a number of operational applications, 
+including:
+ - ECMWF
+ - [Extra-Tropical Storm Surge (ETSS)](https://slosh.nws.noaa.gov/etsurge/)
+ - [Global Ensemble Forecast System (GEFS)](https://www.ncei.noaa.gov/products/weather-climate-models/global-ensemble-forecast)
+ - [Global Forecast System (GFS)](https://www.ncei.noaa.gov/products/weather-climate-models/global-forecast)
+ - [Gridded LAMP (GLMP)](https://vlab.noaa.gov/web/mdl/gridded-lamp)
+ - [Great Lakes Wave model (GLWU)](https://polar.ncep.noaa.gov/waves/index.php)
+ - [High-Resolution Window Forecast System (HiResW)](https://www.nco.ncep.noaa.gov/pmb/products/hiresw/)
+ - [High Resolution Ensemble Forecast (HREF)](https://mag.ncep.noaa.gov/model-guidance-model-parameter.php?group=Model%20Guidance&model=HREF&area=CONUS&ps=area)
+ - [High-Resolution Rapid Refresh (HRRR)](https://rapidrefresh.noaa.gov/hrrr/)
+ - [Localized Aviation MOS Program (LMP)](https://vlab.noaa.gov/web/mdl/lamp)
+ - [Nearshore Wave Prediction System (NWPS)](https://polar.ncep.noaa.gov/nwps/)
+ - [Rapid Refresh (RAP)](https://rapidrefresh.noaa.gov/)
+ - [Real-Time & Unrestricted Mesoscale Analysis (RTMA/URMA)](https://www.nco.ncep.noaa.gov/pmb/products/rtma/)
+ - [Real-Time Ocean Forecast System (RTOFS)](https://polar.ncep.noaa.gov/global/)
+ - seaice_analysis
+ - [Short-Range Ensemble Forecast (SREF)](https://www.nco.ncep.noaa.gov/pmb/products/sref/)
+ - [Wind Speed Probabilities (WSP)](https://www.nhc.noaa.gov/gis/)
+
 ### Input Files
 - 5 namelist of grib fields and associated wmo headers.
 - 11 input grib2 file.

src/tocgrib2super/docs/user_guide.md

@@ -18,6 +18,11 @@ requested field (extract=.true.). Both options return the same
 message if the requested field is the only field in the GRIB2
 message.
 
+This program is used by operational applications including:
+ - [Air Quality Model (AQM)](https://www.nco.ncep.noaa.gov/pmb/products/aqm/)
+ - [Gridded LAMP (GLMP)](https://vlab.noaa.gov/web/mdl/gridded-lamp)
+ - [Rapid Refresh (RAP)](https://rapidrefresh.noaa.gov/)
+
 ### Input Files
 
 - 5 Namelist of grib fields and associated wmo headers.

src/tocgrib2super/tocgrib2super.F90

@@ -232,6 +232,7 @@ end subroutine getgb2p2
      !
      !        Read and return packed GRIB field
      !
+     idxver = 2
      CALL GETGB2P2(lugb,lugi,jrew,DSCPL,IDS,PDTN,PDT, &
           GDTN,GDT,extract,idxver,KREW,gribm,itot8,iret)
      itot = int(itot8, kind(4))