From 4e77e4ece1881d573901707dbfc0d440292f127b Mon Sep 17 00:00:00 2001
From: "George.Gayno" <george.gayno@noaa.gov>
Date: Tue, 24 Sep 2024 13:46:26 +0000
Subject: [PATCH] Update script comments.

Fixes #973.
---
 scripts/exemcsfc_global_sfc_prep.sh | 10 +++++-----
 ush/emcsfc_snow.sh                  | 21 ++++++++++++++-------
 2 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/scripts/exemcsfc_global_sfc_prep.sh b/scripts/exemcsfc_global_sfc_prep.sh
index d29370dbc..c0b44a337 100755
--- a/scripts/exemcsfc_global_sfc_prep.sh
+++ b/scripts/exemcsfc_global_sfc_prep.sh
@@ -18,6 +18,8 @@
 #    08/2015  Gayno   Update to current NCO standards
 #    08/2020  Gayno   Rename without the '.ecf' extention per
 #                     latest NCO standards.
+#    09/2024  Gayno   Replace afwa/u.s. air force hemispheric grib 1 data
+#                     with their new global grib 2 version.
 #
 # Usage:
 #  Parameters:    < no arguments >
@@ -25,8 +27,7 @@
 #    /nwprod/gfs.vX.Y.Z/ush/emcsfc_ice_blend.sh (create global ice blend)
 #    /nwprod/gfs.vX.Y.Z/ush/emcsfc_snow.sh (create model snow analysis)
 #  Input Files:
-#    $AFWA_NH_FILE           - nh afwa snow data (grib 1)
-#    $AFWA_SH_FILE           - sh afwa snow data (grib 1)
+#    $AFWA_GLOBAL_FILE       - afwa (usaf) snow data (grib 2)
 #    $IMS_FILE               - nh ims snow cover and ice data (grib 2)
 #    $FIVE_MIN_ICE_FILE      - global 5-minute ice concentration (grib 2)
 #    $FIVE_MIN_ICE_MASK_FILE - corresponding land/sea mask for $FIVE_MIN_ICE_FILE 
@@ -105,9 +106,8 @@ fi
 # the input data for emcsfc_ice_blend and emcsfc_snow2mdl programs.
 #-----------------------------------------------------------------------
 
-# afwa snow depth data (grib 1)
-export AFWA_NH_FILE=${AFWA_NH_FILE:-"NPR.SNWN.SP.S1200.MESH16"}
-export AFWA_SH_FILE=${AFWA_SH_FILE:-"NPR.SNWS.SP.S1200.MESH16"}
+# afwa/u.s. air force snow depth data (grib 2)
+export AFWA_GLOBAL_FILE=${AFWA_GLOBAL_FILE:-"snow.usaf.grib2"}
 
 # ims snow cover and ice cover data (grib 1 or grib 2)
 export IMS_FILE=${IMS_FILE:-"ims.grib2"} 
diff --git a/ush/emcsfc_snow.sh b/ush/emcsfc_snow.sh
index cf814852b..ca07c551d 100755
--- a/ush/emcsfc_snow.sh
+++ b/ush/emcsfc_snow.sh
@@ -5,7 +5,8 @@
 # Script name:  emcsfc_snow.sh
 # RFC Contact:  George Gayno
 # Abstract:  This script calls the emcsfc_snow2mdl program to create a 
-#    model snow analysis from IMS snow cover and AFWA snow depth data.
+#    model snow analysis from IMS snow cover and AFWA/U.S. Air Force
+#    snow depth data.
 #
 # Script History Log:
 #    07/2014  Gayno   Initial version
@@ -14,6 +15,7 @@
 #                     control whether model analysis is grib 1 or
 #                     grib 2.
 #    08/2015  Gayno   Bring up to current NCO standard.
+#    09/2024  Gayno   Logic to use afwa global grib 2 snow data.
 # 
 # Usage:
 #  Parameters:   < no arguments >
@@ -22,9 +24,11 @@
 #    $MODEL_SLMASK_FILE    - model landmask  (grib 1 or 2)
 #    $MODEL_LATITUDE_FILE  - model latitude  (grib 1 or 2)
 #    $MODEL_LONGITUDE_FILE - model longitude (grib 1 or 2)
-#    $AFWA_NH_FILE         - nh afwa snow data (grib 1)
-#    $AFWA_SH_FILE         - sh afwa snow data (grib 1)
-#    $AFWA_GLOBAL_FILE     - global afwa snow data (grib 2)
+#    NOTE: Use either the afwa/usaf global file or the hemispheric files,
+#    but not both.
+#    $AFWA_GLOBAL_FILE     - global afwa/usaf snow data (grib 2).
+#    $AFWA_NH_FILE         - nh afwa/usaf snow data (grib 1)
+#    $AFWA_SH_FILE         - sh afwa/usaf snow data (grib 1)
 #    $IMS_FILE             - nh ims snow cover data (grib 2)
 #    $CLIMO_QC             - nh climatological snow cover (grib 2)
 #    fort.41               - program configuration namelist
@@ -100,9 +104,12 @@ MODEL_LONGITUDE_FILE=${MODEL_LONGITUDE_FILE:-global_longitudes.t1534.3072.1536.g
 GFS_LONSPERLAT_FILE=${GFS_LONSPERLAT_FILE:-global_lonsperlat.t1534.3072.1536.txt}
 
 #------------------------------------------------------------------------
-# Input snow data.  ims snow cover and afwa snow depth. ims is NH only.
-# In OPS, we run with ims only, or ims and afwa.  afwa data is too
-# unreliable to use on its own.  ims is grib2.  afwa is grib1.
+# Input snow data.  ims snow cover and afwa/usaf snow depth. ims is NH
+# only. In OPS, we run with ims only, or ims and afwa.  afwa data is too
+# unreliable to use on its own.
+#
+# Note: use either the afwa global file or the hemispheric files,
+# but not both.
 #------------------------------------------------------------------------
 
 AFWA_NH_FILE=${AFWA_NH_FILE:-""}