JMSLTM Numerical Library 4.0

com.imsl.chart
Class Bar

java.lang.Object
  extended bycom.imsl.chart.AbstractChartNode
      extended bycom.imsl.chart.ChartNode
          extended bycom.imsl.chart.Data
              extended bycom.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
AXIS_X_TOP, 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, DATA_TYPE_TUBE, DENDROGRAM_TYPE_HORIZONTAL, DENDROGRAM_TYPE_VERTICAL, FILL_TYPE_GRADIENT, FILL_TYPE_NONE, FILL_TYPE_PAINT, FILL_TYPE_SOLID, LABEL_TYPE_PERCENT, 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
 
Fields inherited from class com.imsl.chart.AbstractChartNode
AUTOSCALE_DATA, AUTOSCALE_DENSITY, AUTOSCALE_NUMBER, AUTOSCALE_OFF, AUTOSCALE_WINDOW, AXIS_X, AXIS_Y, AXIS_Z, LABEL_TYPE_NONE, LABEL_TYPE_TITLE, LABEL_TYPE_X, LABEL_TYPE_Y, LABEL_TYPE_Z, 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, firePickListeners, getALT, getAxis, getBackground, getBarGap, getBarType, getBarWidth, getChart, getChartTitle, getChildren, getClipData, getComponent, getConcatenatedViewport, getDataType, getDoubleBuffering, getExplode, getFillOutlineColor, getFillOutlineType, getFillPaint, getFillType, getGradient, getHREF, getLegend, getLineDashPattern, getMarkerDashPattern, getMarkerThickness, getMarkerType, getParent, getReference, getScreenAxis, getScreenSize, getScreenViewport, getSize, getSkipWeekends, getTextAngle, getTextColor, getTitle, getToolTip, getViewport, isBitSet, removePickListener, setALT, setBarGap, setBarType, setBarWidth, setChartTitle, setClipData, setCustomTransform, setDataType, setDoubleBuffering, setExplode, setFillOutlineColor, setFillOutlineColor, setFillOutlineType, setFillPaint, setFillPaint, setFillPaint, setFillType, setGradient, setGradient, setGradient, setHREF, setImage, setLineDashPattern, setMarkerDashPattern, setMarkerThickness, setMarkerType, setReference, setScreenSize, setSize, setSkipWeekends, setTextAngle, setTextColor, setTextColor, setTitle, setTitle, setToolTip, setViewport, setViewport
 
Methods inherited from class com.imsl.chart.AbstractChartNode
clone, clone, clone, clone, getAbstractParent, getAttribute, getAutoscaleInput, getAutoscaleMinimumTimeInterval, getAutoscaleOutput, getBooleanAttribute, getChildList, getColorAttribute, getCustomTransform, getDensity, getDoubleAttribute, getFillColor, getFont, getFontName, getFontSize, getFontStyle, getImage, getIntegerAttribute, getLabelType, getLightColor, getLineColor, getLineWidth, getLocale, getMarkerColor, getMarkerSize, getName, getNumber, getPaint, getStringAttribute, getTextFormat, getTickLength, getTransform, getX, getY, isAncestorOf, isAttributeSet, isAttributeSetAtThisNode, parseColor, remove, setAttribute, setAutoscaleInput, setAutoscaleMinimumTimeInterval, setAutoscaleOutput, setDensity, setFillColor, setFillColor, setFont, setFontName, setFontSize, setFontStyle, setImage, setLabelType, setLightColor, setLightColor, setLineColor, setLineColor, setLineWidth, setLocale, setMarkerColor, setMarkerColor, setMarkerSize, setName, setNumber, setPaint, setTextFormat, setTextFormat, setTickLength, setTransform, 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[][] 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[][][] 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 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[] 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[] 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

dataRange

public void dataRange(double[] range)
Overrides Data.dataRange.

Overrides:
dataRange in class Data
Parameters:
range - a double array which contains the new range

getBarData

public double[][][] getBarData()
Returns the "BarData" attribute.

Returns:
a BarData[][][] value

getBarSet

public BarSet[][] getBarSet()
Returns the BarSet object.

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

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

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

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.

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.

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

JMSLTM Numerical Library 4.0

Copyright 1970-2006 Visual Numerics, Inc.
Built June 1 2006.