All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class jsz.Plotter.Plotter

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----javax.swing.JComponent
                           |
                           +----javax.swing.JPanel
                                   |
                                   +----jsz.Plotter.Plotter

public class Plotter

extends JPanel

implements Observer

Version:

$Revision: 1.7 $

Author:

Janek Schwarz

ALL

style for inscribing ticks: mark each tick

axisColor

color, in which axis, ticks and caption are drawn

axisFont

font used for caption

currentHeight

width this SWING component

currentWidth

height this SWING component

FIT

adjust {x|y}min and {x|y}max so the values fit in the graph

MAXIMA

style for inscribing ticks: just mark the maxima at both axises

MAXIMA_ZERO

style for inscribing ticks: same as MAXIMA, but zero position as well

NONE

used, when signaling "ignore something"

OBJECT

style for inscribing ticks: pass every tick value to an object and let this object mark the tick.

plots

collection of IDataSeries', which have to be plotted

SCROLL

adjust xmin and xmax so older values are scrolled to the left

ticksAsDottedLines

it possible to draw dotted lines instead of ticks.

xAxisBehaviour

how to behave when a value is larger than xmax or smaller than xmin.

xmax

logical dimension of the graph: maximal x-value

xmin

logical dimension of the graph: minimal x-value

xTicksCaptionObject

if xTicksCaptionStyle equals to OBJECT then this variable contains a reference to the caption object

xTicksCaptionStyle

style with which the x-axis is marked

xTicksDistance

each xTicksDistance a tick is drawn on the axis

yAxisBehaviour

how to behave when a value is larger than ymax or smaller than ymin.

ymax

logical dimension of the graph: maximal y-value

ymin

logical dimension of the graph: minimal y-value

yTicksCaptionObject

if yTicksCaptionStyle equals to OBJECT then this variable contains a reference to the caption object

yTicksCaptionStyle

style with which the y-axis is marked

yTicksDistance

each yTicksDistance a tick is drawn axis

Plotter()

Plotter(double, double, double, double, double, double)

addPlot(IDataSeries)

Add a new collection of data and plot it.

drawPlots(Graphics)

plot the data of all registered plots.

drawXaxis(Graphics)

draw x-axis.

drawYaxis(Graphics)

draw x-axis.

getMinimumSize()

getPreferredSize()

getSize()

getTicksAsDottedLines()

get, wether ticks are drawn as dotted lines spawning the component's background

getXaxisBehaviour()

get , how the x-axis behaves when we attempt to plot a value

getXMax()

get logical x-dimension (maximum)

getXMin()

get logical x-dimension (minimum)

getXticksCaptionObject()

return the caption object for the x-axis.

getXticksCaptionStyle()

get, how x axis is marked.

getXticksDistance()

get the distance between to ticks on x-axis

getYaxisBehaviour()

get , how the y-axis behaves when we attempt to plot a value

getYMax()

get logical y-dimension (maximum)

getYMin()

get logical y-dimension (minimum)

getYticksCaptionObject()

return the caption object for the y-axis.

getYticksCaptionStyle()

get, how y axis is marked.

getYticksDistance()

get the distance between to ticks on y-axis

paintComponent(Graphics)

setBounds(Rectangle)

setSize(Dimension)

setSize(int, int)

setTicksAsDottedLines(boolean)

set, wether ticks are drawn as dotted lines spawning the component's background or as short lines crossing an axis.

setXaxisBehaviour(int)

set, how the x-axis behaves when we attempt to plot a value which is larger or smaller than xmax resp.

setXMax(double)

set logical x-dimension (maximum)

setXMin(double)

set logical x-dimension (minimum)

setXticksCaptionObject(ITickCaption)

Mark the x-axis using an object.

setXticksCaptionStyle(int)

set, how x axis is marked.

setXticksDistance(double)

Set the distance between to ticks on x-axis

setYaxisBehaviour(int)

set, how the y-axis behaves when we attempt to plot a value which is larger or smaller than ymax resp.

setYMax(double)

set logical y-dimension (maximum)

setYMin(double)

set logical y-dimension (minimum)

setYticksCaptionObject(ITickCaption)

Mark the y-axis using an object.

setYticksCaptionStyle(int)

set, how y axis is marked.

setYticksDistance(double)

Set the distance between to ticks on y-axis

translateX(double)

map values in [xmin, xmax] to [0, currentWidth]

translateY(double)

map values in [ymin, ymax] to [0, currentHeight]

update(Observable, Object)

updateUI()

 private Vector plots

collection of IDataSeries', which have to be plotted

 private double xmin

logical dimension of the graph: minimal x-value

 private double xmax

logical dimension of the graph: maximal x-value

 private double ymin

logical dimension of the graph: minimal y-value

 private double ymax

logical dimension of the graph: maximal y-value

 private double xTicksDistance

each xTicksDistance a tick is drawn on the axis

 private double yTicksDistance

each yTicksDistance a tick is drawn axis

 private boolean ticksAsDottedLines

it possible to draw dotted lines instead of ticks. Some might say, it looks better (i.e, me)..

 private Color axisColor

color, in which axis, ticks and caption are drawn

 private Font axisFont

font used for caption

 public static final int NONE

used, when signaling "ignore something"

 public static final int MAXIMA

style for inscribing ticks: just mark the maxima at both axises

 public static final int MAXIMA_ZERO

style for inscribing ticks: same as MAXIMA, but zero position as well

 public static final int ALL

style for inscribing ticks: mark each tick

 public static final int OBJECT

style for inscribing ticks: pass every tick value to an object and let this object mark the tick. Could be used to map values to words.

 private int xTicksCaptionStyle

style with which the x-axis is marked

 private int yTicksCaptionStyle

