Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Wiki Markup
{scrollbar}

Information

Transformation:

Power

Transformation Group:

StageDischarge

Description:

Converts stage (H) to discharge (Q) for an open cross section. Uses equation

Code Block
 Q=a*(H+b)^c 

.

Hydrological Information

Purpose and use of Transformation:

Used to convert stage (water level) to discharge (water flow) for an open cross section.

Background and Exceptions:

 

Input

stage input variable with stage (water level) values.

CoefficientSets or CoefficientSetFunctions

The coefficient set should contain the a, b and c coefficients for equation

Code Block
 Q=a*(H+b)^c 

and the type of calculations for which the coefficient set is valid.

When using coefficient set functions (available since build 30246), the a, b, c and type elements can contain tags between "@" signs (e.g. "@NUMBER@") that refer to location attributes that are defined in the locationSets configuration file. The tags are replaced by actual values. These values can be different for different locations and time periods. See 22 Locations and attributes defined in CSV files, Shape-DBF files or external tables for more information.

a

Coefficient a in equation

Code Block
 Q=a*(H+b)^c 

.

b

Coefficient b in equation

Code Block
 Q=a*(H+b)^c 

.

c

Coefficient c in equation

Code Block
 Q=a*(H+b)^c 

.

type

Type of calculations for which the coefficient set is valid. Can be level_to_flow, flow_to_level or level_to_flow_and_flow_to_level.

Output

discharge output variable with discharge (water flow) values.

Configuration Example

Code Block
xml
xml
<variable>
	<variableId>input</variableId>
	<timeSeriesSet>
		<moduleInstanceId>StageDischargePowerTest</moduleInstanceId>
		<valueType>scalar</valueType>
		<parameterId>H.m</parameterId>
		<locationId>location1</locationId>
		<timeSeriesType>external historical</timeSeriesType>
		<timeStep unit="day"/>
		<relativeViewPeriod unit="day" start="0" end="60"/>
		<readWriteMode>editing visible to all future task runs</readWriteMode>
	</timeSeriesSet>
</variable>
<variable>
	<variableId>output</variableId>
	<timeSeriesSet>
		<moduleInstanceId>StageDischargePowerTest</moduleInstanceId>
		<valueType>scalar</valueType>
		<parameterId>Q.m</parameterId>
		<locationId>location1</locationId>
		<timeSeriesType>external historical</timeSeriesType>
		<timeStep unit="day"/>
		<relativeViewPeriod unit="day" start="0" end="60"/>
		<readWriteMode>add originals</readWriteMode>
	</timeSeriesSet>
</variable>
<transformation id="stage discharge power test">
	<stageDischarge>
		<power>
			<stage>
				<variableId>input</variableId>
			</stage>
			<coefficientSet>
				<a>57.632</a>
				<b>3.01</b>
				<c>2.147</c>
				<type>level_to_flow_and_flow_to_level</type>
			</coefficientSet>
			<discharge>
				<variableId>output</variableId>
			</discharge>
		</power>
	</stageDischarge>
</transformation>

The example below uses coefficientSetFunctions (available since build 30246). Here the elements 'a', 'b', 'c' and 'type' are defined in coefficientSetFunctions, where @A@, @B@ and @C@ refer to location number attributes and @type@ refers to a location text attribute defined in the locationSets configuration file.

Code Block
xml
xml
<variable>
	<variableId>input</variableId>
	<timeSeriesSet>
		<moduleInstanceId>StageDischargePowerWithCoefficientSetFunctionsTest</moduleInstanceId>
		<valueType>scalar</valueType>
		<parameterId>H.m</parameterId>
		<locationId>locationWithAttributes1</locationId>
		<timeSeriesType>external historical</timeSeriesType>
		<timeStep unit="day"/>
		<relativeViewPeriod unit="day" start="0" end="60"/>
		<readWriteMode>editing visible to all future task runs</readWriteMode>
	</timeSeriesSet>
</variable>
<variable>
	<variableId>output</variableId>
	<timeSeriesSet>
		<moduleInstanceId>StageDischargePowerWithCoefficientSetFunctionsTest</moduleInstanceId>
		<valueType>scalar</valueType>
		<parameterId>Q.m</parameterId>
		<locationId>locationWithAttributes1</locationId>
		<timeSeriesType>external historical</timeSeriesType>
		<timeStep unit="day"/>
		<relativeViewPeriod unit="day" start="0" end="60"/>
		<readWriteMode>add originals</readWriteMode>
	</timeSeriesSet>
</variable>
<transformation id="stage discharge power with coefficient set functions test">
	<stageDischarge>
		<power>
			<stage>
				<variableId>input</variableId>
			</stage>
			<coefficientSetFunctions>
				<a>@A@</a>
				<b>@B@</b>
				<c>@C@</c>
				<type>@type@</type>
			</coefficientSetFunctions>
			<discharge>
				<variableId>output</variableId>
			</discharge>
		</power>
	</stageDischarge>
</transformation>