uk.ac.ed.epcc.webapp.charts

Class SplitSetPlot

java.lang.Object

uk.ac.ed.epcc.webapp.charts.SplitSetPlot

All Implemented Interfaces:

PeriodPlot, PeriodSequencePlot, Plot, SetPlot

Direct Known Subclasses:

GenericSplitSetPlot

public abstract class SplitSetPlot
extends java.lang.Object
implements PeriodSequencePlot

A SplitSetPlot is a PeriodSequencePlot where the data is split over a series of time periods The time periods are divided into Major/Minor sub-divisions called Catagories and Items.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SplitSetPlot.PeriodIterator

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String[]	lab

Constructor Summary

Constructors

Constructor and Description
SplitSetPlot()

Method Summary

Modifier and Type	Method and Description
abstract void	add(int nset, int cat, int item, float value)
<D> void	addData(SetRangeMapper<D> t, D o) add data from an object to the dataset using strategy transform
<F> boolean	addMapData(QueryMapper<F> t, F o) Populate plot using a QueryMapper and a factory Each point of the graph is generated by a call to the QueryMapper
void	datasetScale(double scale, PeriodSequencePlot nm) rescale a dataset by constant divided by the value in a different dataset The normalisation dataset is assumed to have a single Set.
abstract void	doConvertToStacked() convert to stacked (each set stacks on top of each other).
abstract float	get(int set, int cat, int item)
double[][]	getCatCounts() Sum the contents of the dataset and return a 2D array by Catagory and set
double[]	getCounts() sum the contents of the dataset returning an array by set
java.lang.String[]	getLabels() get a set of labels for the major intervals.
java.lang.String[]	getLegends() get the legend strings
abstract int	getNumCats()
abstract int	getNumItems()
java.util.Iterator<TimePeriod>	getSubPeriods() get an Iterator over the time periods in the sequence.
Table	getTable(java.lang.String quantity) create a table from a Plot for this Timechart
boolean	hasLegends()
abstract boolean	isCummulative() Does this plot represent a cummulative plot.
boolean	isUsingLogSearch()
void	permSets(int new_nset, int[] perm) permute the contents of the sets in a Dataset labels are also permuted/truncated.
void	rateScale(double scale) rescale a dataset by constant divided by number of miliseconds
void	scale(float scale) rescale all the data by a factor
void	scaleCopy(double scale, int src, int dest) rescale one set of a dataset and store result in a different set.
void	scaleCumulative(double scale, double[] initial) Convert the data-set to a cumulative graph.
abstract void	set(int nset, int cat, int item, float value)
void	setLegends(java.lang.String[] leg) set the legends strings These are the labels for the different sets in this SetPlot
void	setNumSets(int nset) set Number of sets in this SetPlot
protected abstract void	setSize(int new_nset, int numCats, int numItems)
void	setSplits(int nset, SplitTimePeriod p, int minor, boolean need_multi)
void	setUsingLogSearch(boolean usingLogSearch)

Methods inherited from class java.lang.Object

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

Methods inherited from interface uk.ac.ed.epcc.webapp.charts.SetPlot

getNumSets

Methods inherited from interface uk.ac.ed.epcc.webapp.charts.Plot

addData

Field Detail

lab

protected java.lang.String[] lab

Constructor Detail

SplitSetPlot

public SplitSetPlot()

Method Detail

getNumCats

public abstract int getNumCats()

getNumItems

public abstract int getNumItems()

get

public abstract float get(int set,
                          int cat,
                          int item)

set

public abstract void set(int nset,
                         int cat,
                         int item,
                         float value)

add

public abstract void add(int nset,
                         int cat,
                         int item,
                         float value)

getLegends

public java.lang.String[] getLegends()

Description copied from interface: SetPlot

get the legend strings

Specified by:

getLegends in interface SetPlot

Returns:

String[] legends

setLegends

public void setLegends(java.lang.String[] leg)

Description copied from interface: SetPlot

set the legends strings These are the labels for the different sets in this SetPlot

Specified by:

setLegends in interface SetPlot

hasLegends

public boolean hasLegends()

Specified by:

hasLegends in interface SetPlot

permSets

public void permSets(int new_nset,
                     int[] perm)

Description copied from interface: SetPlot

