jas.swingstudio
Class JASRebinAdaptor

java.lang.Object
  |
  +--java.util.Observable
        |
        +--jas.swingstudio.JASRebinAdaptor

All Implemented Interfaces:

DataSource, ExtendedStatistics, HasStatistics, HasStyle, java.util.Observer, Rebinnable1DHistogramData, Statistics

public class JASRebinAdaptor

extends java.util.Observable

implements Rebinnable1DHistogramData, java.util.Observer, HasStyle, HasStatistics, ExtendedStatistics

Fields inherited from interface jas.hist.DataSource

DATE, DELTATIME, DOUBLE, INTEGER, STRING

Constructor Summary

JASRebinAdaptor(RemoteRebinnable1DHistogramData source, RMIDestination obs)

Method Summary

java.lang.String[]	getAxisLabels() Returns the axis labels.
int	getAxisType() Returns one of DOUBLE,INTEGER,STRING,DATE or DELTATIME
int	getBins() Returns the (suggested) number of bins to use
java.lang.Object	getExtendedStatistic(java.lang.String name) Returns an object corresponding to the named statistic.
double	getMax() Returns the (suggested) maximum value for the X axis
double	getMin() Returns the (suggested) minimum value for the X axis
double	getStatistic(java.lang.String name)
java.lang.String[]	getStatisticNames()
Statistics	getStatistics()
JASHistStyle	getStyle() This method is called by the plot to determine what style to be used for a plot.
java.lang.String	getTitle() Return the caption to be used in the legend for this data.
boolean	isRebinnable() Returns true if the data source is capable of recalculating the bin contents, or false of the interface is not-capable of recalculating the bin contents.
double[][]	rebin(int bins, double min, double max, boolean wantErrors, boolean hurry) Fetch binned data from remote data source.
java.lang.String	toString()
void	update(java.util.Observable obs, java.lang.Object arg)

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

JASRebinAdaptor

public JASRebinAdaptor(RemoteRebinnable1DHistogramData source,
                       RMIDestination obs)

Method Detail

update

public void update(java.util.Observable obs,
                   java.lang.Object arg)

Specified by:

update in interface java.util.Observer

rebin

public double[][] rebin(int bins,
                        double min,
                        double max,
                        boolean wantErrors,
                        boolean hurry)

Fetch binned data from remote data source. Also caches result to speed up subsequent requests for the same binned data.

Specified by:

rebin in interface Rebinnable1DHistogramData

Following copied from interface: jas.hist.Rebinnable1DHistogramData

Parameters:

bin - The number of bins requested

min - The min of the range over which to bin

max - The max of the range over which to bin

wantErrors - If false indicates that the errors are not required and need not be calculated (most implementations will ignore this parameter)

hurry - If true indicates the results should be provided as fast as possible, even if some approximation is needed (most implementations will ignore this parameter)

Returns:

An array representing the binned data and errors (see description above)

getMin

public double getMin()

Description copied from interface: Rebinnable1DHistogramData

Returns the (suggested) minimum value for the X axis

Specified by:

getMin in interface Rebinnable1DHistogramData

getMax

public double getMax()

Description copied from interface: Rebinnable1DHistogramData

Returns the (suggested) maximum value for the X axis

Specified by:

getMax in interface Rebinnable1DHistogramData

getBins

public int getBins()

Description copied from interface: Rebinnable1DHistogramData

Returns the (suggested) number of bins to use

Specified by:

getBins in interface Rebinnable1DHistogramData

getAxisType

public int getAxisType()

Description copied from interface: Rebinnable1DHistogramData

Returns one of DOUBLE,INTEGER,STRING,DATE or DELTATIME

Specified by:

getAxisType in interface Rebinnable1DHistogramData

isRebinnable

public boolean isRebinnable()

Description copied from interface: Rebinnable1DHistogramData

Returns true if the data source is capable of recalculating the bin contents, or false of the interface is not-capable of recalculating the bin contents. In the former case the values returned by getMin, getMax and getBins are just taken to be suggestions, in the latter case they are taken to be fixed in stone.

Specified by:

isRebinnable in interface Rebinnable1DHistogramData

Following copied from interface: jas.hist.Rebinnable1DHistogramData

Returns:

True if the datasource is rebinnable

getTitle

public java.lang.String getTitle()

Description copied from interface: DataSource

Return the caption to be used in the legend for this data.

Specified by:

getTitle in interface DataSource

getAxisLabels

public java.lang.String[] getAxisLabels()

Description copied from interface: Rebinnable1DHistogramData

Returns the axis labels. Only relevant if the axisType is STRING, otherwise can return null

Specified by:

getAxisLabels in interface Rebinnable1DHistogramData

Following copied from interface: jas.hist.Rebinnable1DHistogramData

Returns:

An array of bin labels to use on the X axis

getStyle

public JASHistStyle getStyle()

Description copied from interface: HasStyle

This method is called by the plot to determine what style to be used for a plot. It is the programmers responsibility to return the correct subclass of JASHistStyle corresponding to the type of data being implemented by the DataSource.

Specified by:

getStyle in interface HasStyle

Following copied from interface: jas.hist.HasStyle

Returns:

The style to be used, or null to use the default style.

See Also:

JASHist1DHistogramStyle, JASHist2DHistogramStyle, JASHistScatterPlotStyle

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getStatistics

public Statistics getStatistics()

Specified by:

getStatistics in interface HasStatistics

getStatisticNames

public java.lang.String[] getStatisticNames()

Specified by:

getStatisticNames in interface Statistics

Following copied from interface: jas.hist.Statistics

Returns:

A list of statistic names

getStatistic

public double getStatistic(java.lang.String name)

Specified by:

getStatistic in interface Statistics

Following copied from interface: jas.hist.Statistics

Parameters:

The - statistic name, as returned by getStatisticNames()

Returns:

The value for the statistic

getExtendedStatistic

public java.lang.Object getExtendedStatistic(java.lang.String name)

Description copied from interface: ExtendedStatistics

Returns an object corresponding to the named statistic. In general the statistic will be displayed by calling its toString method, however if a Format object has been defined for this class (how?) then it will be used instead. By default the following formatters are defined

java.lang.Double

jas.util.ScientificFormat

jas.util.DoubleWithError

jas.util.ScientificFormat

If the method returns null, then the getStatistic() method from the subclass will be called instead. This simplifies the use of simple floating point statistics (no need to create a Double object for each one).

Specified by:

getExtendedStatistic in interface ExtendedStatistics

Following copied from interface: jas.hist.ExtendedStatistics

Parameters:

name - The name of the statistic to return

See Also:

ScientificFormat, DoubleWithError