Versions Compared

Key

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

...

  • TimeSeriesDisplayConfig.xml (SystemConfigFiles)
    • <thresholdDisplayConfig>
    • <timeMarkerDisplayConfig>
      • <threshold>
    • <generalDisplayConfig>
      • <onlyShowThresholdsSharedByAllSeries>
      • <thresholdGroupSelectionButton>
      • <showValidationRules>
  • RainfallForecastSummary.xml (DisplayConfigFiles)
  • Topology.xml
    • <thresholdValueSetId> - to show threshold crossings for specific location at a node in the Topology display
  • Multi value thresholds (MapLayerFiles)
  • Transformations
    • <multipleOutputlocationThresholds>
  • event actions, see https://publicwiki.deltares.nl/display/FEWSDOC/Event+and+Actions

Contents

Table of Contents
excludeContents

General configuration options for threshold groups

eventExpiryTime: Optional expiry time for threshold events in the ThresholdEvent table in the database. If not configured the default expiry time of the system is applied to the threshold events.

...

forecastAvailableThreshold: Optional threshold that triggers forecast available threshold events. If this is specified, then forecast available events will be logged and these events can then be used in the SkillScoreDisplay. A forecast available threshold event indicates if there is a forecast available for a given observed threshold crossing event.

ThresholdGroup

A threshold group is a collection of one or more thresholds. The groups can be used to apply multiple threshold for displaying in graphs or generating reports. Each group can contain any number of level thresholds, rate thresholds and max value thresholds. For each threshold group it is possible to define a default threshold. The default provides extra information for the state in which no thresholds are crossed. The state in which no thresholds are crossed always corresponds to the least severe warning level in the thresholdWarningLevels configuration file. The least severe warning level is used e.g. to get the color to display in the user interface when no thresholds are crossed.

Level Threshold

A threshold that triggers a threshold event if a certain level is crossed upwards or downwards. For this type of threshold it is possible to configure an upWarningLevelId or a downWarningLevelId. There are also options to configure upIntId and downIntId, both of which are deprecated and should not be used when making new configurations.

...

Similar to the Id's used, a warning level integer can be assigned to threshold crossings. This warning level is resolved to either an icon (for display in the main FEWS GUI), or a colour (for use in reports or schematic status displays). Warning levels need not be unique. If not specified this id will be generated automatically. Internally DELFT-FEWS maintains threshold events as a non-equidistant time series, where the crossings are identified by an integer. For each threshold two unique integer Id's need to be assigned. One ID is used to identify the upcrossing of the threshold, the other Id is assigned to identify the downcrossing. The exception to this is the peak threshold where only a single Id needs to be assigned to identify the occurrence of the peak event. Note: in the new thresholds configuration approach (thresholdGroups) these ids are optional and will be generated when not specified in configuration.

Rate Threshold

A threshold that triggers a threshold event if the rate of change of data values becomes higher or lower than a certain rate, e.g. -0.1 m per hour.

...

See level thresholds for more information about the up and down ids.

Max Threshold

A threshold that triggers a threshold event if there is a peak (maximum) in the data. The peak has to be higher than a certain level and has to be the maximum within a certain time window. If a maximum is at the end of a time series, then it does not count as a peak.

...

See level thresholds for more information about the up and down ids.

Event Threshold

An event threshold is similar to a level threshold, only it has the possibility to be based on correlation events.

...

Code Block
xml
xml
<thresholdValueSet id="EventThresholds" name="EventThresholds">
   <eventThresholdValues>
      <eventThresholdId>LevelWarn</eventThresholdId>
      <valueFunction>@PEAK_HEIGHT_VALUE@</valueFunction>
      <labelFunction>@PEAK_HEIGHT_TIME@</labelFunction>
      <parameterIdFunction>@PEAK_HEIGHT_PAR@</parameterIdFunction>
      <enabledFunction>@PEAK_HEIGHT_ENABLED@</enabledFunction>
   </eventThresholdValues>
   <timeSeriesSet>
      <moduleInstanceId>ThresholdCheck</moduleInstanceId>
      <valueType>scalar</valueType>
      <parameterId>H.m</parameterId>
      <locationSetId>MultiValuedAttributeThresholds</locationSetId>
      <timeSeriesType>external historical</timeSeriesType>
      <timeStep unit="hour" divider="1" multiplier="1"/>
      <readWriteMode>add originals</readWriteMode>
   </timeSeriesSet>
</thresholdValueSet>

Schema Thresholds.xsd

Image Removed

Level Threshold definition

Image Removed

Rate Threshold definition

Image Removed

Max Threshold definition

Image Removed

ThresholdWarningLevels

...

Different threshold warning levels can be defined. They need to be in order of increasing severity. First level defined is always the no-threshold-cross level.

...