permute the contents of the sets in a Dataset labels are also permuted/truncated.

Specified by:

permSets in interface SetPlot

Parameters:

new_nset - number of sets to truncate to

perm - permutation array, can be many to one to merge sets

setUsingLogSearch

public void setUsingLogSearch(boolean usingLogSearch)

scale

public void scale(float scale)

Description copied from interface: Plot

rescale all the data by a factor

Specified by:

scale in interface Plot

setNumSets

public void setNumSets(int nset)

Description copied from interface: SetPlot

set Number of sets in this SetPlot

Specified by:

setNumSets in interface SetPlot

setSize

protected abstract void setSize(int new_nset,
                                int numCats,
                                int numItems)

doConvertToStacked

public abstract void doConvertToStacked()

Description copied from interface: PeriodSequencePlot

convert to stacked (each set stacks on top of each other).

Specified by:

doConvertToStacked in interface PeriodSequencePlot

isCummulative

public abstract boolean isCummulative()

Does this plot represent a cummulative plot. This return value controls how items are combined in #getCatCounts(boolean)

Returns:

getTable

public Table getTable(java.lang.String quantity)

create a table from a Plot for this Timechart

Specified by:

getTable in interface SetPlot

Parameters:

t -

ds - Plot to convert

lab - Labels for the catagories

start - index of first label in this set

Returns:

number of labels used;

isUsingLogSearch

public boolean isUsingLogSearch()

getCatCounts

public final double[][] getCatCounts()

Sum the contents of the dataset and return a 2D array by Catagory and set

Returns:

double[cat][set]

getCounts

public final double[] getCounts()

Description copied from interface: SetPlot

sum the contents of the dataset returning an array by set

Specified by:

getCounts in interface SetPlot

Returns:

double[]

addData

public <D> void addData(SetRangeMapper<D> t,
                        D o)
                 throws java.lang.Exception

add data from an object to the dataset using strategy transform

Specified by:

addData in interface PeriodPlot

Parameters:

ds -

t -

o -

Throws:

java.lang.Exception

InvalidTransformException

addMapData

public <F> boolean addMapData(QueryMapper<F> t,
                              F o)
                       throws InvalidTransformException

Description copied from interface: PeriodPlot

Populate plot using a QueryMapper and a factory Each point of the graph is generated by a call to the QueryMapper

Specified by:

addMapData in interface PeriodPlot

Type Parameters:

F - type of factory

Parameters:

t - QueryMapper to use

o - Factory to query

Returns:

true if data added

Throws:

InvalidTransformException

getSubPeriods

public java.util.Iterator<TimePeriod> getSubPeriods()

Description copied from interface: PeriodSequencePlot

get an Iterator over the time periods in the sequence.

Specified by:

getSubPeriods in interface PeriodSequencePlot

Returns:

setSplits

public void setSplits(int nset,
                      SplitTimePeriod p,
                      int minor,
                      boolean need_multi)
               throws InvalidArgument

Throws:

InvalidArgument

getLabels

public java.lang.String[] getLabels()

get a set of labels for the major intervals.

Returns:

rateScale

public void rateScale(double scale)

rescale a dataset by constant divided by number of miliseconds

Specified by:

rateScale in interface PeriodSequencePlot

Parameters:

ds -

scale -

datasetScale

public void datasetScale(double scale,
                         PeriodSequencePlot nm)

rescale a dataset by constant divided by the value in a different dataset The normalisation dataset is assumed to have a single Set.

Specified by:

datasetScale in interface PeriodSequencePlot

Parameters:

ds -

scale -

norm -

scaleCopy

public void scaleCopy(double scale,
                      int src,
                      int dest)

rescale one set of a dataset and store result in a different set.

Specified by:

scaleCopy in interface PeriodSequencePlot

Parameters:

ds -

scale -

src -

dest -

scaleCumulative

public void scaleCumulative(double scale,
                            double[] initial)

Description copied from interface: PeriodSequencePlot

Convert the data-set to a cumulative graph. each value is replaced by the sum of previous values in the set plus the initial value for that set then scaled by the scale value. At the end of this operation the initial vector will have been incremented by the accumulated (un-scaled) values from each set in the original state.

Specified by:

scaleCumulative in interface PeriodSequencePlot