ComboChart

Users may generate combination barcharts, line charts and area filled charts.
The combo chart accepts a set of bar data sets and line data sets, with most of the same display parameters found in the Bar Chart and XY Chart.
Bars may be displayed in either a stacked or grouped arrangement, similar to the barcharts. Bars are always drawn first, with the line data sets drawn over them.
If there are any filled line sets (area fills), they will be drawn behind the bars.

The user can specify (x,y) coordinates for each line dataset, mapping those values to the screen using either the bottom or top and left or right axes. This allows the generation of charts in which the line set values are either consistent with the bar values (such as min/max line sets) or are best drawn using their own coordinate systems (such as a plot of average employee age vs. salary by age.)

 

LineSets

	LineSets = (lineset1 tuple), (lineset2 tuple),...;

Defines a list of lineset tuples with the following attributes in each tuple:

The user may specify (x,y) coordinates for each line dataset, mapping those values to the screen using either the bottom or top and left or right axes. This allows the generation of charts in which the line set values are either consistent with the bar values (such as min/max line sets) or are best drawn using their own coordinate systems (such as a plot of average employee age vs. salary by age.)

Defines a list of lineset tuples with the following attributes in each tuple:

 "Name"  Name assigned to this data set
 SymColor  Symbol Color
 SymType  Symbol Type (NONE, CIRCLE, SQUARE, DIAMOND, CROSS, TARGET,TRIANGLEDOWN, TRIANGLEUP)
 SymSize  Symbol Size (in pixels)
 SymStyle  Symbol Style (FILLED, OUTLINED)
 LineType  Line Type (NONE, SOLID, DOTTED, DASHED, DOTDASH)
 LineWidth  Line Width (in pixels)
 LineColor  Line Color
 FillColor  FillColor

See the XY Chart applet for more details concerning line set attributes.

 

LineAxis

	LineAxis = (XAxis1, YAxis1), (XAxis2, YAxis2), ...;

The XAxis and YAxis attributes define the specific axis to be used when mapping the X and Y values respectively for each data set defined. The XAxis attribute may be set to BOTTOM or TOP, while the YAxis may be set to LEFT or RIGHT.

 

LineSet[1–50]

	LineSet[1-50] = (x1,y1), (x2,y2), ...;

Defines a list of (x,y) values for each line dataset defined by the LineSets parameter. If "null" is substituted for either or both of the x/y pair value's, the point will not be drawn.

 

LineLabels[1–50]

	LineLabels[1-50] = ("Label1", "URL1", "Target1"), ...;

Same as ActiveLabels[1-50] except that the labels correspond to the line datasets that have been defined.

 

LineSymbol

       LineSymbol = (type1, size1, style1, borderColor1,
                     borderWidth1, image1,symbolColor,shadowWidth),...

 

Type Type of symbol to be displayed, including: 

NONE, CIRCLE, SQUARE, DIAMOND, CROSS,TARGET
TRIANGLEDOWN, TRIANGLEUP, IMAGE

If NONE is specified, then no symbol is displayed. If IMAGE is specified, then the image attribute will be used to load a GIF image for the symbol.

Size Specifies the size of the symbol in pixels. This attribute is ignored for IMAGE symbols.
Style Specifies how the symbol should be drawn, including FILLED, OUTLINED, or BOTH. If FILLED is specified, the symbol is filled with the line set color. If OUTLINED is specified, only the outline is drawn, using the line set color. If BOTH is specified, then the symbol is filled with the line set color and the outline is drawn using the borderColor.
BorderColor The color used when drawing the outline of a symbol with style BOTH.
BorderWidth The width of the outline for a symbol with style OUTLINED or BOTH.
Image The URL of a GIF image file to be used as the symbol when the type attribute is set to IMAGE. Transparent images are supported (GIF89 format).
SymbolColor The color when used for drawing a symbol.
ShadowWidth The size of the shadow drawn behind the symbol. Any number other than 0 causes NetCharts to choose a shadow size based on the size of the symbol. Specifying a value of 0 suppresses the shadow.

 

This parameter is processed after the deprecated DataSets parameter (which included symbol attributes) and any attributes specified in that parameter will be overridden by those specified in this parameter.

 

LineStyle

	LineStyle = (type1, width1, color1, fillColor1),...

This parameter specifies the line style to be displayed for one or more line sets. That is, the first tuple defines the symbol for the first line set, and so on. The following attribute values are supported:

This parameter is processed after the deprecated DataSets parameter (which included symbol attributes) and any attributes specified in that parameter will be overridden by those specified in this parameter.

Type Specifies the style of the line to be drawn, as follows: 

NONE, SOLID, DOTTED, DASHED, DOTDASH

