AWIPS Build OB9.2 Release Notes

NWS/Office of Hydrologic Development (OHD) - Hydrologic Software Engineering Branch

NWS/Office of Climate, Water, and Weather, Services (OCWWS) – Hydrologic Support Branch

November 05, 2009

The OHD Common software is delivered to both WFOs and RFCs. It includes the:

         WHFS (WFO Hydrologic Forecast System) components

         Precipitation Processing System (e.g. MPE) components

         Data Ingest (e.g. SHEF_decode) components

The release notes and related information are available at: http://ocwws.weather.gov/intranet/whfs/

A. Hydrologic IHFS Database

1. There are no table schema and database definition changes to the IHFS database in OB9.2. The database was renamed per the naming convention: hd_ob92xxx.

B. Multi-Sensor Precipitation Estimation (MPE) Operations

B.1 Gage Precipitation Pre-processor

1. Fixed a bug related to the use of the “shef_duplicate” token value of “USE_REVCODE”. The gage_pp process uses the value of this shefdecode token. Logic related to the use of this token value now works properly.

B.2 MPE_Fieldgen

1. Added the option to read the raw Q2 product and generate two new QPE fields: a local-bias corrected Q2 field and a multi-sensor field using the local-bias corrected Q2 field.

2. Adjusted the check of users specified fields to generate (as defined in the mpe_generate_list token) to deal with grid dependencies regarding the SRG satellite products.

3. Changed multi-sensor field generation logic to correct a problem with the case of no gages reporting.

4. Changed generation of the Height field to show “missing” value instead of “>10000” in areas well beyond the radar coverage.

5. Fixed log output generated from QC checks to properly report which QC check failed.

6. Fixed problem where mpe_locbias_1hr_rerun token set to OFF caused SRG fields to treat satellite and radar fields as missing.

7. Added check for 15 minute after the hour SPE product if no top-of-the-hour SPE product was found.

B.3 MPE Editor General

1. Added options to display three new fields: the raw Q2 field, the local-bias corrected Q2 field, and the multi-sensor field using the local-bias corrected Q2 field.

2. Added following new columns to the Gage Table: Edit column, Difference column. The Edit column allows the user to enter in a new value, while still displaying the current value. The Difference column allow the user to display a computed difference between the gage value and the gridded field value at the gage, for the gridded field selected by an option menu in the Gage Table window.

3. Added the ability to save column and ordering preferences used in the Gage Table. The preferences is saved by using the File option in the menu bar of the gage table window.

4. Improved method for handling the deletion of polygons associated with the Best Estimate QPE grids. Without this delete, previously drawn polygons were being scaled a second time when new polygons were added. Both persistent and non-persistent polygons are deleted.

5. Fixed polygon problem related to creation of snow polygons. The problem occurred if a snow polygon was created, could not create a different type of polygon.

6. Expanded the Edit Polygon window size to allow display of up to 18 precipitation fields.

7. Fixed problem with polygons drawn on MMOSAIC (field-bias adjusted multi-sensor mosaic) grid. Problem was that bad values were displayed in the polygon area after a rerun.

B.4 DailyQC Preprocessor

1. Changed how the DailyQC Pre-processor handles cooperative observer max/min temperatures. The Pre-processor evaluates the validity of Max/Min temperature based on if the report is completely contained within DailyQC 12Z-12Z day. However, many COOP observer reports have valid reports with valid time after 12Z. These reports were failing to be retrieved as max/min temperature.

2. The new DailyQC Preprocessor includes a new token “mpe_maxminT_hour_window” to set the hour window around 12z (default is 2 hours) when retrieving the Max/Min temperature.

B.5 MPE/DailyQC

1. On the QC Freeze Options window, units changed to 1000’s of feet.

2. On the QC Temp Options window, the top value on the Point Reverse Filter was changed to 125.

3. Changed the logic in the Temperature Consistency Check for checking the 6-hour temperature values against the max/min temperatures. The new logic checks that both the max and min values are available and then compares the 6hr value against both. Result is fewer temperature values with QC code = “Q”.

