org.PingOO.DLAI.lib.graph
Class VectorSet

java.lang.Object
  |
  +--org.PingOO.DLAI.lib.graph.DataSet
        |
        +--org.PingOO.DLAI.lib.graph.VectorSet

public class VectorSet

extends DataSet

This class is designed to hold vectors to be plotted. It extends the DataSet class. The vectors are defined as (x,y,dx,dy) where (x,y) is the position of the vector tail and (dx,dy) is the relative position of the head. It is to be used in conjunction with the Graph2D class and Axis class for plotting 2D graphs.

Version:

$Revision: 1.3 $, $Date: 1996/10/23 03:30:22 $

Author:

Leigh Brookshaw

Field Summary

private boolean	drawlegend Boolean set if legend is to be drawn
static int	MAXIMUM A constant value flag used to specify if the max magnitude of the vectors is going to be used as the scaling variable
static int	MEAN A constant value flag used to specify if the mean magnitude of the vectors is going to be used as the scaling variable
static int	MINIMUM A constant value flag used to specify if the minimum magnitude of the vectors is going to be used as the scaling variable
double	scale This is the scaling to be used when drawing vectors.
protected int	scalingType The flag specifying which scaling variable to use
protected int	stride This is the stride of the data in the data array.
private static int	VECTOR_STRIDE The Default stride of the Vector class
private double	vmax The maximum magnitude squared of the vectors
private double	vmean The mean magnitude squared of the vectors
private double	vmin The minimum magnitude squared of the vectors

Fields inherited from class org.PingOO.DLAI.lib.graph.DataSet

clipping, data, dxmax, dxmin, dymax, dymin, g2d, increment, legend_dx, legend_dy, legend_ix, legend_iy, legend_length, legend_text, length, LINE, linecolor, linestyle, marker, markercolor, markerscale, NOLINE, stride, xaxis, xmax, xmin, xrange, yaxis, ymax, ymin, yrange

Constructor Summary

VectorSet()
Instantiate an empty data set.

VectorSet(double scale)
Instantiate an empty data set.

VectorSet(double[] d, int n)
Instantiate a DataSet with the parsed data.

VectorSet(double[] d, int n, double scale)
Instantiate a DataSet with the parsed data.

Method Summary

void	draw_data(java.awt.Graphics g, java.awt.Rectangle bounds) Draw the vectors at the data points.
protected void	draw_legend(java.awt.Graphics g, java.awt.Rectangle w) Draw a legend for this Vector set
protected void	drawVectors(java.awt.Graphics g, java.awt.Rectangle w)
double	getScaleFactor() return the current scaling factor.
void	legend() Draw a Vector legend in the graph window.
void	legend(double x, double y, java.lang.String text) Define a Vector legend in the graph window
void	legend(int x, int y, java.lang.String text) Define a Vector legend in the graph window
void	legend(java.lang.String text) Define a Vector legend in the graph window.
protected void	range(int stride) Calculate the range of the data and the magnitude of the vectors.
void	setScale(double scale) Set the scaling to use when drawing vectors
void	setScalingType(int type) Set the scaling type to use when drawing vectors

Methods inherited from class org.PingOO.DLAI.lib.graph.DataSet

append, dataPoints, delete, deleteData, draw_lines, draw_markers, getClosestPoint, getPoint, getXmax, getXmin, getYmax, getYmin, inside, legendColor, legendFont

Methods inherited from class java.lang.Object

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

Field Detail

VECTOR_STRIDE

private static final int VECTOR_STRIDE

The Default stride of the Vector class

drawlegend

private boolean drawlegend

Boolean set if legend is to be drawn

MEAN

public static final int MEAN

A constant value flag used to specify if the mean magnitude of the vectors is going to be used as the scaling variable

MINIMUM

public static final int MINIMUM

A constant value flag used to specify if the minimum magnitude of the vectors is going to be used as the scaling variable

MAXIMUM

public static final int MAXIMUM

A constant value flag used to specify if the max magnitude of the vectors is going to be used as the scaling variable

scale

public double scale