If NONE is specified, then no line is drawn between the symbols in the given line set.

Width The width of the line in pixels. Default width is 1.
Color The color of the line. Default color is the color of the line set itself.
FillColor If this attribute is not "null", then the area under the lineset will be filled with the given color.
LineType 
NORMAL - Normal line
FIT    - Draws a spline curve approximation
BOTH   - Draws both a normal line and a spline curve approximation

 


LineValueLabel 

   LineValueLabel = ("mode", color, "font name", font size, angle, interiorAlignment);

Defines the label value to be displayed near each point in a lineset.

Valid mode values are "ON" and "OFF", the default value is "ON". 

   example: ("ON",black,"Helvetica",18,0);

This parameter was introduced in NetCharts 4.0.

 

LineValueLabelBox


   LineValueLabelBox = (color,bordertype,borderwidth);


   example:(grey,RAISED,3);

Defines the label box to be displayed near each point in a lineset.

Values are as follows:

 Color  The color of the region. If an image attribute is also defined, this color is drawn first, followed by the image, allowing this color to show through any transparent parts of the image.
BorderType  The following border styles are supported: 
NONE    - No border
BOX     - Simple Box outline
SHADOW  - Shadow border
RAISED  - Raised border
RECESS  - Recessed border
When the BOX and SHADOW styles are specified, the border color will be black. When the RAISED and RECESS styles are specified, the border color will be chosen based on the region color.
 BorderWidth  This attribute defines the width of the border in pixels.

This parameter was introduced in NetCharts 4.0.

LineValueLabelStyle


   LineValueLabelStyle = labelposition1,labelposition2 ..., labelpositionN;

Defines where the LineValueLabel text will be justified for each point in a dataset. 

    example: LineValueLableStyle = CENTER, TOP;

Available justification options for LineValueLabelStyle are:

CENTER Center of the lineset datapoint
BOTTOM Bottom of the lineset datapoint
TOP Top of the lineset datapoint
LEFT Left of the lineset datapoint
RIGHT Right of the lineset datapoint
TOP RIGHT Top Right of the lineset datapoint
BOTTOM RIGHT Bottom Right of the lineset of the lineset datapoint
TOP LEFT Top Left of the lineset datapoint
BOTTOM LEFT Bottom Left of the lineset of the lineset datapoint
NONE No line labels display

This parameter was introduced in NetCharts 4.0.

 

Line3DDepth

	Line3DDepth = depth;

If depth is greater than 1, then all line sets will be displayed as 3D lines, in separate rows, much like the ROWS GraphType in NFBarchartApp. The max amount of space allocated to each line in the Z dimension will be "depth" pixels. The default value is 0.

 

LineWidth

	LineWidth = percent;

This percentage value (0–100) or (0.0–1.0) determines the amount of space actually used to display 3D lines when Line3DDepth is greater than 1. If 100 percent is specified, then each line will completely fill the amount of space specified by Line3DDepth in the Z dimension. If 50 percent is specified, then each line will occupy only 50 percent of that space, which will result in a visible separation between each line set.

The default value is 100.

 

TopAxis

	TopAxis = (Axis Tuple);

By default, if this parameter is defined, then the top axis will be used to map the X data values for all line sets, unless otherwise specified using the LineAxis parameter.

 

RightAxis

	RightAxis = (Axis Tuple);

By default, if this parameter is defined, then the right axis will be used to map the Y data values for all line sets, unless otherwise specified using the LineAxis parameter.

 

GraphType


GraphType = type;

Defines the type of graph to be displayed. The following types are supported:

GROUP datasets are grouped together (default)
ROWS datasets are displayed in separate rows
STACK datasets are stacked

 

GraphLayout


	GraphLayout = type;

Defines the bargraph orientation. The following types are supported:

HORIZONTAL bars are oriented left to right.
VERTICAL bars are oriented bottom to top. (default)

Note that the BarLabels resource will be displayed on the left axis for HORIZONTAL bargraphs and the bottom axis for VERTICAL bargraphs.

 

DataSets


DataSets = (Name1, Color1, Type1), (Name2, Color2, Type2) ...;

Defines a list of datasets with the given name color and type. The names will be used as items in the Legend, and the color will be used for each bar in the dataset.

The following bar types are supported:

  • BAR
  • TRIANGLEBAR
  • DIAMONDBAR
  • CYLINDER
  • PIEVERTICAL
  • PIEHORIZONTAL

Note that some types may produce unusual results if the graph type is STACK or ROWS. If one of the "Pie" types is selected, the alternate pie color will be extracted from the first element of the ColorTable.

At most 50 datasets may be displayed.

