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
