Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

scrollbar

What

ThresholdValueSets.xml

Required

no

Description

definition of threshold values for all locations and data types

schema location

http://fews.wldelft.nl/schemas/version1.0/thresholdValueSets.xsd

...

  • The values and what type each value is
  • (Optional) Stage/Discharge conversions
  • The timeSeriesSet a thresholdValueSet is associated with

When thresholds are crossed, a log entry will be made. It is common practice to use this logging to initiate an action by the Master Controller when using thresholds in a live forecasting system. EventTypeIds (otherwise known as EventCodes) are used as a prefix in logging messages for the MC to identify which threshold is Thresholds can be used for display purposes in the graphs, spatial display, icons in the map or in reports. It is also possible to have messages logged when thresholds are crossed.

What are the different value types?

...

  • What thresholds are stage and discharge
  • What timeseries are stage and discharge
  • What ratingCurves need to be used and consequently how to convert between stage and discharge values

...

Now the stage thresholds will be converted to discharge thresholds and vice versa after which they are assigned to the timeSeriesSet. So the stage and converted discharge thresholds will be assigned to the timeSeriesSets that were placed in the stage element. And similarly, the discharge and converted stage thresholds will be assigned to the timeSeriesSets in the discharge element.

Threshold Module

Thresholds can be used to log messages when threshols are crossed. A predefined workflow activity must be activated in a workflow to have threshold crossings logged. 

Code Block
xml
xml
titleThreshold Module Activity
	<activity>
		<runIndependent>true</runIndependent>
		<predefinedActivity>threshold event crossing</predefinedActivity>
	</activity>

It is common practice to use the log messages to initiate an action by the Master Controller when using thresholds in a live forecasting system; check the Event Action Mappings documentation in the system admin pages.

EventTypeIds (otherwise known as EventCodes) are used as a prefix in logging messages for the MC to identify which threshold is crossed. When threshold messages need to be logged, a special predefined threshod activity is required in the workflows.

 

Code Block
xml
xml
titleThreshold Log Messages
<levelThresholdValue>
			<levelThresholdId>UKV</levelThresholdId>
			<valueFunction>1</valueFunction>
			<upActionLogEventTypeId>UKVRRCThreshold.crossed</upActionLogEventTypeId>
		</levelThresholdValue>

 

Schemas

ThresholdValueSet

contains level- and/or rate- and/or max-thresholds set for a given time series

...