Box Chart

The Box Chart now supports four distinct display types and the statistical analysis necessary to produce each. The Box chart plot types include standard, EDA, 10/90, PercentN and Gaussian. The syntax for specifying the plot type is

PlotType= STANDARD | EDA | GAUSSIAN | TENNINETY | PERCENTN;

A Standard Box Chart for a given series or data shows the 25th , 75th percentile, and median as a box. The Inter Quartile Range (IQR) is defined as (75th percentile – 25th percentile). The Lower Adjacent Value (LAV ) is calculated as at the 25th percentile – 1.5*IQR. The Upper Adjacent Value (UAV) is calculated as 75th percentile + 1.5*IQR. The standard Box Chart draws two whiskers based on the UAV and LAV. If the minimum value is greater than the LAV, the first whisker is drawn to that minimum point, otherwise the first whisker ends at the LAV. Likewise, if the maximum data point is less than the UAV the second whisker is drawn to the maximum, otherwise the second whisker ends at the UAV. Data points outside this bounds of the UAV and LAV are plotted individually as outliers.

An Exploratory Data Analysis (EDA) Box chart is also based on the IQR. An EDA Box chart shows the 25th and 75th percentile, and median as a box. The EDA Box Chart also draws whiskers from the box to the lowest point inside the LAV and the highest point inside the UAV. The EDA Box Chart draws four additional fences. The Lower Outer Fence is drawn at the 25th percentile - 3*IQR. The Lower Inner Fence is drawn at the 25th percentile - 1.5*IQR. The Upper Outer Fence is drawn at the 75th percentile + 3*IQR. The Upper Inner Fence is drawn at the 75th percentile + 1.5*IQR. Data points outside the inner fences are plotted individually as outliers.

The 10/90 Box Chart for a given data series shows the 10th percentile, median and 90th percentile as a box, and draws whiskers to the minimum and maximum data points.

The PERCENTN Box Chart for a given data series shows the Nth percentile, median and 100-Nth percentile as a box, and draws whiskers to the minimum and maximum data points.

The Gaussian Box chart for a given data series shows the minimum, mean and maximum as a box. One whisker is draws to the mean - 3*the standard deviation of the series. The other whisker is drawn to the mean + 3*the standard deviation of the series.

DataType


DataType = type;

Defines the type of data in the data sets. The following types are supported:

 
RAW Data is raw statistical data. Percentiles and other ancilliary information will be computed based on these values.
SUMMARY Percentile information has already been computed. The data is formatted as follows:
	v1 = 25th Percentile
	v2 = 50th Percentile (median)
	v3 = 75th Percentile
	v4 = smallest (non outlier)
	v5 = biggest (non outlier)
	v6 ... = outliers (if any)

Example: DataType = RAW;

 

DataSets


	DataSets = (DataSetName1, BorderType1, BorderWidth1, "ImageURL", ImageFormat1, BorderColor1),...;

Defines a list of datasets with the given name and color.

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 color.html for more information.)

Example: DataSets = (DataSetName1, BorderType1, BorderWidth1, "ImageURL", ImageFormat1, BorderColor1),...;

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.

Example: DataAxis = (BOTTOM,LEFT);

DataSet[1–50]

	DataSet[1-50] = v1, v2, v3, v4, ...;

Defines a list of raw or summary values (see DataType above).

Example: DataSet = 10,20,30;

MedianColor

	MedianColor = color;

Defines the color to be used when drawing the median. if not defined, the default color is white.

Example: MedianColor = red;

PercentileN

	PercentileN = N;

Defines the value of N when PlotType=PERCENTN. N specifies that for a given data series the chart will show the Nth percentile, median and 100-Nth percentile as a box, and draws whiskers to the minimum and maximum data points.

Example: PercentileN = 5;

 

BoxLabels


	BoxLabels = "label1","label2",...;

The BoxLabels parameter specifies optional label to be associated with the data series on a box chart. If the GraphLayout of the BoxChart is VERTICAL then BoxLabels will be displayed on the Bottom Axis. If the GraphLayout of the BoxChart is HORIZONTAL then BoxLabels will be displayed on the Left Axis.

 

BoxActiveLabels


	BoxActiveLabels = ("label1",url1,target1),("label2", url2, target2)...;

The BoxActiveLabels parameter specified a custom active label to be associated with the BoxLabels on a box chart. That is, these labels will be displayed whenever the mouse "dwells" over the optional name of a box data series.

 

FencePosition


	FencePosition = OVER | UNDER;

FencePosition specifies whether to draw the fences that are within the Inter Quartile Range, (the box), over or under the box.

Default is OVER.

Example: FencePosition = OVER;

 

BoxFence


	BoxFence = ON | OFF;

BoxFence specifies whether or not to draw fences at the ends of the Inter Quartile Range (the box).
ON Draw fences at the ends of the Inter Quartile Range, (the box).
OFF Do not draw fences.