style with which the y-axis is marked

 private ITickCaption xTicksCaptionObject

if xTicksCaptionStyle equals to OBJECT then this variable contains a reference to the caption object

 private ITickCaption yTicksCaptionObject

if yTicksCaptionStyle equals to OBJECT then this variable contains a reference to the caption object

 public static final int FIT

adjust {x|y}min and {x|y}max so the values fit in the graph

 public static final int SCROLL

adjust xmin and xmax so older values are scrolled to the left

 private int xAxisBehaviour

how to behave when a value is larger than xmax or smaller than xmin. Accepted values: NONE, FIT, SCROLL.

 private int yAxisBehaviour

how to behave when a value is larger than ymax or smaller than ymin. Accepted values: NONE, FIT.

 private int currentWidth

height this SWING component

 private int currentHeight

width this SWING component

 public Plotter()

 public Plotter(double xmin,
                double xmax,
                double ymin,
                double ymax,
                double xTicksDistance,
                double yTicksDistance)

 public Plotter addPlot(IDataSeries ds)

Add a new collection of data and plot it. The plotter adds itself to the list of observers of ds, so it is notified about changes of ds (adding data, changing color, legend etc.).

 public final void setXMin(double xmin)

set logical x-dimension (minimum)

 public final double getXMin()

get logical x-dimension (minimum)

 public final void setXMax(double xmax)

set logical x-dimension (maximum)

 public final double getXMax()

get logical x-dimension (maximum)

 public final void setXticksDistance(double xTicksDistance)

Set the distance between to ticks on x-axis

 public final double getXticksDistance()

get the distance between to ticks on x-axis

 public final void setYMin(double ymin)

set logical y-dimension (minimum)

 public final double getYMin()

get logical y-dimension (minimum)

 public final void setYMax(double ymax)

set logical y-dimension (maximum)

 public final double getYMax()

get logical y-dimension (maximum)

 public final void setYticksDistance(double yTicksDistance)

Set the distance between to ticks on y-axis

 public final double getYticksDistance()

get the distance between to ticks on y-axis

 public final void setTicksAsDottedLines(boolean ticksAsDottedLines)

set, wether ticks are drawn as dotted lines spawning the component's background or as short lines crossing an axis.

Parameters:

ticksAsDottedLines - true: draw dotted lines

 public final boolean getTicksAsDottedLines()

get, wether ticks are drawn as dotted lines spawning the component's background

 public final void setXticksCaptionStyle(int style) throws IllegalArgumentException

set, how x axis is marked.

Parameters:

style: - NONE, ALL, MAXIMA, MAXIMA_ZERO, OBJECT

 public final int getXticksCaptionStyle()

get, how x axis is marked.

 public final void setYticksCaptionStyle(int style) throws IllegalArgumentException

set, how y axis is marked.

Parameters:

style: - NONE, ALL, MAXIMA, MAXIMA_ZERO, OBJECT

 public final int getYticksCaptionStyle()

get, how y axis is marked.

 public final void setXticksCaptionObject(ITickCaption object)

Mark the x-axis using an object. See the example provided in {@link jsz.Plotter.ITickCaption}. This method also changes xTicksCaptionStyle to OBJECT.

 public final ITickCaption getXticksCaptionObject()

return the caption object for the x-axis. Undefined behaviour, if xTicksCaptionStyle != OBJECT.

 public final void setYticksCaptionObject(ITickCaption object)

Mark the y-axis using an object. See the example provided in {@link jsz.Plotter.ITickCaption}. This method also changes yTicksCaptionStyle to OBJECT.

 public final ITickCaption getYticksCaptionObject()

return the caption object for the y-axis. Undefined behaviour, if yTicksCaptionStyle != OBJECT.

 public final void setXaxisBehaviour(int behaviour) throws IllegalArgumentException

set, how the x-axis behaves when we attempt to plot a value which is larger or smaller than xmax resp. xmin.

Parameters:

behaviour: - NONE, FIT, SCROLL are excepted

Throws: IllegalArgumentException

otherwise

 public final int getXaxisBehaviour()

get , how the x-axis behaves when we attempt to plot a value

 public final void setYaxisBehaviour(int behaviour)

set, how the y-axis behaves when we attempt to plot a value which is larger or smaller than ymax resp. ymin.

Parameters:

behaviour: - NONE, FIT are excepted

Throws: IllegalArgumentException

otherwise

 public final int getYaxisBehaviour()

get , how the y-axis behaves when we attempt to plot a value

 private int translateX(double d)

map values in [xmin, xmax] to [0, currentWidth]

 private int translateY(double d)

map values in [ymin, ymax] to [0, currentHeight]

 public void update(Observable o,
                    Object arg)

 public void paintComponent(Graphics gc)

Overrides:

paintComponent in class JComponent

 private void drawXaxis(Graphics gc)

draw x-axis. respects xTicksCaptionStyle

 private void drawYaxis(Graphics gc)

draw x-axis. respects xTicksCaptionStyle

 private void drawPlots(Graphics gc)

plot the data of all registered plots. Respects {x|y}AxisBehaviour.

 public void updateUI()

Overrides:

updateUI in class JPanel

 public Dimension getMinimumSize()

Overrides:

getMinimumSize in class JComponent

 public Dimension getPreferredSize()

Overrides:

getPreferredSize in class JComponent

 public Dimension getSize()

Overrides:

getSize in class Component

 public void setSize(Dimension d)

Overrides:

setSize in class Component

 public void setSize(int width,
                     int height)

Overrides:

setSize in class Component

 public void setBounds(Rectangle r)

Overrides:

setBounds in class Component

All Packages  Class Hierarchy  This Package  Previous  Next  Index