Bar Chart

Bar charts can consist of 1 to 50 data sets, with any number of values assigned to each data set. Data sets can be displayed by grouping together corresponding bars, stacking them or displaying them in separate rows.

Barcharts can be drawn in 2D, 2.5D or 3D. A 2D chart is flat rectangular bars. In a 2.5D chart the bars are drawn in 3 dimensions and each bar may have a visable front top and side. A 3D barchart has a Z axis that can labeled and a 3 dimensional viewpoint wich can be altered to provide better visability into the data in the chart.

For every bar displayed, an optional active label can be displayed whenever the cursor dwells over that bar. The text value displayed in that label can be specified directly or can be generated automatically from the value represented by that bar. Optionally, a URL can be assigned to that label to allow a drill-down to another web accessible document.

 

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
GROUPSTACK datasets are grouped and 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 Y Axis 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.

 

DataSet[1–50]P[1–50]

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

Defines a list of numeric values for each dataset in a grouped, stacked barchart (GraphType=GROUPSTACK). In a grouped stacked barchart each tic location can contain multiple data sets, and each data set can contain multiple data values.

 

Consider this example:

DataSets = ("Set1"),("Set2"); DataSet1P1 = 0.6,0.7; DataSet1P2 = 2.0,1.1; DataSet1P3 = 1.5,2.0; DataSet2P1 = 0.7,0.9; DataSet2P2 = 1.3,2.1; DataSet2P3 = 2.1,1.4;

This chart contains two data sets, each set has 3 values to display at each tic on the chart.

DataSet1P1 defines two values - the first value in the first set at each tic mark. DataSet2P3 defines two values - the third value of the second set at each tic.

 

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

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.

 

BarColorTable[1-50]

	BarColorTableN = color1, color2, ...;

Defines a set of colors for dataset N that overrides all other color specifications for that set. The parameters used for specifying the color of bars in a chart are (in ascending order of precedence) ColorTable, DataSets, BarSymbol, BarFillPattern and BarColorTable. BarColorTableN is used most frequently to color some specific bar. For example:

		  	BarColorTable2 = ,,blue;
		  
will change the third bar in the second series to blue, while all other bars in the chart continue to be colored by one of the other color related parameters.

