The chart control displays recorded channel data graphically. It is suitable for visualizing measured values.
Id #
The Id field shows the internal number of the control and its type. The number is for display purposes only and is determined automatically by the system. The control type cannot be changed subsequently.
Name #
The name of the control. The name is displayed in selection lists and for most control types also directly to the user as a label.
Comment #
The comment field is for free use by the integrator/system administrator. It is used exclusively to document the configuration. Information can be entered here, e.g. the purpose of the control, comments, room/floor and other special features. The content of this field is irrelevant for X2.
Options/Customize #
Timer: If the control supports timers, the timer can be activated with the checkbox.
Widget size: Sets the size of the tile for the control in the widget/tile view. If the combo box is empty, a standard size is used for the control type, which provides a good display in most application scenarios.
Further options: Opens a dialog in which additional, rarely required settings can be made (timer lock, overwrite colors).
Time base #
Controls the length of the time period that is displayed in the chart by default.
Type #
Chart type that is displayed by the chart. If Automatic is selected, the display switches between line/bar depending on the selected period.
Navigation bar #
Represents a navigation bar for displaying any time periods for the chart.
Aspect ratio #
Controls the width to height ratio of the chart. The width of the chart is always scaled on the screen according to the available space. The height is then controlled according to the page ratio.
Data sources #
Five identical sections follow, each of which you use to define a data source.
| Field | Function |
|---|---|
| Data source | Type and source of the data to be displayed. If nothing is specified, this data source does not appear in the chart (source is not used, the remaining settings are then irrelevant) |
| Processing | Determines how data values are processed/aggregated and displayed over longer periods of time. |
| Stepped | If not set, the graph is a smoothed curve. If set, all smoothing is omitted |
| Filled | If set, the area under the curve is displayed filled |
| Min/Max (Soft) | Default values for the minimum/maximum value on the Y-axis. If values outside this range occur, the value range of the Y-axis is extended to the required range. Both values are optional and, if not specified, are selected according to the largest/smallest value to be displayed. |
| Min/Max (Hard) | Sets a fixed value range for the Y-axis. If values are outside this range, the curve will run out of the graph and be cut off. If only one value is specified, only the upper/lower limit of the graph is fixed. |
Notes #
A chart represents a maximum of two Y-axes (one on the left and a second, if necessary, on the right). If data series have the same units, they share the same Y-axis. Bear this in mind when specifying min/max values.
Data source #
The left-hand field determines which type of data source is used. Only two selections are currently possible here: Chart channel and Counter channel. In the field behind it, select the object from which the data comes (currently always a channel).
Chart channel: The chart data recorded for the channel is used as the data source (see also Channel, Chart flag). All channels with a numerical data type can be used as chart channels (e.g. temperatures, power, etc.).
Meter channel: Meter data (from the energy bill) is used as the data source. Meter data only exists if the channel is used as a meter in the energy bill (the data is managed by the energy bill). Meter data can be displayed less flexibly (see below).
Processing #
From left to right in the Processing line: Measured value, Aggregation function, Unit, Rounding.
Measured value: For each data source (chart channel), the current average, minimum and maximum value are recorded for each 5-minute time window. This combo box determines which recorded data value is used as the basis for the graph.
For data sources of the counter type, there is only one value per time window, i.e. the selection of average. Minimum and maximum result in the same value (namely the counter reading at the time). Accordingly, the range of a counter data value is always 0.
| Value | Description |
|---|---|
| average | Average value in the time window |
| Minimum | Minimum value in the time window |
| Maximum | Maximum value in the time window |
| Span | Derived: Maximum minus minimum in the time window. |
Aggregation: If the data is to be displayed on larger time scales, several measured values must be combined into one value in the chart (e.g. bar chart with one value per day). The aggregation controls how the measured values are processed. With a data source of the type counter, only the aggregation difference is generally useful.
| Aggregation | Effect |
|---|---|
| average | The mean value of the summarized values is shown |
| Amendment | Forms the difference between the first and last summarized value. This corresponds to the 1st derivative of the graph, suitable for visualizing a monotonically variable value (e.g. meter reading). |
| Span | Difference between maximum and minimum value. This corresponds to the fluctuation range between the summarized values. |
| Minimum | Returns the minimum value of the summarized values. |
| Maximum | Returns the maximum value of the summarized values. |
Unit: A unit compatible with the measured value (i.e. a unit into which the measured value can be meaningfully converted, e.g. if the measured value is in watts but kilowatt hours are to be displayed). If the conversion is not defined (e.g. °C to watts), the unit of the measured value is displayed.
Rounding: The aggregated value is rounded to the specified number of decimal places if required. The Auto setting does not cause rounding.
Note: To visualize a counter reading, the combination Measured value: Maximum (or Minimum) and Aggregation: Change is useful. For “normal” measured values, change is generally not useful or the graph is not very meaningful for people. If the minimum/maximum of a value is to be visualized, it makes sense to set the measured value and aggregation identically.
It can make sense to visualize a chart value several times in a diagram with different processing. Example: Temperature (aggregated minimum and maximum as separate data series), so you can, for example, very clearly visualize maximum and minimum values over longer periods of time.
