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. 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.
 

Using Data and Data Label Properties
To attach data to your graph, right-click in the Property Value field of the valueTable property and select Attach to Data. If you include a label column in your data attachment, this can be used to label either the radial axis or the legend depending on whether the rowSeriesFlag checkbox is selected or deselected.

The rowSeriesFlag controls how data populate 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, select rowLabelVisFlag and the values from that column will be used as legend labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag to use row names in the legend.

 

If the rowSeriesFlag is not selected, 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, select rowLabelVisFlag and the values from that column will be used as radial axis labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag to use row names on the radial axis.

 


Using Interaction Properties

Commands
To assign a command to your graph, right-click in the Property Value field of the command property and select Define Command.
Commands can be set up to execute when you click on an object or automatically execute the command when the value of an object reaches a specified threshold. See Building Displays>Define/Execute Command for information on how to set up commands.

Drill Down Displays
To specify a drill down display, double click on the drillDownTarget property. 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 in the graph 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 graph.

Tool Tips
Select the mouseOverFlag to enable tool tips for your graph. To display a tool tip, point to a trace marker with your mouse. The tool tip will contain information from your data attachment about that marker.

 


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
bgBorderColor Select the  button and choose from the palette to set the color of the edge on the background rectangle. This property is only applicable if bgBorderFlag is selected.
bgBorderFlag If selected, a border is drawn around the background rectangle,
bgColor Select the  button and choose from the palette to set the background color. 
bgEdgeWidth Set the width of the 3D edge on the background rectangle. This property is only available if the bgStyle selected is 3D Rectangle.
bgGradientColor2 Select the  button and choose a color for the second color in the gradient. Default is white. NOTE: The bgColor property sets the first color in the gradient.
bgGradientMode Display a gradient in the background rectangle. Select from the following options:
 
  None No gradient
  Diagonal Edge Gradient is drawn at a 45 degree angle from the top left to the bottom right corner of the object.
  Diagonal Center Gradient is drawn at a 45 degree angle from the center to the top left and the bottom right corners of the object.
  Horizontal Edge Gradient is drawn horizontally from the top to the bottom of the object.
  Horizontal Center Gradient is drawn horizontally from the center to the top and bottom of the object.
  Vertical Edge Gradient is drawn vertically from the left to the right of the object.
  Vertical Center Gradient is drawn vertically from the center to the left and right of the object.
bgRaisedFlag Reverses the direction of the gradient, as well as that of the 3D edge if the bgStyle selected is 3D Rectangle.
bgRoundness Set the arc length of the rounded corners. This property is only available if the bgStyle selected is Round Rectangle.

NOTE: The value of bgRoundness cannot exceed half the value of the objWidth or the objHeight. If bgRoundness does exceed that value, then half (of the smaller of the two values) of objWidth or objHeight will be used instead. For example if objWidth is 100 and objHeight is 50, then the value of bgRoundness cannot exceed 25. If it does, then half the value of objHeight (25) will be used instead.

bgShadowFlag Select to display a drop shadow on the background rectangle.
bgStyle Choose one of  the following three options from the drop down menu:
 
Rectangle Select to display a background rectangle.
3D Rectangle Select to display a 3D edge on the background rectangle. If selected, use bgEdgeWidth to set the width of the 3D edge.
Round Rectangle Select to display a background rectangle with rounded edges. If selected, use bgRoundness to set the arc length of the rounded corners.
bgVisFlag Select to display the background rectangle.
borderPixels Set the amount of space (in pixels) between the graph and the border.

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 Properties
Property Name Description
rowSeriesFlag Controls how data populate 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, select rowLabelVisFlag and the values from that column will be used as legend labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag to use row names in the legend.

If the rowSeriesFlag is not selected, 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, select rowLabelVisFlag and the values from that column will be used as radial axis labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag to use row names on the radial axis.

valueDivisor Divides values by the number entered.
valueMin 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.
valueMax
valueTable Attach your tabular data. If you include a label column in your data attachment, this can be used to label either the radial axis or the legend depending on whether rowSeriesFlag is selected or deselected.

Data Format Properties
Property Name Description
labelColumnFormat Select or enter the format of numeric or date labels displayed on the radial axis, in the legend and in tool tips. 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 tool tips, select the mouseOverFlag.

valueFormat Select or enter the numeric format of trace values displayed in tool tips. To enter a format, use syntax from the Java DecimalFormat class.

To enable tool tips, select the mouseOverFlag

