com.imsl.chart
Class Bar

java.lang.Object
  com.imsl.chart.ChartNode
      com.imsl.chart.Data
          com.imsl.chart.Bar

All Implemented Interfaces:

Cloneable, Serializable

public class Bar

extends Data

A bar chart.

The class Bar has children of class BarItem. The attribute "BarItem" in class Bar is set to the BarItem array of children.

See Also:

Example, BarSet, BarItem, Chart Programmer's Guide: Bar Chart, Chart Programmer's Guide: Histogram, Serialized Form

Field Summary

Fields inherited from class com.imsl.chart.ChartNode

AUTOSCALE_DATA, AUTOSCALE_DENSITY, AUTOSCALE_NUMBER, AUTOSCALE_OFF, AUTOSCALE_WINDOW, AXIS_X, AXIS_X_TOP, AXIS_Y, AXIS_Y_RIGHT, BAR_TYPE_HORIZONTAL, BAR_TYPE_VERTICAL, DASH_PATTERN_DASH, DASH_PATTERN_DASH_DOT, DASH_PATTERN_DOT, DASH_PATTERN_SOLID, DATA_TYPE_FILL, DATA_TYPE_LINE, DATA_TYPE_MARKER, DATA_TYPE_PICTURE, FILL_TYPE_GRADIENT, FILL_TYPE_NONE, FILL_TYPE_PAINT, FILL_TYPE_SOLID, LABEL_TYPE_NONE, LABEL_TYPE_PERCENT, LABEL_TYPE_TITLE, LABEL_TYPE_X, LABEL_TYPE_Y, MARKER_TYPE_ASTERISK, MARKER_TYPE_CIRCLE_CIRCLE, MARKER_TYPE_CIRCLE_PLUS, MARKER_TYPE_CIRCLE_X, MARKER_TYPE_DIAMOND_PLUS, MARKER_TYPE_FILLED_CIRCLE, MARKER_TYPE_FILLED_DIAMOND, MARKER_TYPE_FILLED_SQUARE, MARKER_TYPE_FILLED_TRIANGLE, MARKER_TYPE_HOLLOW_CIRCLE, MARKER_TYPE_HOLLOW_DIAMOND, MARKER_TYPE_HOLLOW_SQUARE, MARKER_TYPE_HOLLOW_TRIANGLE, MARKER_TYPE_OCTAGON_PLUS, MARKER_TYPE_OCTAGON_X, MARKER_TYPE_PLUS, MARKER_TYPE_SQUARE_PLUS, MARKER_TYPE_SQUARE_X, MARKER_TYPE_X, TEXT_X_CENTER, TEXT_X_LEFT, TEXT_X_RIGHT, TEXT_Y_BOTTOM, TEXT_Y_CENTER, TEXT_Y_TOP, TRANSFORM_CUSTOM, TRANSFORM_LINEAR, TRANSFORM_LOG

Constructor Summary

Bar(AxisXY axis)
Constructs a bar chart.

Bar(AxisXY axis, double[] y)
Constructs a simple bar chart using supplied y data.

Bar(AxisXY axis, double[][] y)
Constructs a grouped bar chart using supplied x and y data.

Bar(AxisXY axis, double[][][] y)
Constructs a stacked, grouped bar chart using supplied y data.

Bar(AxisXY axis, double[] x, double[] y)
Constructs a simple bar chart using supplied x and y data.

Bar(AxisXY axis, double[] x, double[][] y)
Constructs a grouped bar chart using supplied x and y data.

Bar(AxisXY axis, double[] x, double[][][] y)
Constructs a stacked, grouped bar chart using supplied x and y data.

Method Summary

void	dataRange(double[] range) Overrides Data.dataRange.
double[][][]	getBarData() Returns the "BarData" attribute.
BarSet[][]	getBarSet() Returns the BarSet object.
BarSet	getBarSet(int group) Returns the BarSet object.
BarSet	getBarSet(int stack, int group) Returns the BarSet object.
void	paint(Draw draw) Paints this node and all of its children.
void	setBarData(double[][][] value) Convenience routine to set the "BarData" attribute.
void	setLabels(String[] labels) Sets up an axis with bar labels.
void	setLabels(String[] labels, int type) Sets up an axis with bar labels.

Methods inherited from class com.imsl.chart.Data

formatLabel

Methods inherited from class com.imsl.chart.ChartNode

