StatBean Name: FactorBoxPlot

Purpose: Displays a box-and-whisker plot of one numeric variable versus levels of an experimental factor.

DataSource: any.


Read/Write Properties
NameTypeDescriptionPossible ValuesDefault Value
boxWidthintPercentage of plotting area covered by the box.10-10040
confidenceLeveldoubleLevel of confidence for the prediction and confidence limits, as a percentage.0.0001-99.999995.0
drawVerticalbooleanWhether to plot the percentages on the vertical axis.true,falsetrue
factorVariableNameStringThe name of the column with factor levels.Any string.""
flagOutsidePointsbooleanWhether to add point symbols showing values unusually far from the box.true,falsetrue
meanSymbolbooleanWhether to add a plus sign showing the sample mean.true,falsetrue
medianNotchbooleanWhether to add a notch showing a confidence interval for the median.true,falsefalse
includeVariableNameStringThe name of an optional column with values indicating which cases should be included (a non-zero value indicates inclusion).Any string.""
labelSkipFactorintIf >1, will skip (labelSkipFactor1-1) labels between each label displayed..1+1
rotateClassLabelsbooleanWhether to make the bar labels vertical.true,falsefalse
tablewiseExclusionbooleanWhether all rows of the data table containing a missing value in any column should be excluded from the plot.true,falsefalse
xVariableNameStringThe name of the column with data values to be plotted.Any string.""

Other properties are inherited from the java.awt.Canvas class and from the general GraphicalStatbean class.

Code Sample

//create a datasource bean
FileDataSource fileDataSource1 = new STATBEANS.FileDataSource();

//set the file name to be read
fileDataSource1.setFileName("c:\\statbeans\\samples\\cardata.txt");

//create a chart bean
FactorBoxPlot plot1 = new STATBEANS.FactorBoxPlot();
plot1.setBackground(java.awt.Color.yellow);
plot1.setBounds(16,30,380,300);

//set the column to be plotted
plot1.setXVariableName("mpg");

//set the factor column
plot1.setFactorVariableName("year");

//set the direction
plot1.setDrawVertical(true);

//show the plot
add(plot1);

//make the plot bean a listener for changes in the FileDataSource bean
fileDataSource1.addDataChangeListener(plot1.listenerForDataChange);

//instruct the fileDataSource bean to read the file
fileDataSource1.readData();