Data Label Properties
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.
labelColumnName Specify a column in your data attachment to be the label column. If left blank, the first non-numeric text column in your data will be used. NOTE: If you include a label column in your data attachment, this can be used to label the legend depending on whether rowSeriesFlag is selected or deselected.
rowLabelVisFlag Control the visibility of labels that appear in the legend or on the radial axis, depending on whether rowSeriesFlag is selected or deselected.
rowNameVisFlag Select to use row names from your data attachment to label either the radial axis or the legend, depending on whether rowSeriesFlag is selected or deselected. NOTE: This is useful if your data attachment does not have a label column.

Historian Properties
Property Name Description
historyTableName Specify name of table in your history database in which to store tabular data. See Configuring the Historian for information.
historyTableRowNameFlag If selected, data from the row name field will be stored in the first column of the table specified in historyTableName.

Interaction Properties
Property Name Description
command Assign a command to your graph. See Building Displays>Define/Execute Command for information.
commandCloseWindowOnSuccess If selected, the window that initiates a system command will automatically close when the system command is executed successfully. This property only applies to system commands.

With data source commands, the window is closed whether or not the command is executed successfully.

For multiple commands, this property is applied to each command individually. Therefore if the first command in the multiple command sequence succeeds, the window will close before the rest of the commands are executed.

NOTE: The commandCloseWindowOnSuccess property is not supported in the Display Server.

commandConfirm If selected, the command confirmation dialog is enabled. Use the commandConfirmText property to write your own text for the confirmation dialog, otherwise text from the command property will be used.

For multiple commands, if you Confirm the execution then all individual commands will be executed in sequence with no further confirmation. If the you Cancel the execution, none of the commands in the sequence will executed.

commandConfirmText Enter command confirmation text directly in the Property Value field or select the  button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.
drillDownColumnSubs Select the  button to open the Drill Down Column Substitutions dialog to customize which substitutions will be passed into drill down displays.
drillDownSelectMode Control how a drill down display is activated. Select one of the following options:

Anywhere - Activate a drill down display by double-clicking anywhere on the graph.

Element Only - Enable a drill down display only when you double-click on a marker in the graph.

drillDownTarget Name of display (.rtv) file targeted as a drill down. See Building Displays>Drill Down Displays for information.
mouseOverFlag Select to enable tool tips for your radar graph. To display a tool tip, point to a trace marker with your mouse. The tool tip will contain information from your data attachment about that marker.

Label Properties
Property Name Description
label Edit label text directly in the Property Value field or select the  button to open the Edit Label dialog.
labelMinTabWidth Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to TabTop.
labelTextAlignX Select x-axis position of label text from the drop down menu.
labelTextAlignY Select y-axis position of label text from the drop down menu.
Outside Top Position label well above the background rectangle.
Top Position label just above the background rectangle.
Title Top Position label along the top line of the background rectangle.
Tab Top Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.
Inside Top Position label inside the top of the background rectangle.
labelTextColor Select the  button and choose from the palette to set the label text color.
labelTextFont Select font style of label text from the drop down menu.
labelTextHeight Set the height of the label text in pixels.

Legend Properties
Specify the way the legend is displayed in your radar graph.
 
Property Name Description
legendBgColor Select the  button and choose from the palette to set the background color of the legend.
legendBgGradientColor2 Select the  button and choose a color for the second color in the gradient. Default is white. NOTE: The legendBgColor property sets the first color in the gradient.
legendBgGradientMode Display a gradient in the legend background. Select from the following options:
 
  None No gradient
  Diagonal Edge Gradient is drawn at a 45 degree angle from the top left to the bottom right corner of the object.
  Diagonal Center Gradient is drawn at a 45 degree angle from the center to the top left and the bottom right corners of the object.
  Horizontal Edge Gradient is drawn horizontally from the top to the bottom of the object.
  Horizontal Center Gradient is drawn horizontally from the center to the top and bottom of the object.
  Vertical Edge Gradient is drawn vertically from the left to the right of the object.
  Vertical Center Gradient is drawn vertically from the center to the left and right of the object.
legendVisFlag Select to display the legend.
legendWidthPercent Set the percent of the total width of the object used for the legend. 
outlineColor Select the  button and choose a color from the palette to set the color of the one-pixel outline around the legend area and around each color swatch within the legend. The default value is black (color 7).

Marker Properties
Property Name Description
markDefaultSize Specify (in pixels) the size of the markers.
markScaleMode Scale markers according to the order of the data in your data attachment (i.e. The marker for the first data in the attachment is the smallest and the marker for the last data is the largest.)

