Add GFSv16.1.* and GFSv16.2.* release notes to develop

docs/Release_Notes.gfs.v16.1.4.txt

@@ -0,0 +1,160 @@
+GFS V16.1.4 RELEASE NOTES
+
+
+PRELUDE
+
+  NOAA awarded Delivery Order 3 (DO-3) of its commercial radio occultation
+  (RO) data purchase to Spire Global on August 12, 2021.  This purchase
+  covers 3000 occultations per day over a six month period with the data
+  flow starting on September 16, 2021.  On the same date, the GeoOptics
+  data from Delivery Order 2 (DO-2) will be discontinued.
+
+  GNSSRO bending angle observations from GeoOptics and Spire were initially
+  evaluated as part of Delivery Order 1 (DO-1), covering a 30-day period
+  starting on December 15, 2020.  The data from both vendors were found to
+  be of similar quality to other operationally assimilated RO data.  Low
+  resolution experiments informed the configuration of the quality control
+  and observation errors for the following DO-2, which was awarded to
+  GeoOptics only, covering an average of 1300 occultations per day over a
+  six month period starting on March 17, 2021.  These data began to be
+  assimilated operationally with the implementation of GFSv16.1.1 on
+  May 22, 2021 after two months of parallel testing at full resolution.
+
+  Following the v16.1.1 implementation, the observation errors for
+  commercial RO were tuned to better utilize the new data.  Additionally,
+  two fixes related to the handling of super-refractivity in the RO bending
+  angle observation operator were added.  These fixes resolve minimization
+  issues that were related to the increased vertical resolution in v16.
+  Therefore, the stricter gross check quality control measures originally
+  put in place to mitigate minimization problems will now be relaxed.
+
+  This implementation plans to:
+    * Turn off the active assimilation of GeoOptics data
+    * Turn on the active assimilation of Spire data
+    * Adjust the observation errors for the Spire data
+    * Address two issues within the RO bending angle observation operator
+    * Relax the strict gross check added because of those issues.
+
+  These changes only affect two files within the GSI tag of the global workflow.
+
+  In addition, a small bug fix is required to correct the ingest of new BUFR
+  observations from ships that was previously causing erroneous observations
+  to be assimilated.  This alters one additional file in the GSI tag.
+
+IMPLEMENTATION INSTRUCTIONS
+
+  The NOAA VLab and both the NOAA-EMC and NCAR organization spaces on GitHub.com
+  are used to manage the GFS.v16.1.4 code. The SPA(s) handling the GFS.v16.1.4
+  implementation need to have permissions to clone VLab gerrit repositories and
+  the private NCAR UPP_GTG repository. All NOAA-EMC organization repositories are
+  publicly readable and do not require access permissions.  Please follow the
+  following steps to install the package on WCOSS-Dell:
+
+  1) cd $NWROOTp3
+
+  2) mkdir gfs.v16.1.4
+
+  3) cd gfs.v16.1.4
+
+  4) git clone -b EMC-v16.1.4  https://github.com/NOAA-EMC/global-workflow.git .
+
+  5) cd sorc
+
+  6) ./checkout.sh -o
+     * This script extracts the following GFS components:
+         MODEL     tag GFS.v16.0.16                  Jun.Wang@noaa.gov
+         GSI       tag gfsda.v16.1.4                 Russ.Treadon@noaa.gov
+         GLDAS     tag gldas_gfsv16_release.v1.12.0  Helin.Wei@noaa.gov
+         UFS_UTILS tag ops-gfsv16.0.0                George.Gayno@noaa.gov
+         POST      tag upp_gfsv16_release.v1.1.4     Wen.Meng@noaa.gov
+         WAFS      tag gfs_wafs.v6.0.22              Yali.Mao@noaa.gov
+
+  7) ./build_all.sh
+     * This script compiles all GFS components. Runtime output from the build for
+       each package is written to log files in directory logs. To build an
+       individual program, for instance, gsi, use build_gsi.sh.
+
+  8) ./link_fv3gfs.sh nco dell
+
+
+SORC CHANGES
+
+* sorc/
+  * checkout.sh will checkout the following changed model tags:
+    * GSI; tag gfsda.v16.1.4
+      * src/gsi/setupbend.f90:  Add two fixes for handling of
+        super-refractivity layer, change the observation errors
+        of the commercial data, relax stricter gross check back to
+        original values
+      * src/read_nsstbufr.f90: Changes to handle NC001013, NC001101
+        and NC001113 marine bufr subsets.
+
+
+FIX CHANGES
+
+* fix/fix_gsi:
+  * global_convinfo.txt: Discontinue assimilating GeoOptics and
+    begin assimilating Spire, relax stricter gross check back to
+    original values.
+  * gfsv16_historical/: Add fix files for retrospective parallels.
+    Does not impact operations.
+
+
+PARM/CONFIG CHANGES
+
+* parm/config/config.anal:  Add historical fix file entries.  Does
+  not impact operations.
+
+
+JOBS CHANGES
+
+* No change from GFS v16.1.3
+
+
+SCRIPT CHANGES
+
+* No change from GFS v16.1.3
+
+
+CHANGES TO RESOURCES AND FILE SIZES
+
+  There should be no change in analysis runtime nor cnvstat file size
+  greater than the normal cycle to cycle variation.
+
+
+PRE-IMPLEMENTATION TESTING REQUIREMENTS
+
+* Which production jobs should be tested as part of this implementation?
+  * The entire GFS v16.1.4 package needs to be installed and tested.
+
+* Does this change require a 30-day evaluation?
+  * No.
+
+
+DISSEMINATION INFORMATION
+
+* Where should this output be sent?
+  * No change from GFS v16.1.3
+
+* Who are the users?
+  * No change from GFS v16.1.3
+
+* Which output files should be transferred from PROD WCOSS to DEV WCOSS?
+  * No change from GFS v16.1.3
+
+* Directory changes
+  * No change from GFS v16.1.3
+
+* File changes
+  * No change from GFS v16.1.3
+
+
+HPSS ARCHIVE
+
+* No change from GFS v16.1.3
+
+
+JOB DEPENDENCIES AND FLOW DIAGRAM
+
+* No change from GFS v16.1.3
+

