...
- The values and what type each value is
- (Optional) Stage/Discharge conversions
- The timeSeriesSet a thresholdValueSet is associated with OR (since 2024.02) the timeSeries filter a thresholdValueSet is associated with
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.
...
ThresholdValues are associated with all timeSeriesSets that are defined in the same thresholdValueSetSequence (With some extra associations for Stage/Discharge conversions). When the unit of the threshold values do not correspond with the internal unit, the unit element can be used to define the unit of the threshold values do not correspond with the internal unit, the unit element can be used to define the unit of the threshold valuesof the threshold values.
When configuring thresholdValueSets, make sure to only configure one thresholdValueSet per unique timeseriesSet. If the same timeseriesSet is used in a second thresholdValueSets, the FEWS code will ignore this second thresholdValueSet. When the FEWS system is started, an ERROR message will be logged when there are multiple thresholdValueSets configured for the same timeseriesSet.
TimeSeries Association
Since 2024.02, ThresholdValues can also be associated with timeSeries that are defined in the same thresholdValueSetSequence. The timeSeries act as a filter to determine which timeSeriesSets the thresholdValueSet is associated with. This is particularly handy to associate a thresholdValueSet with all timeSeriesSet for a parameter group. Note that the valueType always has to be specified and be either scalar or sample. One thresholdValueSet can have either timeSeries or timeSeriesSets defined in its configuration, not both. This option is not yet implemented for all types of thresholdValueSets. It can be used with:
- levelThresholdValues
- maxThresholdValues
but it cannot be used for rateThresholdValues, stage/discharge conversions and forecastAvailableThresholdValue.
When configuring thresholdValueSets, make sure to only configure one thresholdValueSet per unique timeseriesSet, also if defined through a timeSeries. If the same timeseriesSet is used in a second thresholdValueSetssecond thresholdValueSets, the FEWS code will ignore this second thresholdValueSetsecond thresholdValueSet. When the FEWS system is started, an ERROR message will be logged when there are multiple thresholdValueSets multiple thresholdValueSets configured for the same timeseriesSetsame timeseriesSet.
Stage/Discharge conversions
...
One or more warnings that correspond to this threshold for the configured timeSeriesSet(s) or timeSeries. These warningAreas are e.g. used in the ThresholdOverviewDisplay threshold crossing counts tabs.
...
Another example is showing the configuration for rainfall data. Different functionality is included in the thresholdValueSet shown below. The timeseriesSet is a 15 minute rainfall set for all raingauges rain gauges in a country. The rateThresholdValue element will check 24 hour accumulated rainfall totals and check these total values against a location attribute value @IFD_10Y_24h@. When this total value is crossed for a location, a log messages and event action message is logged. This event action has a grace time of 1 day, this means that if more 24 hour total values are crossed within a 24 hour period, no new event crossing messages for this location will be logged.
...