Enterprise RTView® 
User Guide


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. 

   


 
SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2008 Sherrill-Lubinski Corporation. All Rights Reserved.

 
JMS, JMX and Java are trademarks and/or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only.