Radar
Graphs
Radar graphs (class name:
obj_radar) are useful for comparing columns or rows of numeric data from
a tabular data element returned by your data attachment.
Data and Data Label Properties
Attach your data to the valueTable
property
to add one or more traces to your radar graph. If you include a label column
in your data attachment for valueTable, this can be used
to label either the radial axis or the legend, depending on whether the
rowSeriesFlag
is selected or deselected. The rowSeriesFlag controls how data populates
the graph:
|
If the rowSeriesFlag
is selected, the graph will display one trace per row of data and one radial
axis per numeric column of data. If you included a label column in your
data attachment and the rowLabelVisFlag is selected, the values
from that column will be used as legend labels. Otherwise, select the
rowNameVisFlag
to use row names as legend labels. By default, the label column is the
first non-numeric text column in your data. Specify a column name in the
labelColumnName
property to set the label column to a specific column. |
|
If the rowSeriesFlag
is deselected, the graph will display one radial axis per row of data and
one trace per column of numeric data. If you included a label column in
your data attachment and the rowLabelVisFlag is selected, the values
from the label column will be used as radial axis labels. Otherwise,
select the rowNameVisFlag to use row names on the radial axis. By
default, the label column is the first non-numeric text column in your
data. Specify a column name in the labelColumnName property to set
the label column to a specific column. |
Property
Name |
Description |
columnDisplayNames |
Set alternate display names
for column names in your radar graph's data. Column names are displayed
either along the x-axis or in the legend, depending on whether or not the
rowSeriesFlag
is selected. |
valueDivisor |
Divides values by the number
entered. |
valueMin
valueMax |
The valueMin and
valueMax
properties control the range of the value axis if the valueAxisAutoScaleMode
is set to Off. Select On for the valueAxisAutoScaleMode
to
calculate the value axis range according to data values being plotted.
To calculate the value axis range including valueMin and valueMax,
select On - Include Min/Max. |
Column Properties
Specify which columns are
displayed in your radar graph.
Property
Name |
Description |
columnsToHide |
Specify columns from the
data attachment to exclude from being used for plotted data or labels.
Data from the labelColumnName column will be used for labels even
if that column name is also specified in the columnsToHide property.
Columns specified in the columnsToHide property can still be used
in the drillDownColumnSubs property. |
Data Format Properties
Specify the format for trace
values in your radar graph.
Property
Name |
Description |
labelColumnFormat |
Select or enter the format
of numeric or date labels displayed on the radial axis, in the legend and in tooltips.
To enter a format, use syntax
from the Java DecimalFormat class
for numeric labels and syntax from
the Java SimpleDateFormat class for date
labels. To enable tooltips, select the mouseOverFlag. |
valueFormat |
Select or enter the numeric
format of trace values displayed in tooltips.
To enter a format, use syntax
from the Java DecimalFormat class. To enable tooltips, select the mouseOverFlag. |
Marker Properties
Specify how markers are
displayed in your radar graph.
Property
Name |
Description |
markDefaultSize |
Set markDefaultSize
to specify the size of the markers in pixels. |
markScaleMode |
Set markScaleMode
to
scale markers according to the order of the data in your data attachment,
e.g., the marker for the first data in the attachment is the smallest and
the marker for the last data is the largest. Select one of the following
from the drop down menu to set the scale mode: No Scale, Scale
by Trace, Scale Within Trace. |
Trace Properties
Specify how traces are displayed
in your radar graph.
Property
Name |
Description |
traceFillStyle |
Set traceFillStyle
to Solid, Transparent, Gradient, or Transparent Gradient
to fill the area under the trace. The default traceFillStyle is
None. To disable this feature, reset to None. |
traceProperties |
Specify the line color,
line style, line width, marker color, marker style and fill style of all
traces.
|
Alert Properties
To set trace marker colors
and styles based on a threshold value, select the corresponding value alarm
or value warning flags.
valueAlarmStatusTable |
Attach an alarm table containing
status indexes to valueAlarmStatusTable to enable rule based alarm
statuses for trace markers. The table attached to valueAlarmStatusTable
must have the same number of rows and columns as valueTable.
For each data element in valueTable, the status index at
the corresponding position in valueAlarmStatusTable will be used
to set the alarm status of the marker.
Valid indexes are: 0 = use
normal marker color and style, 1 = use low alarm marker color and style,
2 = use low warning marker color and style, 3 = use high warning marker
color and style, 4 = use high alarm marker color and style, -1 = determine
marker color and style by comparing the value to the enabled alarm thresholds.
If no data is attached to
valueAlarmStatusTable,
then the alarm status for a trace marker is determined by comparing the
marker's value to the enabled thresholds. |
valueHighAlarmEnabledFlag |
Select to enable the high
alarm threshold. |
valueHighAlarmLineVisFlag |
Select to display a dotted
line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor. |
valueHighAlarmMarkColor/
valueHighAlarmMarkStyle |
When a trace
marker's value is greater than or equal to the valueHighAlarm property,
the marker will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle. |
valueHighWarningEnabledFlag |
Select to enable
the high warning threshold. |
valueHighWarningLineVisFlag |
Select to display a dotted
line at the high warning threshold. The color of the line is set to the
valueHighWarningMarkColor. |
valueHighWarningMarkColor/
valueHighWarningMarkStyle |
When a trace marker's value
is greater than or equal to the valueHighWarning property but less
than the valueHighAlarm property, the marker will change to the
valueHighWarningMarkColor
and valueHighWarningMarkStyle. |
valueLowAlarmEnabledFlag |
Select to enable the low
alarm threshold. |
valueLowAlarmLineVisFlag |
Select to display a dotted
line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor. |
valueLowAlarmMarkColor/
valueLowAlarmMarkStyle |
When the trace
marker's value is less than or equal to the valueLowAlarm property,
the marker will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle. |
valueLowWarningEnabledFlag |
Select to enable
the low warning threshold. |
valueLowWarningLineVisFlag |
Select to display a dotted
line at the low warning threshold. The color of the line is set to the
valueLowWarningMarkColor. |
valueLowWarningMarkColor/
valueLowWarningMarkStyle |
When the trace marker's
value is less than or equal to the valueLowWarning property, but
greater than the
valueLowAlarm property, the marker will change
to the valueLowWarningMarkColor and valueLowWarningMarkStyle. |
Background Properties
Specify how the background
is displayed in your radar graph.
Property
Name |
Description |
bg3dFlag |
Select to display a 3D edge on the
background rectangle. |
bgColor |
Select the
button and choose a color from the palette to set the background color. |
bgEdgeWidth |
Set the width of the 3D
edge on the background rectangle. This property is only used if the bg3dFlag
is selected. |
bgGradientFlag |
Select to display a gradient
in the background rectangle. |
bgVisFlag |
Select to display the background
rectangle. |
Legend Properties
Specify the way the legend
is displayed in your radar graph.
Property
Name |
Description |
legendBgColor |
Select the
button and choose a color from the palette to set the background color
of the legend. |
legendBgGradientFlag |
Select the legendBgGradientFlag
to display a gradient in the legend background. |
legendVisFlag |
Select to display the legend. |
legendWidthPercent |
Set the percent of the total
width of the object used for the legend. |
Interaction Properties
To specify a drill
down display, double click on the drillDownTarget Property
Name. Any display (.rtv) file can be targeted as a drill down. Based on
your data attachment,
substitutions are
created that will be passed into drill down displays. To customize
which substitutions will be passed into drill down displays, double-click
on
drillDownColumnSubs in the
Object Properties window to open the Drill Down Column Substitutions dialog.
Once a drill down target has been set, double-click on the trace marker
to activate the drill down. Drill down displays can be activated in the
same window that contains the graph or open in a separate window. This
allows you to build a customizable hierarchy of displays.
Use drillDownSelectMode to control
how a drill down display is activated. Set to Anywhere to activate
a drill down display by double-clicking anywhere on the graph. Set to Element
Only to enable a drill down display only when you double-click on a
marker in the radar graph.
Select the mouseOverFlag
to enable tooltips for your radar graph. To display a tooltip, select the
graph and point to a trace marker with your mouse. The tooltip will contain
information from your data attachment about that trace marker.
Plot Area Properties
Specify how the plot area
is displayed in your radar graph.
Property
Name |
Description |
plotBgColor |
Select the
button and choose a color from the palette to set the background color
of the plot area. |
plotBgGradientFlag |
Select to display a gradient
in the plot background. Set the color of the plot background with the plotBgColor
property. |
plotBgImage |
Select an image
to display in the plot background of your graph. If necessary, the image
will be stretched to fit the plot area. |
Radial Axis Properties
Specify how the radial axis
is displayed in your radar graph. The radar graph contains a value axis
and a radial axis. The value axis is the vertical axis that displays the
maximum and minimum values for the graph. The value axis grid lines are
all of the rings except for the outer ring, which is the radial axis. The
radial axis grid lines are the spokes.
Property
Name |
Description |
radialAxisLabelVisFlag |
Select to display the radial
axis labels. |
radialAxisLineStyle |
Select the line style of
the radial axis
from the drop down menu:
No Line, Solid, Dotted,
Dashed or Dot
Dashed. |
radialAxisMinLabelWidth |
Specify the minimum width
in pixels for the radial axis labels. |
radialAxisVisFlag |
Select to display the radial
axis. |
radialGridLineStyle |
Select the line style of
the radial grid lines from the drop down menu:
No Line, Solid, Dotted,
Dashed or Dot
Dashed. |
radialGridVisFlag |
Select to display the radial
grid lines. |
Value Axis Properties
Specify how the value axis
is displayed in your radar graph. The radar graph contains a value axis
and a radial axis. The value axis is the vertical axis that displays the
maximum and minimum values for the graph. The value axis grid lines are
all of the rings except for the outer ring, which is the radial axis. The
radial axis grid lines are the spokes.
Property
Name |
Description |
valueAxisFlag |
Select to display the value
axis. |
valueAxisFormat |
Select or enter the numeric
format of trace values displayed on the value axis.
To enter a format, use syntax from the Java DecimalFormat class. |
valueAxisLineStyle |
Select the line style of the value axis
from the drop down menu:
No Line, Solid, Dotted,
Dashed or Dot
Dashed. |
valueAxisMajorDivisions |
Specify the number of major
divisions on the value axis. |
valueAxisMinorDivisions |
Specify the number of minor
divisions on the value axis. |
valueAxisAutoScaleMode |
The valueMin and
valueMax
properties control the range of the value axis if the valueAxisAutoScaleMode
is set to Off. Select On for the valueAxisAutoScaleMode
to
calculate the value axis range according to data values being plotted.
To calculate the value axis range including valueMin and valueMax,
select On - Include Min/Max. |
valueGridLineStyle |
Select the line style of the grid line
from the drop down menu:
No Line, Solid, Dotted,
Dashed or Dot
Dashed. |
valueGridVisFlag |
Select to display the grid
lines. |
|