This is the scaling to be used when drawing vectors. The scaling is the fraction of the axis the mean vector magnitude will be scaled to.

stride

protected int stride

This is the stride of the data in the data array. For a vector set it will be 4.

scalingType

protected int scalingType

The flag specifying which scaling variable to use

vmean

private double vmean

The mean magnitude squared of the vectors

vmin

private double vmin

The minimum magnitude squared of the vectors

vmax

private double vmax

The maximum magnitude squared of the vectors

Constructor Detail

VectorSet

public VectorSet()
          throws java.lang.Exception

Instantiate an empty data set.

Throws:

java.lang.Exception - A Generic exception if it fails to instantiate the the class with the correct stride.

VectorSet

public VectorSet(double[] d,
                 int n)
          throws java.lang.Exception

Instantiate a DataSet with the parsed data. The double array contains the data. The data is stored in the array in the sequence

             x,y,dx,dy,x,y,dx,dy,...
 

Where (x,y) is the position of the tail and (dx,dy) is the relative position of the head. This means that the length of the data array is 4*n.

Parameters:

d - Array containing the (x,y,dy,dx) vectors.

n - Number of (x,y) data pairs in the array.

Throws:

java.lang.Exception - A Generic exception if it fails to load the parsed array into the class.

VectorSet

public VectorSet(double scale)
          throws java.lang.Exception

Instantiate an empty data set.

Parameters:

s - The scaling to use when plotting the vectors.

Throws:

java.lang.Exception - A Generic exception if it fails to instantiate the the class with the correct stride.

VectorSet

public VectorSet(double[] d,
                 int n,
                 double scale)
          throws java.lang.Exception

Instantiate a DataSet with the parsed data.

Parameters:

d - Array containing the (x,y,dy,dx) vectors.

n - Number of (x,y,dx,dy) vectors in the array.

Throws:

java.lang.Exception - A Generic exception if it fails to load the parsed array into the class.

Method Detail

setScale

public void setScale(double scale)

Set the scaling to use when drawing vectors

Parameters:

scale - The scaling to employ

setScalingType

public void setScalingType(int type)

Set the scaling type to use when drawing vectors

Parameters:

type - Either MEAN, MAXIMUM or MINIMUM.

getScaleFactor

public double getScaleFactor()

return the current scaling factor. That is the calculated scaling using the axis range the mean/max/min magnitude and the percentage scale.

legend

public void legend()

Draw a Vector legend in the graph window. The legend will be placed above the data window in the center

legend

public void legend(java.lang.String text)

Define a Vector legend in the graph window. The legend will be placed above the data window in the center

Parameters:

text - text to display in the legend

legend

public void legend(int x,
                   int y,
                   java.lang.String text)

Define a Vector legend in the graph window

Parameters:

x - pixel position of the legend.

y - pixel position of the legend.

text - text to display in the legend

Overrides:

legend in class DataSet

legend

public void legend(double x,
                   double y,
                   java.lang.String text)

Define a Vector legend in the graph window

Parameters:

x - data position of the legend.

y - data position of the legend.

text - text to display in the legend

Overrides:

legend in class DataSet

draw_data

public void draw_data(java.awt.Graphics g,
                      java.awt.Rectangle bounds)

Draw the vectors at the data points. If this data has been attached to an Axis then scale the data based on the axis maximum/minimum otherwise scale using the data's maximum/minimum

Parameters:

g - Graphics state

bounds - The data window to draw into

Overrides:

draw_data in class DataSet

draw_legend

protected void draw_legend(java.awt.Graphics g,
                           java.awt.Rectangle w)

Draw a legend for this Vector set

Parameters:

g - Graphics context

w - Data Window

Overrides:

draw_legend in class DataSet

drawVectors

protected void drawVectors(java.awt.Graphics g,
                           java.awt.Rectangle w)

range

protected void range(int stride)

Calculate the range of the data and the magnitude of the vectors. This modifies dxmin,dxmax,dymin,dymax and xmin,xmax,ymin,ymax

Overrides:

range in class DataSet