docs/Release_Notes.gfs.v16.1.5.txt

@@ -0,0 +1,118 @@
+GFS V16.1.5 RELEASE NOTES
+
+PRELUDE
+
+Metop-A, B and C all have similar orbits. Metop-C was launched on 7 November 2018 in a low-Earth polar orbit while Metop-A was launched in 2006. The Metop-A will be decommissioned in November 2021 and IASI_Metop-A data quality has degraded since September 17, so the assimilation of IASI_Metop-A was stopped on 9/22/2021 gfs.v16.1.3 implementation. The IASI_Metop-C data have similar quality as IASI_Metop-B. This implementation will start to assimilate IASI data on Metop-C. In addition, the correlated observation errors for hyperspectral Infrared instruments both IASI and CrIS were recomputed from recent operations, which should be a more accurate representation of the observation error statistics. Both low- and high-resolution parallel experiments show reasonable results as expected.
+
+In addition, a minimum value was set in gsi source code genqsat.f90 to limit the saturation specific humidity not smaller than 1.e-7, which is a risk mitigation feature and could avoid the potential risk of generating unphysical temperature in the analysis.
+
+This implementation plans to:
+
+* Turn on the active assimilation of Metop-C IASI data with correlated observation errors
+* Update correlated observation errors for Metop-B IASI, N20 CrIS, and NPP CrIS
+* Put in a minimum threshold for saturation specific humidity to avoid potential minimization issues.
+
+These changes affect one source code and several fix files within the GSI tag of the global workflow.
+
+Also bundled into this update are the new 2022 CO2 fix files (see files listed below) and a new FV3 model tag that adds traceback flags to compilation by default. The CO2 fix files will be included during the link setup step. Neither the CO2 fix file nor the FV3 tag updates impact model results.
+
+IMPLEMENTATION INSTRUCTIONS
+
+The NOAA VLab and both the NOAA-EMC and NCAR organization spaces on GitHub.com are used to manage the GFS.v16.1.5 code. The SPA(s) handling the GFS.v16.1.5 implementation need to have permissions to clone VLab gerrit repositories and the private NCAR UPP_GTG repository (the nwprod account has access to the GTG repository). All NOAA-EMC organization repositories are publicly readable and do not require access permissions. Please follow the following steps to install the package on WCOSS-Dell.
+
+While logged in under the nwprod account:
+
+1) cd $NWROOTp3
+2) mkdir gfs.v16.1.5
+3) cd gfs.v16.1.5
+4) git clone -b EMC-v16.1.5  https://github.com/NOAA-EMC/global-workflow.git .
+5) cd sorc
+6) ./checkout.sh -o
+   * This script extracts the following GFS components:
+     MODEL      tag GFS.v16.0.17			Jun.Wang@noaa.gov
+     GSI        tag gfsda.v16.1.5   	    		Russ.Treadon@noaa.gov
+     GLDAS     	tag gldas_gfsv16_release.v1.12.0     	Helin.Wei@noaa.gov
+     UFS_UTILS 	tag ops-gfsv16.0.0  	               	George.Gayno@noaa.gov
+     POST       tag upp_gfsv16_release.v1.1.4        	Wen.Meng@noaa.gov
+     WAFS       tag gfs_wafs.v6.0.22                  	Yali.Mao@noaa.gov
+
+7) ./build_all.sh
+   * This script compiles all GFS components. Runtime output from the build for each package is written to log files in directory logs. To build an individual program, for instance, gsi, use build_gsi.sh.
+8) ./link_fv3gfs.sh nco dell
+
+SORC CHANGES
+
+* checkout.sh will checkout the following changed model tags:
+  * MODEL tag GFS.v16.0.17
+    * conf/configure.fv3.wcoss_dell_p3 and other platform configure.fv3 files: add “-g -traceback” to FFLAGS_OPT, CFLAGS_OPT, and CFLAGS_REPRO compilation settings
+  * GSI tag gfsda.v16.1.5
+    * src/gsi/genqsat.f90: add a lower bound of qsat to avoid unphysical saturation specific humidity to be generated.
+
+FIX CHANGES
+
+* fix/fix_gsi:
+  * new files:
+    * Rcov_iasicsea
+    * Rcov_iasicland
+  * modified files:
+    * global_satinfo.txt: Turn on assimilating Metop-C IASI data and stop monitoring CrIS_NPP MW channels (iuse changed from -1 to -2)
+    * global_anavinfo.l127.txt: Add correlated observation errors for Metop-C IASI data and remove correlated observation errors for Metop-A IASI
+    * Rcov_iasibsea: recomputed from recent operations
+    * Rcov_iasibland: recomputed from recent operations
+    * Rcov_crisn20: recomputed from recent operations
+    * Rcov_crisnpp: updated and the MW channels are deleted from Rcov
+    * gfsv16_historical/: Add fix files for retrospective parallels.  Does not impact operations.
+* fix_am/co2dat_4a:
+  * global_co2historicaldata_2020.txt
+  * global_co2historicaldata_2021.txt_proj_u
+  * global_co2historicaldata_2022.txt_proj
+* fix_am/fix_co2_proj:
+  * global_co2historicaldata_2022.txt
+* fix_am/fix_co2_update:
+  * global_co2historicaldata_2021.txt
+
+PARM/CONFIG CHANGES
+
+* config.anal
+  * update global_convinfo.txt notes and global_satinfo.txt if-blocks for retrospective dates; no operational impact
+
+JOBS CHANGES
+
+* No change from GFS v16.1.4
+
+SCRIPT CHANGES
+
+* No change from GFS v16.1.4
+
+CHANGES TO RESOURCES AND FILE SIZES
+
+* There should be no change in analysis runtime nor radstat file size greater than the normal cycle to cycle variation.
+
+PRE-IMPLEMENTATION TESTING REQUIREMENTS
+
+* Which production jobs should be tested as part of this implementation?
+  * The entire GFS v16.1.5 package needs to be installed and tested.
+* Does this change require a 30-day evaluation?
+  * No.
+
+DISSEMINATION INFORMATION
+
+* Where should this output be sent?
+  * No change from GFS v16.1.4
+* Who are the users?
+  * No change from GFS v16.1.4
+* Which output files should be transferred from PROD WCOSS to DEV WCOSS?
+  * No change from GFS v16.1.4
+* Directory changes
+  * No change from GFS v16.1.4
+* File changes
+  * No change from GFS v16.1.4
+
+HPSS ARCHIVE
+
+* No change from GFS v16.1.4
+
+JOB DEPENDENCIES AND FLOW DIAGRAM
+
+* No change from GFS v16.1.4
+