4.1 Introduction
The system configuration items form a primary part of the configuration of DELFT-FEWS as a system. It includes definition of the functional elements DELFT-FEWS has available (both GUI plug-ins and Module plug-ins). The layout of the main GUI (the FEWS Explorer) and the Time Series display are also defined.
The system configuration items include;
- Explorer configuration of the FEWS Explorer (the main GUI)
- ModuleDescriptors Configurations of the plug-in modules available to DELFT-FEWS
- DisplayDescriptors Configuration of the plug-in displays available to DELFT-FEWS
- DisplayInstanceDescriptors Definition of the plug-in displays used.
- TimeSeriesDisplayConfig Configuration of the time series display.
- DisplayGroups Configuration of the shortcuts to display templates available in the time series display.
- LocationIcons Definition of the icons used in the FEWS Explorer layout for locations.
For each of the configuration items listed above only one configuration is active (or default) at any one time. Each item is defined in an XML file with a unique name.
Many of the configuration items required will include references to strings. To avoid duplication, a tag can be defined in the global.properties file in the root configuration and the tag name used in the XML file.
To use a tag, add this in the global.properties file.
To reference a tag include the sting $TAG_NAME$, where TAG_NAME is the tag to be used.
4.3 Time Series Display Configuration
The layout of the time series display is configured in an XML file in the SystemConfigurations section. When available on the file system, the name of the XML file is for example:
TimeSeriesDisplayConfig 1.00 default.xml
TimeSeriesDisplayConfig Fixed file name for the time series display settings
1.00 Version number
default Flag to indicate the version is the default configuration (otherwise omitted).
Figure 13 shows the main elements of the TimeSeriesDisplay configuration, These are divided into a number of sections, each of which will be discussed individually (these are indicated with a + sign).
Figure13 Elements in the TimeSeriesDisplay configuration
description
An optional description of the configuration. This is for reference purposes only and will not be used elsewhere.
4.3.1 General Display Configuration
This includes global setting for the time series display. Currently only one setting is available.
convertDatum
This optional Boolean setting can be used to start the time series display showing levels against the global reference level. The default is that levels are displayed against the local reference level. The difference between local and global reference is defined in the locations definition (see regional settings).
4.3.2 Default view period
The optional default view period can be used to define the time span of data displayed in the time series display (unless overruled by the user).
Parameters
- unit identifies the time unit with which the time span is defined (enumeration of second, minute, hour, day, week).
- start identifies the start time of the time span with reference to the T0 (in multiples of the unit defined).
- end identifies the start time of the time span with reference to the T0 (in multiples of the unit defined).
4.3.3 Time Markers Display Configuration
Time series display markers are informative lines in the display. These may be defined to display vertical lines for times values of interest. The configuration of horizontal threshold lines is also included in this definition. Markers can be defined for three time values as well as for the thresholds;
- systemTime
- displayTime
- timeZero
- threshold
Figure 14 Elements in the TimeMarkersDisplay section of the TimeSeriesDisplay configuration
timeMarkerDisplayOptions
Root element of a definition time markers (multiple entries may exist).
Attributes;
- marker enumeration of the possible markers (see list above).
color
Colour of the time series marker line (see enumeration of colours in appendix ??).
lineStyle
Line style of time series marker line. Enumeration of "solid", "none", "bar", "dashdot", "dashed", "dotted".
1.3.4 Parameters display configuration
In this section of the time series display, default attributes of lines plotted for parameters can be allocated. These defaults will be used when plotting lines for these parameters in the time series displays and in the reports. Note that for allocation of the colour only the preferred colour can be identified. When the line is plotted this colour will be used only if there is no other line with the same colour. If this is the case then the next colour in the colour palette will be used.
Figure 15 Elements in the ParameterDisplayConfig section of the TimeSeriesDisplay configuration
PreferredColor
The preferred colour for the line and markers. This colour will only be used if it is not yet available in the current graph. If it is, then the next colour in the template order will be selected.
lineStyle
Line style of time series line. Enumeration of "solid", "none", "bar", "dashdot", "dashed", "dotted".
markerStyle
Marker style for markers plotted on the vertices of the line. Enumeration of "none", "+", "x", "circle", "square", "rectangle", "diamond", "triangleup" , "triangledown".
markerSize
Size of the marker in points
Precision
Decimal precision with which values are given in the table.
min
Minimum of the y-scale to be used as a default for all displays of this parameter. The minimum is used, unless a value in the time series is lower than this minimum, in which case that is used. The minimum defined here can also be overruled in individual template definition in the DisplayGroups (see below).
max
Maximum of the y-scale to be used as a default for all displays of this parameter. This maximum is used, unless a value in the time series is higher than this maximum, in which case that is used. The maximum defined here can also be overruled in individual template definition in the DisplayGroups (see below).
1.3.5 Module instance mapping
The module instance mapping allows user defined strings to be defined which will display the moduleInstanceID in the legends of the time series display. This can help shorten legends, or add additional information.
Figure 16 Elements in the Log Panel section of the Explorer configuration
moduleInstanceMapping
Root element for each mapping to be defined.
Attributes;
- id ModuleInstanceId to be replaced
description
String to replace the module instance id in the legends
1.4 Display Groups
A list of pre-configured displays can be configured in the Display groups. When available on the file system, the name of the XML file is for example:
DisplayGroups 1.00 default.xml
DisplayGroups Fixed file name for the explorer settings
1.00 Version number
default Flag to indicate the version is the default configuration (otherwise omitted).
The pre-configured displays are organised in a tree view in the time series display (see example in Figure 17). Each pre-configured display is identified by its name, and may include one or more subplots, each with one or more time series lines.
Figure 17 Example of time series display, showing two sub-plots and tree-view of pre-configured displays
Figure18 Root element of the display groups definition
description
A description of the display groups configuration. Used for referencing onlu.
displayGroup
Root element for each displayGroup. A display group forms one of the main nodes in the tree view and may contain multiple displays. Multiple display groups may be defined.
Attributes;
- name: name of the display group (used in the tree view)
display
Definition of a pre-configured display. Each display may contain multiple sub-plots. Multiple displays may be defined per display group.
Attributes;
- name: name of the display (used in the tree view)
Figure 19 Elements in the Display section of the DisplayGroups configuration
subplot
Root element for each subplot. Multiple sub-plots may be defined per display.
timeSeriesSet
Definition of the time series set to be displayed. See section 3.3 for a description of the time series set definition.
1.5 Location Icons
Configuration of location icons can be used to help identify the different types of locations on the map display. This is an optional configuration item. If it is not available then the default location icon will be used to all locations. When available on the file system, the name of the XML file is for example:
LocationIcons 1.00 default.xml
LocationIcons Fixed file name for the location icon configuration
1.00 Version number
default Flag to indicate the version is the default configuration (otherwise omitted).
Figure 20 Elements in the LocationIcons configuration
rootDir
This is the directory where the icons referred to are stored. By convention this directory is the <REGION>\Icons directory. The directory can be given relative to the <REGION> directory. If the convention is followed then only "Icons" needs to be entered.
locationIcon
Root element of a location icon definition. Multiple entries may be defined.
description
Description of the group of locations for which an icon is defined (for reference in the configuration only).
iconID
ID of the icon to be used in the display for this group of locations. This id is the same as the name of the icon file, without the ".gif" file extension.
locationId/locationSetId
The locationId is a reference to the location for which icon is used. Either one or more locationId's may be defined, or a single locationSetId.
1.6 Module Descriptors
The module descriptors is used to register module plug-ins that can be used in workflows. The module descriptors define the name of the module and the associated Java class to call. This class must implement the module plug-in interface for it to work within DELFT-FEWS. All modules that are included in the distribution of DELFT-FEWS are registered in the Module Descriptors. When available on the file system, the name of the XML file is for example:
ModuleDescrtiptors 1.00 default.xml
ModuleDescrtiptors Fixed file name for the module descriptors configuration
1.00 Version number
default Flag to indicate the version is the default configuration (otherwise omitted).
Figure 21 Elements in the ModuleDescriptors configuration
moduleDescriptor
Root element of the module descriptor configuration. One entry is required for each module defined.
Attributes;
- Id: Id or Name of the module
description
Optional description of the module. This is used for reference only.
className
Java class called when running the module as referenced by its Id. NOTE; this class must implement the DELFT-FEWS module plug-in interface.
1.7 Display Descriptors
The display descriptors is used to register display plug-ins that can be called from the DELFT-FEWS GUI. The display descriptors define the name of the display and the associated Java class to call. This class must implement the display plug-in interface for it to work within DELFT-FEWS. All displays that are included in the distribution of DELFT-FEWS are registered in the Display Descriptors. When available on the file system, the name of the XML file is for example:
DisplayDescriptors 1.00 default.xml
DisplayDescriptors Fixed file name for the display descriptors configuration
1.00 Version number
default Flag to indicate the version is the default configuration (otherwise omitted).
Figure 22 Elements in the DisplayDescriptors configuration
displayDescriptor
Root element of the display descriptor configuration. One entry is required for each display defined.
Attributes;
- Id: Id or Name of the display
description
Optional description of the display. This is used for reference only.
className
Java class called when running the display as referenced by its Id. NOTE; this class must implement the DELFT-FEWS display plug-in interface.