If a color is not specified in the vector, then the previously specified color will be used. If the color is specified as "null", then a default color will be chosen from the color table. (See the ColorTable parameter.) Furthermore, if only a single data set is defined and no color value is assigned (or null is assigned) then EVERY bar in that data set will be given a different default color, depending on its position.

 

DataAxis


	DataAxis = (XAxis1, YAxis1), (XAxis2, YAxis2), ...;

The XAxis and YAxis attributes define the specific axis to be used when mapping the X and Y values respectively for each data set defined. The XAxis attribute may be set to BOTTOM or TOP, while the YAxis may be set to LEFT or RIGHT.

 

DataSet[1–50]


	DataSet[1–50] = Number1, Number2, ...;

Defines a list of numeric values for each dataset defined by the DataSets parameter. Each dataset may contain a different number of values. If the value "null" is substituted for a Number, no bar will be drawn in that bar position.

 

DrawOrder


         DrawOrder = SYMBOL, ...;

Defines the order in which Bar, Line and LineFill options will be drawn.

 
BAR refers to ALL bar sets
LINE refers to line sets to do NOT have a fill
LINEFILL refers to line sets which DO have a fill

This parameter was introduced in NetCharts 4.0.

 

BarBorder


      BarBorder = (lineType, lineWidth, lineColor);

This parameter specifies the line style to be used for the border of all bars. The following attribute values are supported:

lineType Specifies the style of the border line to be drawn, as follows: 

SOLID (default), DOTTED, DASHED, DOTDASH
lineWidth The width of the line in pixels. Default width is 1.
lineColor The color of the line. Default color is black.

 

BarLabels


	BarLabels = "String1", "String2", ...;

Defines a list of labels to be displayed below each group of bars. This parameter overrides the BottomLabels parameter (for VERTICAL bars) or the LeftLabels parameter (for HORIZONTAL bars).

 

BarValueLabel


   BarValueLabel = ("mode", color, "font name", font size);

Defines the label value to be displayed on each group of bars. This parameter overrides the BottomLabels parameter (for VERTICAL bars) and the LeftLabels parameter (for HORIZONTAL bars).

Valid mode values are "ON" and "OFF", the default value is "ON". 

   example: ("ON",black,"Helvetica",18);

This parameter was introduced in NetCharts 4.0.

 

BarValueLabelBox

     
   BarValueLabelBox = (color,bordertype,borderwidth);

   example:(grey,RAISED,3);

Defines the label box to be displayed with each group of bars.

Color  The color of the region. If an image attribute is also defined, this color is drawn first, followed by the image, allowing this color to show through any transparent parts of the image.
BorderType  The following border styles are supported: 
NONE    - No border
BOX     - Simple Box outline
SHADOW  - Shadow border
RAISED  - Raised border
RECESS  - Recessed border
When the BOX and SHADOW styles are specified, the border color will be black. When the RAISED and RECESS styles are specified, the border color will be chosen based on the region color.
BorderWidth  This attribute defines the width of the border in pixels. 
This parameter was introduced in NetCharts 4.0.

BarValueLabelStyle

   BarValueLabelStyle = (labelposition1,labelposition2 ..., labelpositionN);

Defines where the BarValueLabel text will display for each dataset. 

    example: BarValueLableStyle = (TOP, MIDDLE, BOTTOM);

Available options for BarValueLabelStyle are:

EXTERNAL Displays just outside of each bar
TOP Displays at the Top of each bar
MIDDLE Displays in the Middle of each bar
BOTTOM Displays at the Bottom of each bar
NONE No bar labels display

This parameter was introduced in NetCharts 4.0.

 

BarActiveLabels


	BarActiveLabels = ("Label1", "URL1", "Target1"),...;

The BarActiveLabels parameter specifies a list of custom active labels to be associated with each bar label. That is, these labels will be displayed whenever the mouse "dwells" over a given bar label. This can be used to provide the user with additional information about that particular bar grouping or to "drill-down" to another document. See Active Labels for a detailed explanation of active label capabilities.

The BarActiveLabels parameter overrides the BottomActiveLabels parameter (for VERTICAL bars) or the LeftActiveLabels parameter (for HORIZONTAL bars).

 

Bar3D Depth

	Bar3DDepth = Number;

Defines the "depth" of the bar in pixels. A depth of 0 draws a 2D bar.

 

BarWidth

	BarWidth = Number;

Defines the relative width of the bar as a percentage of available space. A smaller number results in more space between bars.

 

StackLabel

	StackLabel = type;

Defines how the default active labels should be generated for each bar in a stacked barchart. The following types are supported:

TOTAL use the accumulated total for the label (default)
ITEM use the individual item value for the label