JMSLTM Numerical Library 5.0.1

com.imsl.chart
Class Bar

java.lang.Object
  extended by com.imsl.chart.AbstractChartNode
      extended by com.imsl.chart.ChartNode
          extended by com.imsl.chart.Data
              extended by com.imsl.chart.Bar
All Implemented Interfaces:
Serializable, Cloneable
Direct Known Subclasses:
ParetoChart

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)
          Update the data range, range = {xmin,xmax,ymin,ymax}.
 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, prePaint, 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)
Update the data range, range = {xmin,xmax,ymin,ymax}. The entries in range are updated to reflect the extent of the data in this node. The argument range is an input/output variable. Its value should be updated only if the data in this node is outside the range already in the array.

Overrides:
dataRange in class Data
Parameters:
range - a double array which contains the updated range, {xmin,xmax,ymin,ymax}

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 5.0.1

Copyright © 1970-2008 Visual Numerics, Inc.
Built July 8 2008.