skip to main content
Stream Gage
Objects and Methods
Stream Gage
This object models a measuring point in a water system. The Gage Inflow is automatically linked to the Gage Outflow.
General Slots
Gage Inflow
Type: SeriesSlot
Units: FLOW
Description: flow into the gage
Information:  
I/O: Optional; either Inflow or Outflow must be known.
Gage Outflow
Type: AggSeriesSlot
Units: FLOW
Description: flow out of the gage
Information:  
I/O: Optional; either Inflow or Outflow must be known.
If both Gage Outflow and Gage Inflow are input, a RiverWare error is posted and the run is aborted.
User Methods
Conditional Flow
The Conditional Flow category allows the Gage Inflow slot to be set if the Fractional Flow method has been selected.
* None
The None method is the default for the category. This method does not add or set any slots.
* Fractional Flow
This method, called from the Solve Gage Flow dispatch method, compares two user specified flow conditions and sets the Gage Inflow slot. Once the Gage Inflow slot has been set, that value will immediately propagate to the Gage Outflow slot because the two are linked.
Slots Specific To this Method
Condition One
Type: Series Slot
Units: FLOW
Description: A slot for comparing two conditions that will affect the Gage Inflow slot
Information: This is a dispatch slot that will trigger the object to resolve if its value changes. Values are received via: links, user input, or set by rules.
I/O: Required Input
Condition Two
Type: Series Slot
Units: FLOW
Description: A slot for comparing two conditions that will affect the Gage Inflow slot
Information: This is a dispatch slot that will trigger the object to resolve if its value changes. Values are received via: links, user input, or set by rules.
I/O: Required Input
Normal Flow
Type: Series Slot
Units: FLOW
Description: Timeseries of values of Inflow.
Information: When slot Condition One is equal to or greater than slot Condition Two, the Gage Inflow is set to Normal Flow.
I/O: Required Input
Loss Factor
Type: Periodic Slot
Units: NONE
Description: schedule of factors specifying fraction of water remaining after conveyance losses upstream of the gage object. Different rows represent different time points in the schedule, while one column specifies Fraction and the other column specifies Constant. The units on the Constant column are NONE; however the values in this column are treated as flow values with units of cms.
Information: This is a n x 2 periodic slot where the user specifies the period over which the schedule repeats (1 Year, 1 Month, etc.) and the slot has the capability to generate values for any date from the schedule.
I/O: Required Input
In the Fractional Flow method, Gage Inflow is conditional, determined through a comparison between the values in the slots Condition One and Condition Two. If the value in the Condition Two slot is greater than the value in the Condition One slot, the Gage Inflow slot is set to Constant plus Condition One multiplied by Fraction. Otherwise the Gage Inflow slot is set to value in the Normal Flow slot.
Gage Inflow is calculated as follows:
IF (Condition One < Condition Two)
ELSE
Stream Gage Stage
The Stream Gage Stage category contains methods allowing you to configure optional stage computations. The methods in the category are executed by both dispatch methods.
* None
The None method is the default for the category. This method does not add or set any slots. No stage is computed.
* Stage Table Lookup
The new Stage Table Lookup method looks up the Gage Inflow on a table and then sets the Stage slot.
Slots Specific to This Method
Stage Table
Type: Table
Units: Flow vs Length
Description: This table represents the relationship between flow and gage height.
Information:  
I/O: Required Input
Stage
Type: Series
Units: Length
Description: The timeseries of the stream gage water surface elevation
Information: The elevation datum is up to the user. If you are comparing to other objects, then a consistent datum is necessary.
I/O: Output only
Method Details
When executed, this method looks up the Gage Inflow on the Stage Table and sets the Stage slot.
Note:  This method only computes the Stage, it does not do the reverse lookup to compute the flow from the Stage.
Dispatch Methods
The dispatch methods are available if either of the two user categories has a non-default method selected (i.e. any method selected except None)
* Solve Gage Flow
This method is available when the Fractional Flow method is selected. This method solves for Gage Inflow when Condition One and Condition Two of the Fractional Flow method are known. The value set in the Gage Inflow slot automatically propagates to the Gage Outflow slot.
Required Knowns
Required Unknowns
Method Details
The dispatch method will simply execute the selected Conditional Flow method and set Gage Inflow if it has been computed by the Conditional Flow method.
It then calls the selected Stream Gage Stage method. If the Stage Table Lookup method is selected, the Stage is set.
* Solve Gage
This method is only available when the Stage Table Lookup method is selected, but the Fractional Flow method is not selected. Since Gage Inflow is linked to Gage Outflow, the only purpose of this dispatch method is to execute the selected Stage method.
Required Knowns
Required Unknowns
• None
Method Details
The dispatch method calls the selected Stream Gage Stage method. If the Stage Table Lookup method is selected, the Stage is set.
 
Revised: 06/03/2019