addPickListener, clone, clone, clone, clone, firePickListeners, getALT, getAttribute, getAutoscaleInput, getAutoscaleMinimumTimeInterval, getAutoscaleOutput, getAxis, getBackground, getBarGap, getBarType, getBarWidth, getBooleanAttribute, getChart, getChartTitle, getChildren, getClipData, getColorAttribute, getComponent, getConcatenatedViewport, getCustomTransform, getDataType, getDensity, getDoubleAttribute, getDoubleBuffering, getExplode, getFillColor, getFillOutlineColor, getFillOutlineType, getFillPaint, getFillType, getFont, getFontName, getFontSize, getFontStyle, getGradient, getHREF, getImage, getIntegerAttribute, getLabelType, getLegend, getLineColor, getLineDashPattern, getLineWidth, getLocale, getMarkerColor, getMarkerDashPattern, getMarkerSize, getMarkerThickness, getMarkerType, getName, getNumber, getPaint, getParent, getReference, getScreenAxis, getScreenSize, getScreenViewport, getSize, getSkipWeekends, getStringAttribute, getTextAngle, getTextColor, getTextFormat, getTickLength, getTitle, getToolTip, getTransform, getViewport, getX, getY, isAncestorOf, isAttributeSet, isAttributeSetAtThisNode, isBitSet, parseColor, remove, removePickListener, setALT, setAttribute, setAutoscaleInput, setAutoscaleMinimumTimeInterval, setAutoscaleOutput, setBarGap, setBarType, setBarWidth, setChartTitle, setClipData, setCustomTransform, setDataType, setDensity, setDoubleBuffering, setExplode, setFillColor, setFillColor, setFillOutlineColor, setFillOutlineColor, setFillOutlineType, setFillPaint, setFillPaint, setFillPaint, setFillType, setFont, setFontName, setFontSize, setFontStyle, setGradient, setGradient, setGradient, setHREF, setImage, setImage, setLabelType, setLineColor, setLineColor, setLineDashPattern, setLineWidth, setLocale, setMarkerColor, setMarkerColor, setMarkerDashPattern, setMarkerSize, setMarkerThickness, setMarkerType, setName, setNumber, setPaint, setReference, setScreenSize, setSize, setSkipWeekends, setTextAngle, setTextColor, setTextColor, setTextFormat, setTextFormat, setTickLength, setTitle, setTitle, setToolTip, setTransform, setViewport, setViewport, setX, setY, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Bar

public Bar(AxisXY axis)

Constructs a bar chart.

Parameters:

axis - the AxisXY parent of this node

Bar

public Bar(AxisXY axis,
           double[] y)

Constructs a simple bar chart using supplied y data.

Parameters:

axis - the AxisXY parent of this node

y - a double array which contains the y data for the simple bar chart

Bar

public Bar(AxisXY axis,
           double[] x,
           double[] y)

Constructs a simple bar chart using supplied x and y data.

Parameters:

axis - the AxisXY parent of this node

x - a double array which contains the x data for the simple bar chart

y - a double array which contains the y data for the simple bar chart

Bar

public Bar(AxisXY axis,
           double[][] y)

Constructs a grouped bar chart using supplied x and y data.

Parameters:

axis - the AxisXY parent of this node

y - a double array which contains the y data for the grouped bar chart. The first index refers to the group and the second refers to the x position.

Bar

public Bar(AxisXY axis,
           double[] x,
           double[][] y)

Constructs a grouped bar chart using supplied x and y data.

Parameters:

axis - the AxisXY parent of this node

x - a double array which contains the x data for the grouped bar chart

y - a double array which contains the y data for the grouped bar chart. The first index refers to the group and the second refers to the x position.

Bar

public Bar(AxisXY axis,
           double[][][] y)

Constructs a stacked, grouped bar chart using supplied y data.

Parameters:

axis - the AxisXY parent of this node

y - a double array which contains the y data for the stacked, grouped bar chart. The first index refers to the stack, the second refers to the group and the third refers to the x position.

Bar

public Bar(AxisXY axis,
           double[] x,
           double[][][] y)

Constructs a stacked, grouped bar chart using supplied x and y data.

Parameters:

axis - the AxisXY parent of this node

x - a double array which contains the x data for the stacked, grouped bar chart

y - a double array which contains the y data for the stacked, grouped bar chart. The first index refers to the "stack", the second refers to the group and the third refers to the x position.

Method Detail

setLabels

public void setLabels(String[] labels,
                      int type)

Sets up an axis with bar labels. This turns off the tick marks and sets the "BarType" attribute. It also turns off autoscaling for the axis and sets its "Window", "Number" and "Ticks" attributes as appropriate for a labeled bar chart.

Parameters:

labels - a String array with which to label the axis. The number of labels must equal the number of items.

type - an int which specifies the BarType. Legal values are BAR_TYPE_VERTICAL or BAR_TYPE_HORIZONTAL. This determines the axis to be modified.

See Also:

ChartNode.BAR_TYPE_VERTICAL, ChartNode.BAR_TYPE_HORIZONTAL

setLabels

public void setLabels(String[] labels)

Sets up an axis with bar labels. This turns off the tick marks and sets the BarType attribute. It also turns off autoscaling for the axis and sets its Window and Number and Ticks attribute as appropriate for a labeled bar chart. The existing value of the BarType attribute is used to determine the axis to be modified.

Parameters:

labels - a String array with which to label the axis. The number of labels must equal the number of items.

paint

public void paint(Draw draw)

Paints this node and all of its children. This is normally called only by the paint method in this node's parent.

Overrides:

paint in class Data

Parameters:

draw - the Draw object to be painted

dataRange

public void dataRange(double[] range)

Overrides Data.dataRange.

Overrides:

dataRange in class Data

Parameters:

range - a double array which contains the new range

getBarSet

public BarSet[][] getBarSet()

Returns the BarSet object.

Returns:

a BarSet[][] value

getBarSet

public BarSet getBarSet(int stack,
                        int group)

Returns the BarSet object.

Parameters:

stack - an int which specifies the stack index

group - an int which specifies the group index

Returns:

a BarSet[][] value

getBarSet

public BarSet getBarSet(int group)

Returns the BarSet object. The group index is assumed to be zero. This method is most useful for charts with only a single group.

Parameters:

group - an int which specifies the group index

Returns:

a BarSet[][] value

setBarData

public void setBarData(double[][][] value)

Convenience routine to set the "BarData" attribute.

Parameters:

value - a BarData[][][] array of objects that make up this bar chart. The first index refers to the "stack", the second refers to the group and the third refers to the x position.

getBarData

public double[][][] getBarData()

Returns the "BarData" attribute.

Returns:

a BarData[][][] value