tropcy_qc_reloc.v5.1.1
     ----- (last modified August 10, 2015)

  tropcy_qc_reloc.v5.1.1 directory currently includes hurricane related 
scripts/code for GFS/GDAS. There are three main functionalities in the 
scripts/code:

  1) global TC vital data collection and data quality control
  2) tropical storm relocation
  3) TC tracker for application in GFS relocation and GFS post jobs

  The scripts/code are upgrades from the tropcy_qc_reloc 5.0.1, and have the flexibility 
to do hourly relocation and 3-hourly relocation. The tropcy_qc_reloc 5.1.1 includes the 
following changes:

 1) remove the TC vitals marked as (WV, ET or LO) from storm relocation (and
storm bogus data creation)
 2) combine hourly relocation with 3-hourly relocation.
 3) unify the build.sh (named as ubuild.sh) for different machines (WCOSS, Zeus and others).

1. Code Changes:

   1) relocation code is upgraded to handle both hourly relocation and 3-hourly relocation
   2) tracker code is upgraded to output hourly storm positions for hurricane relocation.  This is accomplished in subroutine output_all and utilizes a namelist variable called atcffreq to determine if output is hourly or 3-hourly.

2. Forecast Job Changes:

   FORECAST Jobs are updated (small changes):

   JGDAS_TROPCY_QC_RELOC
   JGFS_TROPCY_QC_RELOC
   JNAM_TROPCY_QC_RELOC
   JNDAS_TROPCY_QC  
   JNDAS_TROPCY_RELOC
   JGFS_CYCLONE_TRACKER

3. Job script changes:

   No changes to the job scripts:

     extropcy_qc_reloc.sh.ecf

4. USH script changes:

   The following scripts are changed:
 
   tropcy_relocate.sh
   tropcy_relocate_extrkr.sh
   syndat_qctropcy.sh
   getges.sh
   global_extrkr.sh -- Most of the changes to this script were to ensure 
   compliance with new variable name standards for phase-2 compatibility.
   However, one substantial change that was made was to include scripting
   code to create the appropriate storm ID directory under ATCFdir if the
   directory does not already exist.

5. Fix file changes:

   gdas.tracker_leadtimes_hrly    <== new
   syndat_stmnames                <== no change
   syndat_fildef.vit              <== no change
   gfs_hgt_levs.txt               <== no change 
   gfs_tmp_levs.txt               <== no change
   syndat_slmask.t126.gaussian    <== no changes
   gdas.tracker_leadtimes         <== no change
   NOTE: For the JGFS_CYCLONE_TRACKER job in the GFS post-processing, 
   the "tracker_leadtimes" file is not pulled from a fix file / fix 
   directory.  Instead, that tracker_leadtimes file is created on the 
   fly from within the global_extrkr.sh script.

6. Source code information


   relocate_mv_nvortex.fd          <== updated
   gettrk.fd                       <== updated

   syndat_getjtbul.fd              <== no changes
   syndat_maksynrc.fd              <== no changes
   syndat_qctropcy.fd              <== no changes
   supvit.fd                       <== no changes
   tave.fd                         <== no changes
   vint.fd                         <== no changes

7. Computing Resource Information

   JGDAS_TROPCY_QC_RELOC
   JGFS_TROPCY_QC_RELOC  
   JNAM_TROPCY_QC_RELOC
   JNDAS_TROPCY_RELOC
   JGFS_CYCLONE_TRACKER

   Current operation: ptile=1, 3 nodes, < 8 minutes
                      memory required: 20.0 GB
   Proposed package: ptile=1, 7 nodes, < 8 minutes
                      memory required: 20.0 GB

   JNDAS_TROPCY_QC   <== no change
   JGFS_CYCLONE_TRACKER <== use 1 nodes


8. Version of Libraries

   1) Libraries

      module load EnvVars/1.0.0
      module load ics/12.1
      module load lsf/9.1
      module load ibmpe/1.3.0.10
      module load png/v1.2.44
      module load w3emc/v2.0.5
      module load w3nco/v2.0.6
      module load bacio/v2.0.1
      module load g2/v2.5.0
      module load z/v1.2.6
      module load jasper/v1.900.1
      module load sigio/v2.0.1
      module load sp/v2.0.2

   2) Compiler

9. Pre-implementation requirements

   1) Which production jobs should be tested as part of this implementation?
      gdas_da.v6.0.0 should be tested as part of this implementation
   2) does this change requires a 30-day evaluation?
      Yes
   3) suggested evaluation
      same as the rest of T1534 GFS/GDAS package


10. DISSEMINATION INFORMATION

   1) where should this output be sent?
      same as current operational GFS/GDAS directories
   2) who are the users?
      same as current operational GFS/GDAS 
   3) which output files should be transferred from PROD WCOSS to DEV WCOSS?
      same as current operational GFS/GDAS analysis


11. HPSS ARCHIVE

   1) retention length?
      same as current operational GFS/GDAS analysis
   2) list which output files should be archived
      same as current operational GFS/GDAS analysis


12. IMPLEMENTATION INSTRUCTIONS

   To implement tropcy_qc_reloc.v5.1.1, please do the following:

     cd /$NWROOT/$shared_global_home
       1) bash
       2) module purge
       3) module use .
       4) module load Module_storm_reloc_v5.1.0_WCOSS
       5) ./build_tropcy.sh
       6) ./install_tropcy.sh

13. JOB DEPENDENCIES

   1) JGDAS_TROPCY_QC_RELOC (and JGDAS_DUMP) are the first jobs to be run

     * upstream
       - none
     * downstream
       - JGDAS_PREP

   2) JGFS_TROPCY_QC_RELOC (and JGFS_DUMP) are the first jobs to be run

     * upstream
       - none
     * downstream
       - JGFS_PREP

   3) JNAM_TROPCY_QC_RELOC (and JNAM_DUMP) are the first jobs to be run 

     * upstream
       - none 
     * downstream
       - JNAM_PREP

   4) JNDAS_TROPCY_QC

     * upstream
       - none
     * downstream
       - JNDAS_TROPCY_RELOC

   5) JNDAS_TROPCY_RELOC (and JNDAS_DUMP) 

     * upstream
       -  JNDAS_TROPCY_QC
     * downstream
       - JNDAS_PREP

   6) JGFS_CYCLONE_TRACKER

     * upstream
       - JGFS_PGRB2
     * downstream
       - none