Threshold warning levels file

The schema-companion to the Thresholds & warnings task guide. This file is the warning-level vocabulary — the severities, colours, and icons that thresholds refer to. This page is the generated field list.

At a glance

Purpose : Defines the warning levels (severity, colour, icons) that thresholds raise. Ordered least → most severe; there is no numeric rank field.

Folder : Config/RegionConfigFiles/

Root element : <thresholdWarningLevels> (no version attribute)

Referenced by : upWarningLevelId / downWarningLevelId in the Thresholds file.

Minimal example

<?xml version="1.0" encoding="UTF-8"?>
<thresholdWarningLevels xmlns="http://www.wldelft.nl/fews">
  <thresholdWarningLevel id="Normal" name="No warning">
    <color>00FF00</color>
    <iconName>normal.png</iconName>
    <historicOverlayIconName>normal_hist.png</historicOverlayIconName>
    <forecastOverlayIconName>normal_fc.png</forecastOverlayIconName>
  </thresholdWarningLevel>
  <thresholdWarningLevel id="Major" name="Major flood">
    <color>FF0000</color>
    <iconName>major.png</iconName>
    <historicOverlayIconName>major_hist.png</historicOverlayIconName>
    <forecastOverlayIconName>major_fc.png</forecastOverlayIconName>
  </thresholdWarningLevel>
</thresholdWarningLevels>

Field reference

Auto-generated from thresholdWarningLevels.xsd. Descriptions are the schema's own annotations.

Element `<thresholdWarningLevels>`

Element	Type	Cardinality	Description
`missingDataThreshold`	`ThresholdWarningLevelComplexType`	optional	If no data is available, a separate background color can be configured to set it apart from no threshold crossing. Available since 2018.02
`thresholdWarningLevel`	`ThresholdWarningLevelComplexType`	required · repeats	One or more warning levels. These warning levels must be ordered from least severe to most severe. The order is important for situations where only the most severe warning level is displayed. The least severe warning level always corresponds to the state in which no thresholds are crossed.

`ThresholdWarningLevelComplexType`

Attributes

Attribute	Use	Notes
`id`	required	Identifier of this warning level.
`name`	optional	Name of this warning level, e.g. "Flood Warning". This name is used when this warning level is displayed. If not specified, then the id is used when this warning level is displayed.

Elements

Element	Type	Cardinality	Description
`color`	`colorStringType`	required	Color that is used for this warning level.
`opaquenessPercentage`	`percentageType`	optional	Since 2017.02: Opaqueness of the color. If not specified, opaqueness is 100%
`iconName`	`idStringType`	required	Filename of an image file in the IconFiles config directory (including file extension). This image file will be used as warning level icon for this warning level.
`historicOverlayIconName`	`idStringType`	required	Filename of an image file in the IconFiles config directory (including file extension). This image file will be used as historic warning level overlay icon for this warning level.
`forecastOverlayIconName`	`idStringType`	required	Filename of an image file in the IconFiles config directory (including file extension). This image file will be used as forecast warning level overlay icon for this warning level.
`symbolId`	`idStringType`	optional	Id of a SVG symbol to display, for use in a Schematic Status (Scada-) Display.