Building and Using Dashboards > Dashboard Property Reference for Graphs, Tables and Trends > Trend Objects > Trend graphs > Trend graph: Trace Groups group
Trend graph: Trace Groups group
The properties in this group allow you to form trace groups. A trace group is a collection of two or more traces, and is useful for the following:
*Identifying multiple traces that should share one vertical axis, in strip chart or multi-axis modes
*Identifying three traces to be combined as a banded trace
By default, the category contains a single property, traceGroupCount, with a default value of zero. Legal values are 0 through 5. If nonzero, the traceGroupNTraceNumbers and traceGroupNBandedFlag properties appear in the Trace Group category, for each groupN, where N is between 1 and traceGroupCount, inclusive.
Follow these steps to construct an example:
1. Set traceCount = 3.
2. Set traceGroupCount = 1 (this makes the next 2 properties appear).
3. Set traceGroup1TraceNumbers = 1, 2, 3.
4. Set traceGroup1BandedFlag = true (checked).
5. Attach trace 1, 2, and 3 to data.
Note also the following:
*For each trace that is in a group, the y axis for the group is visible unless traceNYAxisVisFlag or traceVisFlag is false (unchecked) for all traces in the group. Similarly, the group's y axis grid is visible unless the traceNYAxisGridVisFlag property is false for all traces in the group.
*If traceN is in a group, these properties are hidden: traceNYAxisAutoScaleMode, traceNYAxisValueMax, traceNYAxisValueMin. The graph's yAXisAutoScaleMode, yValueMax, and yValueMin properties are used to scale each group's y axis range.
*If yAxisMultiRangeMode is Multiple Axis, the color of the axis for a group is determined by traceNLineColor of the first visible trace in the group. In Multiple Axis mode it may not be visually obvious which traces belong to which groups, unless you assign a similar line color or style, or mark color or style, to all the traces in a group.
Trace Groups group properties
The group includes the following properties:
*traceGroupNBandedFlag
*traceGroupNTraceNumbers
*traceGroupCount
traceGroupNBandedFlag
If this property is checked, the group is expected to have three traces. The plot area beneath the first trace in the group (the low band trace) is filled, the second trace in the group (the value trace) is not filled, and the area above the third trace (the high band trace) is filled.
This property is in the TraceGroups property group.
traceGroupNTraceNumbers
Specifies a comma-separated list of the traces that belong to the group. If the trend graph is in strip chart mode or multi-axis mode, all the traces in the group share the same axis or strip.
This property is in the TraceGroups property group.
traceGroupCount
Sets the number of trace groups. The default is 0. Allowable values are 0 through 5. If nonzero, the properties traceGroupNTraceNumbers and traceGroupNBandedFlag appear in the Trace Group category, for each groupN, where N is between 1 and the value of traceGroupCount, inclusive.
This property is in the TraceGroups property group.
Copyright © 2013-2015 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Use, reproduction, transfer, publication or disclosure is prohibited except as specifically provided for in your License Agreement with Software AG.