 |
|
|
Name:
SMART - A utility to automatically determine and apply shift curves based on new discharge measurements in SiteVisit.
Information:
The Standard Methods Automated Records Tool (SMART) is a utility designed to automate the application of shift corrections to a standard stage-discharge rating using a one, two, or three-point shift-adjustment variation diagram (V-diagram) based on new measurements entered into SiteVisit. While the script is primarily designed to run automatically as measurement are entered via the SiteVisit Loader, it can also be run manually after measurements are entered by hand via SiteVisit Quick Entry. Once a measurement is entered, SMART evaluates that measurement against the base and current shift adjusted rating, determines the appropriate shift based on the current shift and the appropriate shift timing based on the unit values, and inserts the newly modified shift. In some cases a new shift will not be applied due to limitations on the types of automated shifting allowed (see Limitations section below). In all cases an email is sent to interested parties with a summary of the measurement and the actions taken by SMART.
SMART is highly configurable, both at the site and the database level. For best results the install and user manuals should be reviewed carefully prior to use.
SMART is based on the Automated Records Tool (ART) originally developed by Indiana Water Science Center and used in several Water Science Centers. SMART, however, takes a more restrictive view of allowable shifting that is thought more hydraulically justifiable in a national application. Some of the shifts that would be applied by ART will be rejected in SMART.
Users of SMART are strongly encouraged to join the the SMART user group alias (GS-W SMARTUserGroup) to be kept informed of SMART updates and other related information. To join, please send your request to jkiesler@usgs.gov.
Limitations:
There are several limitations to the methodologies implemented in SMART.
Details on the SMART shift methodology are provided in the document SMARTShftDiscussion.docx provided in the release package below.
Details on how to run SMART are provided in the UsageInstruction.docx in the release package.
SMART cannot be used as a substitute for the application of hydraulic knowledge by experienced hydrographers. In some cases SMART based shifts will require modifications. In ALL cases SMART based shifts need thorough review and evaluation.
Installation:
Please carefully review and follow the install instructions file InstallInstructions.docx included in the release package below.
Install Instructions Revised—Revised install instructions adding smartman to C-shell rather then Korn Shell (11/21/11).
Script Language:
Perl
Requirements:
Any specific requirements are included in the install instructions.
Original Author(s): Jay Kiesler, Indiana WSC
Known Problems/Limitations/Need Improvements:
This is the first step in what is hoped to be a suite of automated records tools. There are lots of enhancements that could be made to the application of shifts, but there is also work to be done with data corrections, estimating missing or ice records, integration with field computing applications, etc. Some limited enhancement of SMART may be done in the short term, but other work will be deferred until the implementation of the Commercial ADAPS Replacement Project (CARP) software.
Scripts: