Skip to content

Commit

Permalink
Add Release Notes for GFSv16.1
Browse files Browse the repository at this point in the history
Added the file docs/Release_Notes.gfs.v16.1.0.txt to release branch
release/gfsv16.1.

Refs: #301
  • Loading branch information
CatherineThomas-NOAA committed Apr 26, 2021
1 parent 918c450 commit 3142a82
Showing 1 changed file with 145 additions and 0 deletions.
145 changes: 145 additions & 0 deletions docs/Release_Notes.gfs.v16.1.0.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
GFS V16.1.0 RELEASE NOTES


PRELUDE

NOAA awarded Delivery Order 2 (DO-2) of its commercial radio occultation (RO)
data purchase to GeoOptics on February 19, 2021. This purchase covers 1300
occultations a day over a six month period with the data flow starting on
March 17, 2021.

The quality of the GeoOptics occultations was examined during Delivery
Order 1 (DO-1) in December 2020 and January 2021. Forecast impact assessment
was conducted using half resolution parallels in the GFSv16 framework.

Testing of the DO-2 data is being carried out using a real time full
resolution parallel, v161rt1. It was initially started in mid-February
to test reproducibility with the GFSv16 NCO parallel, then adjusted to reduce
computational footprint. Data from GeoOptics began to be assimilated as soon
as it was available on March 17. Configuration for the use of the commercial
data was informed by the results of DO-1 experimentation, with the quality
control and observation errors being treated as other RO data with the
exception of lowering the upper bound of data.

This package also addresses several GFS v16 bugzilla tickets. GFS v16
bugzilla tickets #1196 and #1205 are resolved in this package. The error
reported in bugzilla ticket #1206 has been documented to be compiler, not
code, specific. The DA aspect of GFS v16 bugzilla tickets #216, #1198, #1218,
#1221, and #1222 are also addressed by this package. None of the DA
bugzilla changes alter analysis results.

GFSv16 introduced a bug where the sign of the layer height (delz) increment
was flipped. The included bugfix reverts the sign as originally intended.
This fix was tested in both a low resolution setting and with a full
resolution parallel, v16rt2c. Once v16rt2c was seen as viable, it also
began assimilating the GeoOptics data so both changes were tested in one
package.


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 code. The SPA(s) handling the GFS.v16.1
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.0

3) cd gfs.v16.1.0

4) git clone -b EMC-v16.1.0 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.0 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.3 Wen.Meng@noaa.gov
WAFS tag gfs_wafs.v6.0.21 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.0 - See release notes
doc/Release_Notes.gfsda.v16.1.0.txt in the GSI tag for details.

* POST; tag upp_gfsv16_release.v1.1.3 - There are no changes in this tag
compared to operations. The tag number was updated from
tag upp_gfsv16_release.v1.1.1 to incorporate the local changes made
in operations.

* WAFS; tag gfs_wafs.v6.0.21 - There are no changes in this tag compared to
operations. The tag number was updated from gfs_wafs.v6.0.17 to
incorporate the local changes made in operations.


JOBS CHANGES

* No change from GFS v16.0


FIX CHANGES

* The contents of fix/fix_gsi have been updated. See release notes
doc/Release_Notes.gfsda.v16.1.0.txt in the NOAA-EMC/GSI tag gfsda.v16.1.0
for details.


RESOURCE INFORMATION

* No change from GFS v16.0 in terms of modules, computational resources,
run time, or disk space.


PRE-IMPLEMENTATION TESTING REQUIREMENTS

* Which production jobs should be tested as part of this implementation?
* The entire GFS v16.1 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.0

* Who are the users?
* No change from GFS v16.0

* Which output files should be transferred from PROD WCOSS to DEV WCOSS?
* No change from GFS v16.0

* Directory changes
* No change from GFS v16.0

* File changes
* No change from GFS v16.0


HPSS ARCHIVE

* No change from GFS v16.0


JOB DEPENDENCIES AND FLOW DIAGRAM

* No change from GFS v16.0

0 comments on commit 3142a82

Please sign in to comment.