jwo.landserf.gui
Class Histogram

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  jwo.utils.gui.JWGraph
                      jwo.landserf.gui.Histogram

All Implemented Interfaces:

Accessible, ImageObserver, MenuContainer, Serializable

public class Histogram

extends JWGraph

Displays a histogram (commonly a frequency histogram or hammock plot.

Version:

2.2, 21st September, 2002.

Author:

Jo Wood

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class jwo.utils.gui.JWGraph

bottom, centreX, centreY, INTERVAL, items, left, NOMINAL, offscreenImage, og, ORDINAL, RATIO, right, top

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Histogram()
Creates an empty histogram.

Histogram(float yMin, float yMax)
Lays out the canvas for the histogram.

Histogram(float xMin, float xMax, float yMin, float yMax)
Lays out the canvas for the histogram.

Histogram(float xMin, float xMax, String[] xLabels, float yMin, float yMax)
Lays out the canvas for the histogram including explicit labels for the X axis.

Histogram(float xMin, float xMax, String[] xLabels, float yMin, float yMax, int measurementScale)
Lays out the canvas for the histogram including explicit labels for the X axis on the given measurement scale.

Histogram(String title, float yMin, float yMax)
Lays out the canvas for the histogram with given title.

Histogram(String title, float xMin, float xMax, float yMin, float yMax)
Lays out the canvas for the histogram with given title.

Histogram(String title, float xMin, float xMax, String[] xLabels, float yMin, float yMax)
Lays out the canvas for the histogram with given title and including explicit labels for the X axis.

Histogram(String title, float xMin, float xMax, String[] xLabels, float yMin, float yMax, int measurementScale)
Lays out the canvas for the histogram with given title and including explicit labels for the X axis on the given measurement scale.

Method Summary

void	paintComponent(Graphics g) Displays the bars of the histogram.
void	updateXAxis(float min, float max) Updates the histogram X-axis with the given range.
void	updateXAxis(float min, float max, String[] xLabels, int scale) Updates the histogram X-axis with the given range, labels and measurement scale.
void	updateYAxis(float min, float max) Updates the histogram Y-axis with the given range.

Methods inherited from class jwo.utils.gui.JWGraph

addItem, addItem, erase, getFM, getPreferredSize, getXMax, getXMeasurementScale, getXMin, getYMax, getYMeasurementScale, getYMin, makeTransparent, removeItem, removeItems, roundAxes, roundXAxis, roundYAxis, setAspectRatio, setOpacity, setTitle, setXAxis, setXAxis, setXMeasurementScale, setYAxis, setYAxis, setYMeasurementScale

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

Histogram

public Histogram()

Creates an empty histogram.

Histogram

public Histogram(float yMin,
                 float yMax)

Lays out the canvas for the histogram.

Parameters:

yMin - Minimum y value.

yMax - Maximum y value.

Histogram

public Histogram(String title,
                 float yMin,
                 float yMax)

Lays out the canvas for the histogram with given title.

Parameters:

title - Title of bar chart.

yMin - Minimum y value.

yMax - Maximum y value.

Histogram

public Histogram(float xMin,
                 float xMax,
                 float yMin,
                 float yMax)

Lays out the canvas for the histogram.

Parameters:

xMin - Minimum x value.

xMax - Maximum x value.

yMin - Minimum y value.

yMax - Maximum y value.

Histogram

public Histogram(String title,
                 float xMin,
                 float xMax,
                 float yMin,
                 float yMax)

Lays out the canvas for the histogram with given title.

Parameters:

title - Title of bar chart.

xMin - Minimum x value.

xMax - Maximum x value.

yMin - Minimum y value.

yMax - Maximum y value.

Histogram

public Histogram(float xMin,
                 float xMax,
                 String[] xLabels,
                 float yMin,
                 float yMax)

Lays out the canvas for the histogram including explicit labels for the X axis.

Parameters:

xMin - Minimum x value.

xMax - Maximum x value.

xLabels - Array of labels for the X axis.

yMin - Minimum y value.

yMax - Maximum y value.

Histogram

public Histogram(String title,
                 float xMin,
                 float xMax,
                 String[] xLabels,
                 float yMin,
                 float yMax)

Lays out the canvas for the histogram with given title and including explicit labels for the X axis.

Parameters:

title - Title of bar chart.

xMin - Minimum x value.

xMax - Maximum x value.

xLabels - Array of labels for the X axis.

yMin - Minimum y value.

yMax - Maximum y value.

Histogram

public Histogram(float xMin,
                 float xMax,
                 String[] xLabels,
                 float yMin,
                 float yMax,
                 int measurementScale)

Lays out the canvas for the histogram including explicit labels for the X axis on the given measurement scale.

Parameters:

xMin - Minimum x value.

xMax - Maximum x value.

xLabels - Array of labels for the X axis.

yMin - Minimum y value.

yMax - Maximum y value.

measurementScale - Measurement scale for the X axis labels.

Histogram

public Histogram(String title,
                 float xMin,
                 float xMax,
                 String[] xLabels,
                 float yMin,
                 float yMax,
                 int measurementScale)

Lays out the canvas for the histogram with given title and including explicit labels for the X axis on the given measurement scale.

Parameters:

title - Title of bar chart.

xMin - Minimum x value.

xMax - Maximum x value.

xLabels - Array of labels for the X axis.

yMin - Minimum y value.

yMax - Maximum y value.

measurementScale - Measurement scale for the X axis labels.

Method Detail

updateYAxis

public void updateYAxis(float min,
                        float max)

Updates the histogram Y-axis with the given range.

Parameters:

min - New minimum y value.

max - New maximum y value.

updateXAxis

public void updateXAxis(float min,
                        float max)

Updates the histogram X-axis with the given range.

Parameters:

min - New minimum x value.

max - New maximum x value.

updateXAxis

public void updateXAxis(float min,
                        float max,
                        String[] xLabels,
                        int scale)

Updates the histogram X-axis with the given range, labels and measurement scale.

Parameters:

min - New minimum x value.

max - New maximum x value.

xLabels - Labels to use for X axis.

scale - Measurement scale.

paintComponent

public void paintComponent(Graphics g)

Displays the bars of the histogram.

Overrides:

paintComponent in class JWGraph

Parameters:

g - Graphics method to paint to.