BarColorTable[1-50]P[1-50]

	BarColorTable[1-50P[1-50] = color1, color2, ...;

This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines a set of colors for datasetN that overrides all other color specifications for that set. The parameters used for specifying the color of bars in a chart are (in ascending order of precedence) ColorTable, DataSets, BarSymbol, BarFillPattern and BarColorTable[1-50]M[1-50]. BarColorTable is used most frequently to color some specific bar. For example:

		  	BarColorTable2P1 = blue,blue;
		  
will change the color the first bar of the second data series blue at the first tic location and at the second tic location.

 

BarCorners

	BarCorners = (topleft,topright,bottomright,bottomleft);

BarCorners specifies the corner style to be used for the 2D bars in a chart. The attributes correspond to specific corners of the bar beginning at the top left and advancing in clockwise sequence to the bottom left. The default corner style is SQUARE. Elements which can be selected for each corner are: SQUARE, SNIP and ROUND. SNIP trims the square corner from the bar obliquely. ROUND substitutes a smoothly rounded edge for the square corner. The amount to be snipped or rounded can be adjusted by adding an underscore modifier to the elements SNIP and ROUND followed by a value. A whole number value will set the number of pixels to be removed. A fractional value will set the percentage of the overall bar to be removed. To set the percentage, enter a fractional value between 0 and 1 and place it after the underscore (e.g. "SNIP_0.09" will cause 9% of the corner to be removed; "ROUND_0.50" will cause 50% of the corner to be rounded). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal point.

   example: BarCorners = (SNIP,SQUARE,SQUARE,SQUARE);

 

  ROUND  Draws a rounded corner.
  SNIP  Cuts the corner off of obliquely.
  SQUARE  Draws a square corner (default).
  SNIP_val  Cuts the corner off obliquely based upon the number of pixels or percentage shown in val.
  ROUND_val  Draws a rounded corner based upon the number of pixels or percentage shown in val.

 

 

BarDropShadow

	BarDropShadow = (color,offsetx,offsety,size);

BarDropShadow places a shadow on the background field of the bar chart. The color, orientation, and size of the shadow can be defined. The tuple element color sets the color of the shadow. That color value is interpolated to complete transparency as it reaches the end of the shadow's blur area. Offsetx and offsety define the center point of the shadow; offsetx sets the x-axis offset from the chart's center-point; offsety sets the y-axis offset. When an offset attribute is set to a whole number value, the position of the drop shadow is offset from the chart's center point by the number of pixels set by that whole number. When an offset is set to a fractional value (between 0 and 1), the value is interpreted as a percentage of the width of the object casting the shadow (the set of bars). The center of the drop shadow is repositioned based upon the values or percentages set for offsetx and offsety. Offset attribute values may be positive or negative. Size sets the size of the blur area, the region beyond the actual drop shadow shape where the shadow is extended and blurred into transparency. The size of this blurred region is controlled by the size attribute. The blurred region becomes larger and more diffuse as the value of size is increased. When size is set to a whole number value, the size of the blurred area is defined in pixels. When size is set to a fractional value (between 0 and 1), the value is interpreted as a percentage of the width of the object casting the shadow. When using a fractional value, enclose the value in double-quotes to "escape" the decimal point.

 BarDropShadow = (black, "-.05", "-0.05", 55); 

 

 

BarHighlights

	BarHighlights = (type,start,stop,top,right, bottom,left,width,height,topLeft,topRight,bottomRight,bottomLeft), ...;

The BarHighlights parameter provides a visual pattern fill in a bar or combo chart. It adds or overlays a fill pattern over one or more existing fill patterns to produce multiple effects. The width or height of the pattern can be modified. The gap between the sides of the bar and the fill pattern being applied can be modified. Gradient patterns can be set using the type attribute. Only gradient patterns may be used. A type value of NONE suppresses the highlights. The element start sets the beginning color of the gradient; the element stop sets the end color of the gradient. Color values are interpolated between the two. The elements top, right, bottom, and left specify the size of the gaps between the edge of the highlight and the associated edge of the bar. When the values for top, right, bottom, and left are specified as whole numbers, they set the distance between the edge of the highlight and the edge of the bar in pixels. When set to a fractional number between 0 and 1, they set the gap to a percentage of the width of the bar. Percentage values are written using a decimal point (e.g. "0.05" and "0.50" represent 5% and 50%, respectively). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal point. The element width controls the width of the highlight; the element height controls the height. When values for width and height are specified using whole numbers, they set the distance in pixels. If width or height is set to -1, BarHighlights fills all of the space available after taking into account any gaps specified in previous attributes. If width or height is set to a fractional number between 0 and 1, BarHighlights sets the width or height of the highlight using the percentage of available width or height of the bar.

Type NONE no pattern, do default fill, if any
  Gradients
  GRADIENTVERTICAL bottom to top style gradient
  GRADIENTHORIZONTAL left to right style gradient
  GRADIENTFDIAG top right to bottom left style gradient
  GRADIENTBDIAG top left to bottom right style gradient
  GRADIENTRADIAL radial style gradient
  GRADIENTCENTERHORIZONTAL center out horizontal gradient
  GRADIENTCENTERVERTICAL center out vertical gradient
start This color is used in the following ways:
- Starting color for gradients
 
stop

This color is used in the following ways:
- Stopping color for gradients

 
 BarHighlights = (GRADIENTRADIAL,yellow,white,15,15,15,15,-1,-1) 

 

 

BarActiveLabels

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

 

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

 

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

 

BarAnimationStyle

	BarAnimationStyle = GROW | FADE | NONE;

Specifies how the bars initially appear in a chart. This parameter is only valid in SVG or SVGWeb output formats.

   example: BarAnimationStyle = GROW;

GROW

The bars grow from the origin of the axis to their actual values.

FADE The bars fade in.
NONE The bars are immediately visible.

 

Bar3D Depth

	Bar3DDepth = Number;

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

 

BarSpotlights

	BarSpotlights = (start,stop,center,centeroffsetx,centeroffsety,focusoffsetx,focusoffsety,radius),...;

BarSpotLights adds or overlays a color fill over one or more existing fill patterns to produce multiple layered color effects. The spotlight "illuminates" the bars of the chart. The center of the spotlight and its focus can be adjusted independently by adjusting offsets from the bar chart center point. The elements centeroffsetx and centeroffsety set the x and y-coordinates of the center of the spotlight as an offset of the chart center point. When set to whole numbers, centeroffsetx and centeroffsety specify the number of pixels to offset from the chart center point. When set to fractional values (between 0 and 1), they are interpreted as percentages of the width of the bars. Percentage values are written using a decimal point (e.g. "0.05" and "0.50" represent 5% and 50%, respectively). When using a fractional value, enclose the tuple element in double-quotes to "escape" the decimal point. The element focusoffsetx is the offset from the chart center which defines the x-coordinate of the focus point of the spotlight. The element focusoffsety is the offset from the chart center which defines the y-coordinate of the focus point of the spotlight. When set to whole numbers, focusoffsetx and focusoffsety specify the offset from the center in pixels. When set to fractional values (between 0 and 1), they are interpreted as percentages of the width of the bars. The element radius sets the size of the spotlight, from its center to its edge. When set to a whole number, it sets the size of the radius in pixels; when set to a fractional value, it sets the radial diameter of the spotlight based upon that percentage of the minimum height and width of the bars on the chart.

   example: BarSpotlights = (purple_40, blue_155, LEFT, 20,10,120,-120,250);

 

  start  Start specifies the first of the two colors which will be interpolated to produce a gradiant spotlight.
  stop  Stop specifies the second of two colors which will be interpolated to produce a gradiant spotlight.
  center  Center specifies the position around of the center of the chart where the spotlight center will be placed. The following values are supported:
  • RIGHT - Offsets the center point of the spotlight to the right of the center point of the chart.
  • LEFT - Offsets the center point to the left.
  • TOP - Offsets the center point to the top.
  • BOTTOM - Offsets the center point to the bottom.
  • CENTER - Uses the chart center point for the spotlight center point.
  • TOPRIGHT - Offsets the center point of the spotlight to the top right.
  • TOPLEFT - Offsets the center point of the spotlight to the top left.
  • BOTTOMRIGHT - Offsets the center point of the spotlight to the bottom right.
  • BOTTOMLEFT - Offsets the center point of the spotlight to the bottom left.
  centeroffsetx  Centeroffsetx specifies the x-coordinate offset for the spotlight center.
  centeroffsety  Centeroffsety specifies the y-coordinate offset for the spotlight center.
  focusoffsetx  Focusoffsetx specifies the x-coordinate offset for the center of the spotlight's focus.
  focusoffsety  Focusoffsety specifies the y-coordinate offset for the center of the spotlight's focus.
  radius  Radius specifies the length of the radius of the spotlight from the center of the spotlight

BarSymbol

BarSymbol = (Type1,Color1), (Type2,Color2) ...;

Defines the style and color of the bars in a barest. Values specified in this parameter override values set in the DataSets parameter.

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.


BarValueLabel


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

Defines the label style to be displayed on each group of bars.

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.

 


BarValueLabelBox

     
   BarValueLabelBox = (color,bordertype,borderwidth);


Defines the label box to be displayed with each group of bars.
The legal values for border type are as follows:

   example:(grey,RAISED,3);          
 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: BarValueLabelStyle = 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.

 


BarWidth

	BarWidth = Width1,Width2,...WidthN;

Defines the relative width of the bars in a barset as a percentage of available space. Legal values are 1-100. A smaller number results in more space between bars. WidthN defines the Width for DataSetN.

 

GroupStackLabels

	GroupStackLabels = "label1","label2",...;

This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines labels for each stack of data points in a group. If this value is unspecified and ShowGroupStackLabels=ON; the set names defined in the DataSets parameter will be used as the stack labels.

GroupStackSegmentLabels

	GroupStackSegmentLabels = "label1","label2",...;

This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines labels for each value in a stack of data points at a single tic location. These labels will be displayed in the legend of the chart. GroupStackSegmentLabels may be overridden by the LegendItems parameter.

ShowGroupStackLabels

	ShowGroupStackLabels = ON|OFF;

This parameter is used only for grouped stacked barcharts (GraphType=GROUPSTACK). It defines whether stack labels will be drawn at each tic. The default value is OFF

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

 

StackDisplayOrder

	StackDisplayOrder = BOTTOMUP|TOPDOWN;

Defines the ordering of legend items in a chart with multiple bar series. The default is BOTTOMUP, which specifies that the legend items will be displayed in the order in which the data sets are specified. For example DataSet1, will appear in the legend first. TOPDOWN is useful when multiple series of bars are stacked and the legend is displayed vertically. In this mode, the stack of legend items will be "stacked" in the same order as the bars in the chart.

StackedBarConnectors

	StackedBarConnectors = OFF | LINE | FILLED;

StackedBarConnectors defines the bars in a particular series can be connected together with lines. This improves the users ability to track the values of a single series of values across a multiseries stacked barchart. This is valid on for multiseries barcharts or combocharts when GraphType is STACK. The lines are drawn using the drawing attributes specified in the BarBorder parameter. If BarBorder not defined, one pixel solid black lines are drawn.

OFF specifies that no connectors are drawn.

LINE specifies that lines are drawn between the top and bottom of bars in the same series.

FILL specifies that lines are drawn between the top and bottom of bars in the same series and the area between those lines is filled with the bar set color.

ViewPoint

	ViewPoint = (CARTESIAN,X,Y,Z);
	ViewPoint = (SPHERICAL,radius,phi,theta);

The view point from which a 3d barchart is rendered. The viewpoint can only be in front, on top, and to the right of the center of the chart.

If the CoordinateSystem is CARTESIAN, then the numeric values that follow are the X, Y and Z coordinates of the viewpoint for the chart. X,Y and Z are relative to size of the chart and must be positive. Setting any of the coordinates to a negative number is the same as setting that coordinate to 0. To look at the front of the chart, set the view point to (0, 0, a). To look at the chart from a 45 degree angle, set the view point to (a, 0, a). The greater a is, the further the camera is from the chart.

If the CoordinateSystem is SPHERICAL, then the numeric values that follow are the radius, angle of elevation (phi) and the angle of rotation (theta).

Radius is the distance the viewpoint is from the center of chart when coordinate system is SPHERICAL. Radius should be specified as a positive integer. The magnitude of the radius is relative to the width and height of the chart.

Phi is the angle of elevation of the viewpoint when coordinate system is SPHERICAL. Phi should be specified as an angle between 0 and 90. 0 is the angle looking directly at the front of the chart. 90 is the angle looking directly down at the top of the chart.

Theta is the angle of rotation of the viewpoint when coordinate system is SPHERICAL. Theta should be specified as an angle between 0 and 90. 0 is the angle looking directly at the front of the chart. 90 is the angle looking directly at the end of the chart.

ZAxisLabels

	ZAxisLabels = (ON|OFF, Color, FontName, FontSize, Angle, interiorAlignment);

The drawing style for Z axis labels in a 3D Barchart.