Select from the following options: No Scale, Scale by Trace, Scale Within Trace.

Object Properties
Property Name Description
anchor  Specify where to anchor an object in the display. NOTE: If an object has the dock property set, the anchor property will be ignored.

The anchor property is only applied when the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode

Select None, or one or more the following options:

None Object not anchored. This is the default.
Top Anchor top of object at top of display.
Left Anchor left side of object at left of display.
Bottom Anchor bottom of object at bottom of display.
Right Anchor right side of object at right of display.

When a display is resized, the number of pixels between an anchored object and the specified location remain constant. If an object is anchored on opposite sides (i.e. Top and Bottom or Left and Right), the object will be stretched to fill the available space.

dock Specify the docking location of an object in the display.

Select from the following options:

None Object is not docked. This is the default.
Top Dock object at top of display.
Left Dock object at left of display.
Bottom Dock object at bottom of display.
Right Dock object at right of display.
Fill Dock object in available space remaining in the display after all docked objects are positioned.

If the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode, the properties (objX, objY, objWidth and objHeight) of docked objects will automatically adapt to match the new size of the display.

When multiple objects are docked to the same side of the display, the first object is docked against the side of the display, the next object is docked against the edge of the first object, and so on.

When objects are docked to multiple sides of the display, the order in which objects were added to the display controls docking position. For example, let's say the first object added to the display is docked at the Top and the second object is docked at the Left. Consequently, the first object will fill the entire width of the display and the second object will fill the left side of the display from the bottom of the first object to the bottom of the display.

Objects in a display have the dock property set to Fill, are laid out across a grid in the available space remaining after all docked objects are positioned. By default, the grid has one row and as many columns as there are objects in the display. You can modify the grid in the Background Properties dialog.

Once an object is docked, there are some limitations on how that object can be modified.

  • Docked objects cannot be dragged or repositioned using objX and objY properties.
  • Docked objects cannot be resized using the objWidth or objHeight properties. To resize you must drag on the resize handle.
  • Docked objects can only be resized toward the center of the display (e.g. If an object is docked at the Top, only its height can be increased by dragging down toward the center of the display).
  • Docked objects set to Fill cannot be resized at all.
  • Docked objects cannot be moved using Align. Non-docked objects can be aligned against a docked object, but a docked object will not move to align against another object.
  • Docked objects are ignored by Distribute.
objHeight Set height of the object in pixels.
objName Name given to facilitate object management via the Object List dialog. Select Tools>Object List.
objWidth Set width of the object in pixels.
objX Plot x-axis position of object.
objY Plot y-axis position of object.
styleClass Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. NOTE: The value entered must not contain spaces and cannot start with rtv-.
transparencyPercent Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.
visFlag Control visibility of the object.

Plot Area Properties
Specify how the plot area is displayed in your radar graph.
Property Name Description
gridColor Select the  button and choose from the palette to set the color of the grid lines.
plotBgColor Select the  button and choose from the palette to set the background color of the plot area.
plotBgGradientColor2 Select the  button and choose the second color in the gradient. Default is white. NOTE: The plotBgColor property sets the first color in the gradient.
plotBgGradientMode Display a gradient in the plot background. Select from the following options:
 
  None No gradient
  Diagonal Edge Gradient is drawn at a 45 degree angle from the top left to the bottom right corner of the object.
  Diagonal Center Gradient is drawn at a 45 degree angle from the center to the top left and the bottom right corners of the object.
  Horizontal Edge Gradient is drawn horizontally from the top to the bottom of the object.
  Horizontal Center Gradient is drawn horizontally from the center to the top and bottom of the object.
  Vertical Edge Gradient is drawn vertically from the left to the right of the object.
  Vertical Center Gradient is drawn vertically from the center to the left and right of the object.
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
radialAxisColor Select the  button and choose from the palette to set the color of the the radial axis and radial axis labels.
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.

Trace Properties
Specify how traces are displayed in your radar graph.
 
Property Name Description
traceFillStyle Specify the style to fill the area under the trace. Select from the following options: Solid, Transparent, Gradient, or Transparent Gradient to  Default is None.
traceProperties Specify the line color, line style, line width, marker color, marker style and fill style of all traces.  

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
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.
valueAxisColor Select the  button and choose from the palette to set the color of the value axis and value axis labels.
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.
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, 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-2012 Sherrill-Lubinski Corporation. All Rights Reserved.

 

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

 

Third Party Notice Requirements