Default is ON.

Example: BoxFence = ON;

 

DrawFences


DrawFences = ON | OFF;

DrawFences specifies whether or not to draw fences on the chart.

Example: DrawFences = OFF;

Default DrawFences ON.

 

FenceActiveLabelsN


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

FenceActiveLabels define the active labels associated with the fences in box series N.

Example: FenceActiveLabels2 = ("LabelName", "demo.html", "frame1");


WhiskerType


	WhiskerType = BOX | LINE;

WhiskerType controls the width of the whisker on a box. The whisker can be drawn as either a line or a box.
LINE Line whiskers are 1 pixel
BOX BOX is 40% of the main box width


Default is BOX.

Example: WhiskerType = BOX;

 

BoxSymbolWidth


	BoxSymbolWidth = Percentage;

BoxSymbolWidth controls the width of the box relative to the width of the fences. It is specified as a percent. A value of 100 would cause the box width and fence width to be equal.

Default BoxSymbolWidth is 95.

Example: BoxSymbolWidth = 20;

 


BoxWidth


	BoxWidth = Percentage;

BoxWidth controls the width of the box and fences relative to the space allotted to the data series. It is specified as a percent. If a dataset is allocated 100 pixels of space in the chart, setting the BoxWidth to 50 would cause the box and fences to use half of that space for their width.

Default BoxWidth is 75.

Example: BoxWidth = 50;

 


NaturalDisplayOrder


NaturalDisplayOrder = ON | OFF;

The new Box Chart provides control over the left to right order of data set displays. The default behavior for a BoxChart in VERTICAL mode is to display the series from right to left. Most charts make more sense when they are laid out left to right. The NaturalDisplayOrder parameter provides control over this behavior.

Example: NaturalDisplayOrder = ON;

Default NaturalDisplayOrder is ON.

 

RelativeBoxSymbolWidth


RelativeBoxSymbolWidth = OFF | LINEAR | SQRT;

RelativeBoxSymbolWidth instructs the Box Chart to assign widths to the boxes in the chart based on a function of the relative number of points in each data series. For example, if a value of LINEAR is used, a data series with 100 data points will have a box width twice that of a box representing a data series with only 50 data points. If a value of SQRT is used, the relative box sizes will be calculated as a function of the square root of the number of points in each series.

Example: RelativeBoxSymbolWidth = SQRT;

Default RelativeBoxSymbolWidth is OFF.

 

ShowDataPoints


	ShowDataPoints = ON | OFF;

ShowDataPoints is used to display the raw data in addition to the summary data for each series.

Example: ShowDataPoints = ON;

Default ShowDataPoints is OFF.

 


DataPointJitter


	DataPointJitter = ON | OFF;

DataPointJitter is used to increase the visibility of individual points when displaying raw data. The jitter option adds random horizontal jitter to the x values of each data point, allowing multiple points with the same Y value to be distinguishable.

Example: DataPointJitter = ON;

Default DataPointJitter is ON.

 

MinimumDataPoints


	MinimumDataPoints = int_val;

MinimumDataPoints defines the number of data points the must be present in a series in order for the chart to draw in summary mode. IF ShowDataPoints is OFF, and the minimum number of data points necessary to calculate a summary display are not present, the raw data will be displayed.

Example: MinimumDataPoints = 12;

 

 

DataPointSymbol


	DataPointSymbol = (type1, size1, style1, bordercolor1, borderwidth1, image1, color1),...;

DataPointSymbol is used to define the style in which to draw data points when displaying raw data.

typeN

the type of symbol to use for points in data series N. Legal values are NONE, CIRCLE, SQUARE, DIAMOND, CROSS,TRIANGLEDOWN, TRIANGLEUP, IMAGE

sizeN

the size in pixels of the the symbols for points in data series N
styleN
the drawing style for points in data series N. Legal values are FILLED, OUTLINED or BOTH

borderColorN

the color of the border for points in data series N
borderWidthN the width in pixels of the border for points in data series N
imageN the image to use for displaying for points in data series N
colorN the color for points in data series N

 

Example: DataPointSymbol = (CIRCLE,3,FILLED,red,2,,green);



DataPointColor


	DataPointColor = Color;

DataPointColor allows users to specify the color to be used to display the raw data points.
This value is used if no color is specified in the DataPointSymbol parameter.

Example: DataPointColor = red;

 

DataPointActiveLabels(n)


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

DataPointActiveLabels define the active labels associated with raw data points in a particular series.

Example: DataPointActiveLabels1 = (lightgray, SHADOW, 3,,,gray);

 

 

MeanSymbol


	MeanSymbol= (type1, size1, style1, bordercolor1, borderwidth1, image1, color1),...;

