RELEASE NOTES FOR 3 October 2003 NWSRFS Release 24.0 which will be part of AWIPS Release OB 3 New versions of selected NWSRFS executables for the linux and HP workstations are included in Release 24.0. Release 24.0 includes some new functionality as well as a number of bug fixes. This release includes updates to the snow model and the snow model displays. These updates are a follow up to work completed in the previous release when the snow depth and snow temperature calculations were added. The snow model will now ingest the snow depth (SNOG) data, and include this data in the snow model table. The ifp states display and the icp states display have been updated to include the simulated snow temperature, the simulated snow depth and the observed snow depth. The ESP Verification Systems (ESPVS) has been updated to work correctly for forecast groups. Previously, the fcst program did not save the past carryover correctly, and the hindcast ensembles were not created. This release also includes updates to the GLACIER operation completed by the APRFC. This release retracts the Release 23 enhancement to the UHGCHNG mod allowing start and end dates to be specified for the mod. So the UHGCHNG mod should work as it did prior to release 23. More information about the specific changes in this release are provided in the appropriate section, below. This message contains the following sections, in order: 1. WHAT'S INCLUDED IN THE RELEASE 2. OFS RELEASE NOTES 3. CALB RELEASE NOTES 4. IFP RELEASE NOTES 5. ENSEMBLE PROGRAM RELEASE NOTES 6. ICP RELEASE NOTES 7. X PROGRAM RELEASE NOTES 8. UTIL RELEASE NOTES 9. IDMA RELEASE NOTE 10. VERIFY RELEASE NOTES 11. GRIB RELEASE NOTES 12. SYS_FILES RELEASE NOTES 13. SCRIPT RELEASE NOTES 14. FFG RELEASE NOTES 15. OFSDE RELEASE NOTES 16. WHFS RELEASE NOTES 17. DOCUMENTATION NOTES 18. CONTACT INFORMATION ================================================================================ 1. WHAT'S INCLUDED IN THE RELEASE ================================================================================ For the HP-UX release: (tar file starts above dir rfc) rfc/nwsrfs/ofs/bin/RELEASE/batchpst rfc/nwsrfs/ofs/bin/RELEASE/espinit rfc/nwsrfs/ofs/bin/RELEASE/fcinit rfc/nwsrfs/ofs/bin/RELEASE/fcst rfc/nwsrfs/ofs/bin/RELEASE/filecrat rfc/nwsrfs/ofs/bin/RELEASE/filesize rfc/nwsrfs/ofs/bin/RELEASE/goesdb rfc/nwsrfs/ofs/bin/RELEASE/ppdutil rfc/nwsrfs/ofs/bin/RELEASE/ppinit rfc/nwsrfs/ofs/bin/RELEASE/prdutil rfc/nwsrfs/ofs/bin/RELEASE/reorder rfc/nwsrfs/ofs/bin/RELEASE/sasmdb rfc/nwsrfs/ofs/bin/RELEASE/shefpars rfc/nwsrfs/ofs/bin/RELEASE/shefpost rfc/nwsrfs/calb/bin/RELEASE/map rfc/nwsrfs/calb/bin/RELEASE/mape rfc/nwsrfs/calb/bin/RELEASE/mapx rfc/nwsrfs/calb/bin/RELEASE/mat rfc/nwsrfs/calb/bin/RELEASE/mcp3 rfc/nwsrfs/calb/bin/RELEASE/opt3 rfc/nwsrfs/calb/bin/RELEASE/pxpp rfc/nwsrfs/calb/bin/RELEASE/taplot rfc/nwsrfs/util/bin/RELEASE/cvtgriddb rfc/nwsrfs/util/bin/RELEASE/get_apps_defaults rfc/nwsrfs/util/bin/RELEASE/looknset rfc/nwsrfs/ifp/bin/RELEASE/IFP_Map rfc/nwsrfs/ifp/bin/RELEASE/NWSRFS_no_startup rfc/nwsrfs/ifp/bin/RELEASE/bin_to_ss_input rfc/nwsrfs/ifp/bin/RELEASE/delete_atoms rfc/nwsrfs/ifp/bin/RELEASE/delete_is_running rfc/nwsrfs/ifp/bin/RELEASE/ifp_nwsrfs rfc/nwsrfs/ifp/bin/RELEASE/parse_mods_by_segment rfc/nwsrfs/ifp/bin/RELEASE/post_default_run_dates rfc/nwsrfs/ifp/bin/RELEASE/print_prop rfc/nwsrfs/ifp/bin/RELEASE/seg_sort rfc/nwsrfs/ifp/bin/RELEASE/set_dates rfc/nwsrfs/ifp/bin/RELEASE/startifp_done rfc/nwsrfs/ifp/bin/RELEASE/working_dialog rfc/nwsrfs/icp/bin/RELEASE/icp rfc/nwsrfs/ens/bin/RELEASE/ens_post rfc/nwsrfs/ens/bin/RELEASE/ens_post_cp rfc/nwsrfs/ens/bin/RELEASE/ens_pre rfc/nwsrfs/ens/bin/RELEASE/ens_pre_cp rfc/nwsrfs/ens/bin/RELEASE/espadp rfc/nwsrfs/ens/bin/RELEASE/espts_conv rfc/nwsrfs/ens/bin/RELEASE/espvs rfc/nwsrfs/ens/bin/RELEASE/print_ts rfc/nwsrfs/ens/scripts/run_espvs rfc/nwsrfs/ens/app-defaults/espvs.res rfc/verify/bin/RELEASE/verify rfc/xsets/bin/RELEASE/xsets rfc/xdat/bin/RELEASE/ofstofs rfc/xdat/bin/RELEASE/outputbadobs rfc/xdat/bin/RELEASE/xdat rfc/xnav/bin/RELEASE/ffgoutput rfc/xnav/bin/RELEASE/make24hrxmrg rfc/xnav/bin/RELEASE/make6hrxmrg rfc/xnav/bin/RELEASE/makeXdaysxmrg rfc/xnav/bin/RELEASE/wfoqpf rfc/xnav/bin/RELEASE/xnav rfc/nwsrfs/ffg/bin/RELEASE/ffguid rfc/nwsrfs/ffg/bin/RELEASE/prodgen rfc/nwsrfs/ffg/bin/RELEASE/zgrid rfc/grib/bin/RELEASE/gribit rfc/idma/bin/RELEASE/idma rfc/ofsde/bin/RELEASE/ofsde rfc/nwsrfs/ifp/options/ModSettings/ModDefinitions rfc/verify/bin/RELEASE/ivp.jar rfc/nwsrfs/ens/bin/RELEASE/batchbuilder.jar rfc/nwsrfs/ifp/bin/RELEASE/sacsnow.jar rfc/nwsrfs/util/bin/RELEASE/utilities.jar For the Linux release: (tar file starts above dir lx/rfc) lx/rfc/nwsrfs/ofs/bin/RELEASE/batchpst lx/rfc/nwsrfs/ofs/bin/RELEASE/espinit lx/rfc/nwsrfs/ofs/bin/RELEASE/fcinit lx/rfc/nwsrfs/ofs/bin/RELEASE/fcst lx/rfc/nwsrfs/ofs/bin/RELEASE/filecrat lx/rfc/nwsrfs/ofs/bin/RELEASE/filesize lx/rfc/nwsrfs/ofs/bin/RELEASE/goesdb lx/rfc/nwsrfs/ofs/bin/RELEASE/ppdutil lx/rfc/nwsrfs/ofs/bin/RELEASE/ppinit lx/rfc/nwsrfs/ofs/bin/RELEASE/prdutil lx/rfc/nwsrfs/ofs/bin/RELEASE/reorder lx/rfc/nwsrfs/ofs/bin/RELEASE/sasmdb lx/rfc/nwsrfs/ofs/bin/RELEASE/shefpars lx/rfc/nwsrfs/ofs/bin/RELEASE/shefpost lx/rfc/nwsrfs/calb/bin/RELEASE/map lx/rfc/nwsrfs/calb/bin/RELEASE/mape lx/rfc/nwsrfs/calb/bin/RELEASE/mapx lx/rfc/nwsrfs/calb/bin/RELEASE/mat lx/rfc/nwsrfs/calb/bin/RELEASE/mcp3 lx/rfc/nwsrfs/calb/bin/RELEASE/opt3 lx/rfc/nwsrfs/calb/bin/RELEASE/pxpp lx/rfc/nwsrfs/calb/bin/RELEASE/taplot lx/rfc/nwsrfs/util/bin/RELEASE/cvtgriddb lx/rfc/nwsrfs/util/bin/RELEASE/get_apps_defaults lx/rfc/nwsrfs/util/bin/RELEASE/looknset lx/rfc/nwsrfs/ifp/bin/RELEASE/IFP_Map lx/rfc/nwsrfs/ifp/bin/RELEASE/NWSRFS_no_startup lx/rfc/nwsrfs/ifp/bin/RELEASE/bin_to_ss_input lx/rfc/nwsrfs/ifp/bin/RELEASE/delete_atoms lx/rfc/nwsrfs/ifp/bin/RELEASE/delete_is_running lx/rfc/nwsrfs/ifp/bin/RELEASE/ifp_nwsrfs lx/rfc/nwsrfs/ifp/bin/RELEASE/parse_mods_by_segment lx/rfc/nwsrfs/ifp/bin/RELEASE/post_default_run_dates lx/rfc/nwsrfs/ifp/bin/RELEASE/print_prop lx/rfc/nwsrfs/ifp/bin/RELEASE/seg_sort lx/rfc/nwsrfs/ifp/bin/RELEASE/set_dates lx/rfc/nwsrfs/ifp/bin/RELEASE/startifp_done lx/rfc/nwsrfs/ifp/bin/RELEASE/working_dialog lx/rfc/nwsrfs/icp/bin/RELEASE/icp lx/rfc/nwsrfs/ens/bin/RELEASE/ens_post lx/rfc/nwsrfs/ens/bin/RELEASE/ens_post_cp lx/rfc/nwsrfs/ens/bin/RELEASE/ens_pre lx/rfc/nwsrfs/ens/bin/RELEASE/ens_pre_cp lx/rfc/nwsrfs/ens/bin/RELEASE/espadp lx/rfc/nwsrfs/ens/bin/RELEASE/espts_conv lx/rfc/nwsrfs/ens/bin/RELEASE/espvs lx/rfc/nwsrfs/ens/bin/RELEASE/print_ts lx/rfc/nwsrfs/ens/scripts/run_espvs lx/rfc/nwsrfs/ens/app-defaults/espvs.res lx/rfc/verify/bin/RELEASE/verify lx/rfc/xsets/bin/RELEASE/xsets lx/rfc/xdat/bin/RELEASE/ofstofs lx/rfc/xdat/bin/RELEASE/outputbadobs lx/rfc/xdat/bin/RELEASE/xdat lx/rfc/xnav/bin/RELEASE/ffgoutput lx/rfc/xnav/bin/RELEASE/make24hrxmrg lx/rfc/xnav/bin/RELEASE/make6hrxmrg lx/rfc/xnav/bin/RELEASE/makeXdaysxmrg lx/rfc/xnav/bin/RELEASE/wfoqpf lx/rfc/xnav/bin/RELEASE/xnav lx/rfc/nwsrfs/ffg/bin/RELEASE/ffguid lx/rfc/nwsrfs/ffg/bin/RELEASE/prodgen lx/rfc/nwsrfs/ffg/bin/RELEASE/zgrid lx/rfc/grib/bin/RELEASE/gribit lx/rfc/idma/bin/RELEASE/idma lx/rfc/ofsde/bin/RELEASE/ofsde lx/rfc/nwsrfs/ifp/options/ModSettings/ModDefinitions lx/rfc/verify/bin/RELEASE/ivp.jar lx/rfc/nwsrfs/ens/bin/RELEASE/batchbuilder.jar lx/rfc/nwsrfs/ifp/bin/RELEASE/sacsnow.jar lx/rfc/nwsrfs/util/bin/RELEASE/utilities.jar ================================================================================ 2. OFS RELEASE NOTES ================================================================================ Program New Name Version -------- ------- batchpst ob3-r24.0 - 08/29/03 espinit ob3-r24.0 - 08/29/03 fcinit ob3-r24.1 - 09/12/03 fcst ob3-r24.2 - 09/30/03 filecrat ob3-r24.0 - 08/29/03 filesize ob3-r24.0 - 08/29/03 goesdb ob3-r24.0 - 08/29/03 ppdutil ob3-r24.0 - 08/29/03 ppinit ob3-r24.0 - 08/29/03 prdutil ob3-r24.0 - 08/29/03 reorder ob3-r24.0 - 08/29/03 sasmdb ob3-r24.0 - 08/29/03 shefpars ob3-r24.0 - 08/29/03 shefpost ob3-r24.0 - 08/29/03 fcinit: The SNOW17 operation now has the option to define an observed snow depth time series. This allows users to display the Observed Snow Depth in the SNOW-17 table, and in the IFP and ICP snow model states displays. Fixed several problems related to punch output involving segments using the CONS_USE and FLDWAV operations, particularly FLDWAV operations which define values for MIXF and NFGRF. Fixed a problem with defining segments which used the the setwithdraw method in RES-J. fcst: Fixed a problem which caused a coredump when running a FLDWAV CGROUP. The problem occurred when a segment had been redefined to have different values for MIXF, KPLI, and NLPI. The change made for the UHGCHG mod to allow start and end dates to be specified for the mod was removed. Fixed a problem which resulted in a core dump when running batch forecast and carry over group runs with a segment defined to use the setwithdraw method in the RES-J operation. Fixed a problem which prevented ESP from running when two successive segments do not have carryover. The problem occurred when running ESP for a forecast group with a segment that had no operations with carryover (only contained LOOKUP and PLOT-TUL operations) and the segment immediately before this one also had no operations with carryover. Corrected a problem with an ESP run which incorrectly produced constant flows rather than limiting the change in flow for a segment using the SETDQ option within RES-SNGL. NOTE: The snow-17 model and the displays in IFP and ICP which plot the snow model states have been updated to display the observed snow depth, the simulated snow depth, and the simulated snow temperature. The simulated snow depth and snow temperature are computed in all cases. The carryover for the snow depth and the snow temperature are estimated from the other states if the segment has not been redefined with this release. If the segment is redefined, carryover for the snow temperature and snow depth will be computed and saved. To view the observed snow depth in the IFP or ICP displays, the segment must be redefined to include the Snow Depth (SNOG) data in the snow model. To get the data to the model, an RRS station must be defined which includes SNOG data. In some cases, stations have already been defined, but in such a way they do not create Processed Database Time Series (e.g., with a negative time step). If the SNOG datatype has not already been defined as a processed database datatype, the SNOG datatype must be defined with prdutil. Below is an example prdutil input file: DEFTYPE SNOG PRDTS2 0 31 1 END ppdutil: Corrected a problem with the EDITDLY function which did not allow all of the requested data to be edited. ppinit: Fixed a problem which caused errors when defining the general user parameters related to HRAP coordinates for SJU because it is outside the CONUS. Improved the creation of HRAP line segment information for some basins. This line segment information is used for mapx calculations and FFG. prdutil: Fixed a problem with the DUMPSHEF command which produced an ".E." instead of a ".E1" or ".E2" etc. for time series with more than one line of shef-encoded data. reorder: Resolved a problem with the work buffer being too small to write a one hour ROCL time series. Fixed a problem which occurred with the command "@STATUS LEVEL(2)" in the reorder input file. =============================================================================== 3. CALB RELEASE NOTES ================================================================================ Program New Name Version -------- ------- map ob3-r24.0 - 08/29/03 mape ob3-r24.0 - 08/29/03 mapx ob3-r24.0 - 08/29/03 mat ob3-r24.0 - 08/29/03 mcp3 ob3-r24.2 - 09/30/03 opt3 ob3-r24.2 - 09/30/03 pxpp ob3-r24.0 - 08/29/03 taplot ob3-r24.0 - 08/29/03 map: Increased the number of years of record which the preprocessor can handle to 100 years to match the PXPP program. mat: Increased the number of years of record which the preprocessor can handle to 100 years to match the PXPP program. mcp3: The temporary TEMP.RESJ. file created when MCP3 is run with a RESJ operation was moved to the user's home directory and a distinctive filename is created. These changes will allow multiple, simultaneous MCP3 runs. The format for the datetime suffix is .MMddhhmmss, where MM=month, dd=day, hh=hour, mm=minute, and ss=second. Code was added to check that any input for the RESJ operation which contains the EVAP key word also contains the ENDEVAP key word. If the ENDEVAP keyword is missing an error message is generated. opt3: Corrected a problem which resulted in the program hanging when processing 48 or more parameters in 20,000 loops. ================================================================================ 4. IFP RELEASE NOTES ================================================================================ Program New Name Version -------- ------- bin_to_ss_input ob3-r24.0 - 08/29/03 IFP_Map ob3-r24.1 - 09/10/03 NWSRFS_no_startup ob3-r24.0 - 08/29/03 delete_atoms ob3-r24.0 - 08/29/03 delete_is_running ob3-r24.0 - 08/29/03 ifp_nwsrfs ob3-r24.1 - 09/10/03 parse_mods_by_segment ob3-r24.0 - 08/29/03 post_default_run_dates ob3-r24.0 - 08/29/03 print_prop ob3-r24.0 - 08/29/03 seg_sort ob3-r24.0 - 08/29/03 set_dates ob3-r24.0 - 08/29/03 startifp_done ob3-r24.0 - 08/29/03 working_dialog ob3-r24.0 - 08/29/03 sac_snow.jar ob3-r24.0 - 08/29/03 IFP_Map Fixed a problem with Plot-TS which displayed incorrect units on the left axis when changing units from English to Metric. Removed the UHGCHG mod enhancement which was made in the previous release to allow start and end dates to be specified for the mod. Increased the maximum length allowed for the $HOME variable used within IFP to specify where to store the set of fs5files IFP uses. The problem occurred when trying to export the $HOME variable to a directory location with a name more than 80 characters long.. Fixed a problem which prevented the display of flood stage and LSTCMPDY on the Plot-TS graphic. Corrected a problem which resulted in a TSCHNG mod not taking effect if it was done after a SWITCHTS mod was applied. Fixed a problem which resulted in range mods being parsed to the OFS MODS window instead of the "OFS Fgroup/Range Mods" window. Corrected a parsing problem where a portion of the SACCO mod was being appended to the end of a SWITCHTS mod. The problem occurred when a SACCO and SWITCHTS mod were in the same mods file. Fixed a problem which resulted in incorrectly converting negative stage values to flows. Corrected the SAC display which wasn't properly showing adjustments after a SACCO mod. The dates used on the SACCO mod refer to the end of the computational period. The quantity being changed is the carryover being passed to the next time step. For example, if you change the carryover for a date, mm/dd/yy 12Z, then the mod will change the states at the end of the 12Z computational period, before those states are used to intiate the 18Z time step. Therefore, when you make a mod at 12Z, you will not see these values reflected in the Sac States display. That change will only be reflected in the output from the model for the 18Z time step. NOTE: Refer to the SNOW-17 model note in the OFS section. ================================================================================ 5. ENSEMBLE PROGRAM RELEASE NOTES ================================================================================ Program New Name Version -------- ------- batchbuilder.jar ob3-r24.0 - 08/29/03 ens_post ob3-r24.0 - 08/29/03 ens_post_cp ob3-r24.0 - 08/29/03 ens_pre ob3-r24.0 - 08/29/03 ens_pre_cp ob3-r24.0 - 08/29/03 espadp ob3-r24.1 - 09/10/03 espvs ob3-r24.1 - 09/10/03 print_ts ob3-r24.0 - 08/29/03 ens_pre: Fixed a bug which resulted in the use of climatology instead of the 1 to 5 day forecast for Temperatures. Modified the program to correctly interpret the changed format of the gridded files for the first month of a monthly/seasonal outlook. Now the issuance date is used to date the first monthly forecast. Corrected a problem to allow the program to work with gzipped calb data timeseries. espadp: Corrected a problem where accumulation settings for February yielded different results depending on whether the interval was set for monthly or for a window from February 1 through February 28. Fixed a problem with the exceedance probability graphic displaying incorrect probabilities when year weights are used. espvs Modified to allow all segments to be accessible from the pop up menu even if more than 44 segments are contained in a carryover group. Fixed a problem in ESPVS which resulted in the fcst program not creating a time series because of a problem with saving carryover in fcst. NOTE: In order to run the espvs GUI, you have to run the script "run_espvs" which is located in the directory $(ens_dir)/scripts. ================================================================================ 6. ICP RELEASE NOTES ================================================================================ Program New Name Version -------- ------- icp ob3-r24.2 - 09/30/03 icp: NOTE: Refer to the SNOW-17 model note in the OFS section. ================================================================================ 7. X PROGRAM RELEASE NOTES ================================================================================ Program New Name Version -------- ------- outputbadobs ob3-r24.0 - 08/29/03 xdat ob3-r24.0 - 08/29/03 xnav ob3-r24.0 - 08/29/03 xsets ob3-r24.0 - 08/29/03 ofstfs ob3-r24.0 - 08/29/03 ffgoutput ob3-r24.0 - 08/29/03 make24hrxmrg ob3-r24.0 - 08/29/03 make6hrxmrg ob3-r24.0 - 08/29/03 makeXdaysxmrg ob3-r24.0 - 08/29/03 wfoqpf ob3-r24.0 - 08/29/03 xnav: The program was modified to work with the changes made in the IHFS database for OB3 as well as the OB2 version. Fixed a bug that caused an incorrect shef message when editing data listed under the "Other PE Data" menu from informix. The data was coded as PP data, and it is now coded with the correct PE. xsets: The program was modified to work with the changes made in the IHFS database for OB3 as well as the OB2 version. Fixed a bug that caused an incorrect time zone in the text product when the xsets_time token is set to anything other than Z. Corrected a problem which resulted in some shef products being created without times and dates. ================================================================================ 8. UTIL RELEASE NOTES ================================================================================ Program New Name Version -------- ------- cvtgriddb get_apps_defaults looknset create_bas_bound convert_griddb: Corrected a problem converting xmrg files created prior to 9/15/99. create_bas_bound: Corrected a problem which caused the program to crash because of a stack growth error and memory fault. We have also delivered the create_bas_bound program in the util directory tree. You may move this to the geo directory or run it from the util directory. We moved it to the util directory in order to consolidate our delivery. ================================================================================ 9. IDMA RELEASE NOTES ================================================================================ Program New Name Version -------- ------- idma ob3-r24.0 - 08/29/03 ================================================================================ 10. VERIFY RELEASE NOTES ================================================================================ Program New Name Version -------- ------- verify ob3-r24.1 - 09/10/03 ================================================================================ 11. GRIB RELEASE NOTES ================================================================================ Program New Name Version -------- ------- gribit ob3-r24.1 - 09/10/03 ================================================================================ 12. SYS_FILES RELEASE NOTES ================================================================================ Release R24 does not include any changes in this area. ================================================================================ 13. SCRIPT RELEASE NOTES ================================================================================ Release R24 does not include any changes in this area. ================================================================================ 14. FFG RELEASE NOTES ================================================================================ Program New Name Version -------- ------- ffguid ob3-r24.2 - 09/30/03 prodgen ob3-r24.2 - 09/30/03 zgrid ob3-r24.2 - 09/30/03 ffguid: The problem of the 3 hour FFG values being less than the 1 hour FFG values for some areas has been fixed by having the FFG program interpolate a new value for the 3 hour ffg when it is found to be less than the 1 hour value. The User Control setup information can now be input from a file and output to a file. prodgen: The 3 hour Headwater FFG value is now set to the average of the 1 hour and 6 hour FFG values when it is less than the 1 hour value. The User Control setup information can now be input from a file and output to a file. zgrid: A zero is added before the 1, 3, and 6 in the gridro file names. ================================================================================ 15. OFSDE RELEASE NOTES ================================================================================ ofsde: corrected a problem that resulted in memory fault messages when data tables were empty ================================================================================= 16. WHFS RELEASE NOTES. ================================================================================= Release R24 does not include any changes in this area. ================================================================================= 17. DOCUMENTATION NOTES. ================================================================================= Updated documentation will be provided to cover the changes made for: Snow-17 Glacier Operation UHGCHNG mod. ================================================================================ 18. CONTACT INFORMATION ================================================================================ If there are any questions, please contact the HSD RFC support team.