Apama 10.7.2 | Building and Using Apama Dashboards | Dashboard Property Reference for Graphs, Tables and Trends | Trend Objects | Trend graphs | Trend graph: Trace group
 
Trend graph: Trace group
Properties in this group control the number of traces that the chart contains, as well as the trace fill style. They can also specify the trace data, if a single data table is used for multiple traces.
Trace group properties
The group contains the following properties:
* multiTraceCurrentValueTable
* multiTraceHistoryValueTable
* multiTraceTableFlag
* traceCount
* traceFillStyle
multiTraceCurrentValueTable
To display current data for multiple traces by using a single attachment, attach a table to this property. The first column in the data table must be a timestamp column. The remaining columns are expected to be Y data values to be plotted. The Nth data column is used for trace N's data, and the column name is used for traceNLabel (if not already assigned).
If the multiTraceTableFlag is checked, the number of traces whose properties are shown in the Builder's property sheet is determined by the number of data columns in the data table attachments or by the traceCount property, whichever is larger. However, the number of traces that are plotted on the graph is determined by the number of data columns in the data table attachments.
Typically, the data attachment for multiTraceHistoryValueTable provides the initial data points to be plotted while multiTraceCurrentValueTable provides the new data points to be plotted while the display is viewed. If a trace plots only historical or only current data, only one of the properties needs to be attached to data. However if both properties are attached to data, be sure that the tables applied to both have the same number and type of columns.
When multiTraceTableFlag is checked, the properties traceNValueTable and traceNValue (for N between 1 and 10, inclusive) are not shown in the property sheet, since all trace data is expected to be provided via multiTraceCurrentValueTable or multiTraceHistoryValueTable.
This property is in the Trace property group.
multiTraceHistoryValueTable
To display historical data for multiple traces by using a single attachment, attach a table to this property. The first column in the data table must be a timestamp column. The remaining columns are expected to be Y data values to be plotted. The Nth data column is used for trace N's data, and the column name is used for traceNLabel (if not already assigned).
If multiTraceTableFlag is checked, the number of traces whose properties are shown in the Builder's property sheet is determined by the number of data columns in the data table attachments or by the traceCount property, whichever is larger. However, the number of traces that are plotted on the graph is determined by the number of data columns in the data table attachments.
Typically, the data attachment for multiTraceHistoryValueTable provides the initial data points to be plotted while multiTraceCurrentValueTable provides the new data points to be plotted while the display is viewed. If a trace plots only historical or only current data, only one of the properties needs to be attached to data. However if both properties are attached to data, be sure that the tables applied to both have the same number and type of columns.
When multiTraceTableFlag is checked, the properties traceNValueTable and traceNValue (for N between 1 and 10, inclusive) are not shown in the property sheet, since all trace data is expected to be provided via multiTraceCurrentValueTable or multiTraceHistoryValueTable.
This property is in the Trace property group.
multiTraceTableFlag
Controls whether data for multiple traces can be attached to the graph with a single table. When checked, the properties multiTraceCurrentValueTable and multiTraceHistoryValueTable, are shown in the Trace category.
When multiTraceTableFlag is checked, the properties traceNValueTable and traceNValue (for N between 1 and 10, inclusive) are not shown in the property sheet, since all trace data is expected to be provided via multiTraceCurrentValueTable or multiTraceHistoryValueTable.
If multiTraceTableFlag is checked, the number of traces whose properties are shown in the Builder's property sheet is determined by the number of data columns in the data table attachments or by the traceCount property, whichever is larger. However, the number of traces that are plotted on the graph is determined by the number of data columns in the data table attachments.
This property is in the Trace property group.
traceCount
Sets the number of traces. The maximum is ten. For each overlay, the Dashboard Builder automatically creates a set of properties in the Object Properties window.
This property is in the Trace property group.
traceFillStyle
Specifies the effect with which to fill the area from the trace line to the bottom of the graph. The color is determined by traceNLineColor. Select one of the following fill styles from the drop down menu:
*Solid
*Transparent
*Gradient
*Transparent Gradient
*None (default)
This property is in the Trace property group.