MeanSymbol is used to define the style in which to draw the mean value.
typeN the type of symbol to use for the mean in data series N. Legal values are NONE, CIRCLE, SQUARE, DIAMOND, CROSS,TRIANGLEDOWN, TRIANGLEUP, IMAGE
sizeN the size in pixels of the the symbols for the mean in data series N
styleN the drawing style for the mean in data series N. Legal values are FILLED, OUTLINED or BOTH
borderColorN the color of the border for the mean in data series N
borderWidthN the width in pixels of the border for the mean in data series N imageN the image to use for displaying for the mean in data series N
colorN the color for the mean in data series N

 

Example: MeanSymbol = (CIRCLE, 6, BOTH, white, 1);


MeanColor


	MeanColor = Color;

MeanColor allows users to specify the color to be used to display the mean value. This value
is used if no color is specified in the MeanSymbol parameter. The default value is the value of MedianColor.

Example: MeanColor = red;


MeanLine


	MeanLine = (type, width, color);

MeanLine allows the users to draw a line that connects the mean of each data series in a Box Chart.

Example: MeanLine = (DASHED, 3, green);

 

MeanActiveLabels


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

MeanActiveLabels define the active labels associated with mean values.

Example: MeanActiveLabels = (lightgray, SHADOW, 3,,,gray);

 

OutlierColor

	OutlierColor = color;

Defines the color to be used when drawing outliers. This value is used if no color is specified in the OutlierSymbol parameter. The default value is the value of MedianColor.

Example: OutlierColor = blue;

 

OutlierSymbol


	OutlierSymbol = (type1, size1, style1, bordercolor1, borderwidth1,image1, color1),...;

OutlierSymbol is used to define the style in which to draw the mean value

Example: OutlierSymbol = (NONE, 3, FILLED, green,2, , blue);

 

OutlierActiveLabels


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

OutlierActiveLabels define the active labels associated with the outlying points in a particular data set.

Example: OutlierActiveLabels4 = (lightgray, SHADOW, 3,,,gray);



BoxLimitLines


	BoxLimitLines = (limit1-1,limit1-2,…limit1-N),…(limitM-1, limitM-2,… limitM-N);

BoxLimitLines allows the user to specify the values for the limit lines for individual data series.

Example: BoxLimitLines = (2,4,6),(3,6,9),...;

 


BoxLimitLineStyle


	BoxLimitLineStyle = (type1,width1,color1),...(typeN,widthN,colorN);

BoxLimitLineStyles defines the look of the limit lines for each data series. All limit lines for a single data series must have the same style.

typeN

the type of line for limit line N. Legal values are SOLID, DASHED,DOTTED and DOTDASH

widthN

the width in pixels of limit line N
colorN the color or limit line N

Example: BoxLimitLineStyle = (SOLID,1,red),(SOLID,2,green);


GraphLayout


	GraphLayout = type;

Defines the bar orientation. The following types are supported:

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

 

Example: GraphLayout = VERTICAL;

 

PlotType


	PlotType= Type;

PlotType defines the type of plot to be displayed.

STANDARD
The Standard is the difference between the upper hinge (the 75th percentile) and the lower hinge (the 25th percentile).ndard type of box plot, the box represents the IQR. The Inter-Quartile Range
EDA
The Exploratory Data Analysis (EDA) box chart is similar to the Standard box chart in that the box is based on the IQR, and the median is plotted as a line through the box. (The lower part of the box is also referred to as the lower quartile, and the upper part of the box is then referred to as the upper quartile.) However, this type of plot features additional elements called fences. The fences are defined as follows:
Lower Outer Fence = lower quartile - 3 * IQR
Lower Inner Fence = lower quartile - 1.5 * IQR
Upper Inner Fence = upper quartile + 1.5 * IQR
Upper Outer Fence = upper quartile + 3 * IQR
GAUSSIAN
The Gaussian box chart is different from the other options in terms of which statistics is represents. The lower portion of the box is the minimum value, and the upper portion of the box is the maximum value. The mean value is shown as a line through the box. The lower whisker is equal to the mean value minus three standard deviations, and the upper whisker is equal to the mean value plus three standard deviations.
TENNINETY
This represents the minimum, 10th percentile, median, 90th percentile, and the maximum. In this plot, there are no outside values, fences, adjacent values, etc. The minimum value is the end of one whisker, and the maximum value is the end of the other whisker.
PERCENTN
This represents the minimum, Nth percentile, median, 100-Nth percentile, and the maximum. In this plot, there are no outside values, fences, adjacent values, etc. The minimum value is the end of one whisker, and the maximum value is the end of the other whisker. When N=10, this PlotType behaves like TENNINETY

 

Default is STANDARD.

Example: PlotType = GAUSSIAN;


BoxHeight

	BoxHeight = height;

Defines the height (in pixels) for each box displayed. If the value is 0, then a default height will be selected based on the size of the display and the number of data sets being displayed. The default size will also be used if the specified height is taller than the amount of space that is physically available to a given box.

Example: BoxHeight = 30;