4. Added options to output grids in netCDF and grib format. 1) The netCDF files generated by the DailyQC functions are now provided in Graphics Forecast Editor (GFE) compatible format so that they can be imported into GFE if desired. 2) In addition, the GFE compatible netCDF grids from DailyQC can be transformed into GRIB1 format for use in the Community Hydrologic Prediction System (CHPS). 3) Sites can also save MPE/DailyQC grids directly to GRIB1 files which can be imported into CHPS. 4) The QPE GRIB1 grids from MPE/DailyQC are created with the appropriate WMO header allowed them to be transmitted and used for the National Precipitation Verification Unit (NPVU). These new operations are documented in the MPE documentation and CHPS documentation.


Two new tokens were added to allow sites to save the grids in either or both of these formats: mpe_dqc_save_netcdf and mpe_dqc_save_grib. The NetCDF files will have an “.nc” extension and the GRIB1 files will have a “.grib” extension. There are three other tokens which sites need to specify so the files are created with the correct mapping properties. Nominal values are in parentheses: mpe_dqc_gridtype (SCALAR), mpe_dqc_projectiontype (POLAR_STEREOGRAPHIC), and mpe_dqc_lonorigin (-105). These may be different for a site's default GFE grid.

5. Added new “Save Data” popup window to allow user to select which type of data (Precip/Temperature/FreezingLevel) to save. User must make a choice from this window or else no data will be saved.

6. Added new popup window to warn user if the four 6-hour precipitation values do not equal the 24hr value. Added new token to turn off this feature.

7. Changed format and functionality of the 6/24hour (bottom) portion of the Choose EditMode/Data Period window. Added display of the current Z time to the window. This was done because the number of periods available to display within MPE/DailyQC depends on the current Z time. For example, if the “Num of Days” value on the window is set to 1 and the current Z time is before 18z, then MPE/DailyQC will display four 6hr periods and one 24hr field ending at 12z today. If the time is say 1830z with Num of Days set to 1, this is a “partial” Hydrologic Day and MPE/DailyQC will display one 6hr period (12z-18z). The 24hr period will display as all missing.

8. On the QC Precipitation Options window, modified its behavior so that the first time it pops up it will always be set to the 24-hour mode.

9. Changed behavior to allow user to edit a Time Distributed precipitation value. Previously, an attempt to edit a Time Distributed value would result in a popup window saying that the edit was not allowed.

C. Hi-Resolution Precipitation Estimator (HPE)

1. Resolved grid handling for Pacific region. Specifically, adjusted the GRIB encoder application (gribit), which translates XMRG format files to GRIB1 files. Previously, gribit would not support grids for Hawaii due to it’s location far outside the HRAP grid. Therefore, High-resolution Precipitation Estimate (HPE) grids would not be available to AWIPS or FFMP. The OB9.2 version of gribit now allows AWIPS to store HPE grids for use by other programs such as FFMP in the Hawaii area. (DR #20522)


D. DamCrest

1. Fixed problem where new DamCrest scenarios could not be saved to the database. (DR #15334)

E. HydroGen

1. Corrected encoding of XML file so the originating offices is properly defined when in backup mode. (DR #20857)

F. TimeSeries

1. Adjusted ordering of type sources in main TimeSeries window used for selecting which time series to graph/tabulate. The default display list for type source elements is based on the following type code ordering:




M - Model



In the Time Series Display Control Window, a drop menu button was added to allow the user to choose which Type Source element to display at the top of the list for a given station.

The new button is called TS order and it has the following most used type source options



RZ Nonspecific observed reading FF

FF Forecast includes QPF

FX Unadjusted model 4

FZ Nonspecific forecast data (default for this type category).

Only the top-listed item can be re-ordered. There is no way to save the order for future recall when changing stations or restarting the application.
(Raytheon DR #19013)

G. RiverPro

1. Adjusted the format of the Mass News Disseminator header date field so that the leading zero for the day of the month is not included for dates for the first nine days of the month. (Raytheon DR #20269)


H. HydroBase

1. Fixed bug where HydroBase aborted when null values are in the Location table. (Raytheon DR #20677)

I. Utility Programs

I.1. Purge_MPE_Files

1. Added 4 new directories related to the Q2 grids to the purge process.

I.2 Process Management

1. The OHD amirunning script was adjusted in OB92 to allow proper operation since it no longer worked as of OB91 because of the operating system changes. The solution was to ensure that an “exit” command existed in all the calling scripts so that the calling script would still be considered active by the amirunning script until the calling script completed its shell operations. (Raytheon DR #20944)

I.3 System Configuration

1. All sites had their /home partition increased to approximately 100G.

2. All RFCs had their /data/local/partition increased to approximately 148G.