 |
|
|
Name:
Auto_Review - Review time-series stage-discharge, stage-only, reservoir contents, reservoir elevation, groundwater-level, partial-record CSG, partial-record measurement only, and water-quality monitor data using tkg2/text or PDF graphs and tables. Package includes the swreview, wqmreview, and gwreview scripts for manually producing SW, WQ-monitor, and GW level records respectively, as well as various other utility scripts for batch and cron updating of SW and GW-level output.
Information:
Auto_Review facilitates the reviewing of many common time-series records by combining many graphical elements within several tkg2 or PDF graphs along with Adaps, QWDATA, GWSI, and Auto_Review-generated tabular data in a text or PDF format. It is somewhat similar, but simpler, than the graphical and tabular products from Baseplot. Detailed information can be found in the readme.autoreview, readme.swreview, readme.gwreview, and readme.wqmreview documents. Currently the Auto_Review package includes three main scripts, swreview, gwreview, and wqmreview, used to produce electronic record material for time-series SW, GW and water-quality monitor records, respectively.
Current time-series records supported include most stage-only, reservoir contents, reservoir elevation, stage-discharge, partial-record CSG (with appropriate DD's setup), partial-record measurement only (with appropriate DD's setup) groundwater-level, and water-quality monitor (WT, SC, pH, DO, and TBY parameters...) records as of version 4.11.0+.
The swreview script was updated in version 3.0 to run both interactively and as a cron job that attempts to keep station output updated to a central storage area as stations are updated in the NWIS database. Default viewing of files was switched from viewing tkgs/text files in the Unix environment during interactive runs of the script to viewing pdf files in the Windows environment after automatic updates (although plots and tables can still be updated manually if automatic updates do not occur fast enough – speed of automatic updates depends on timing of the cron process as well as the number of stations recently updated and may take several hours if many stations have been updated in a short period of time).
Wqmreview does not have cron/batch capabilities at this time, but may be added at a later date pending results of the Commercial ADAPS Replacement Project (CARP) - if functionality is included in that software package, script will be discontinued with release of that software.
The central storage area used for file output can be used as an “electronic records packet” potentially eliminating the need to maintain updated hard copies of the items as well as helping facilitate remote check and review of records. Additional materials can also be relatively easily added to the central output directories by users if desired (hydra sessions saves, pictures, station description saves, etc…).
That storage area can be made available on the internet from a WSC web-server and links can be placed to the output from SIMS and RMS station pages. File access is generally quicker with this setup but filesystem access is still required to add files to that area or manipulate, rename, etc.. files there. Once files are available for web access on a WSC webserver, contact GS-W_Help_SIMS@usgs.gov to have the links added to WSC SIMS/RMS pages. See the "Click here to view SW Review (if applicable)" links below the "Continuous Records Processing:" heading from the SIMS Station Information Page links below for some examples:
http://water2.wr.usgs.gov/field/sqlsims/StationInfo.asp?office_id=42&site_id=6002061
http://water2.wr.usgs.gov/field/sqlsims/StationInfo.asp?office_id=50&site_id=6004254
A WSC website can also be set up to display the files if that is preferred, but it can add extra potential for problems and adds additional maintenance. See WI Swreview Files Program (SFP), KS SWR/QWMON PDF viewer, or New England AUTOSWR Chooser.
Usage:
Swreview and gwreview can be run either by passing the required information to the script using command line arguments or by letting the script prompt for the required data. Updates can also be automatically timed or batch processed with the included swreview_bat script. The basic structure of the command line is:
If the command line arguments are not given they are prompted for within the script and the user is given the opportunity to update and save the main menu settings for that particular station as well as the option to run on a period other than a specific water year (no more than 12 months – crossing water year boundaries can cause problems with monthly uv plotting).
See the readme.swreview, readme.gwreview, or Auto_Review_gwreview.pptx files below for additional information.
Wqmreview can currently only be run interactively by initiating the base script and answering the prompts for the required information. Command line, batch, and cron capabilities may be added at a later date.
See the readme.wqmreview file or Auto_Review-wqmreview ppt below for additional information.
Documentation:
readme.wqmreview.pdf
readme.auto_review.pdf
readme.swreview.pdf
readme.gwreview.pdf
Auto_Review-wqmreview.pptx
Auto_Review-gwreview.pptx
Known Problems/Limitations/Need Improvements:
swreview_knownproblems_enhancements.xls
Installation (Note--package includes the swreview, gwreview and wqmreview scripts)
Auto_Review_4.11-4_update_instructions.pdf
Auto_Review 5.00-3 upgrade instructions for NWIS 5.00 (Auto-Review versions 1.0-8 or greater currently installed - rpm -q Auto_Review to check.)
Auto_Review_5.00_update_instructions.pdf
See also this important technical note.
Latest Version Release Notes: posted 11/8/12
Auto_Review_V4.11-4_Release_Notes.pdf
Auto_Review_V5.00_Release_Notes.pdf