de.gsi.dataset.spi

Class AbstractHistogram

java.lang.Object

de.gsi.dataset.spi.AbstractStylable<D>

de.gsi.dataset.spi.AbstractDataSet<AbstractHistogram>

de.gsi.dataset.spi.AbstractHistogram

All Implemented Interfaces:

DataSet, DataSetMetaData, EventSource, Histogram, Serializable

Direct Known Subclasses:

Histogram, Histogram2

public abstract class AbstractHistogram
extends AbstractDataSet<AbstractHistogram>
implements Histogram

Author:

rstein

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected double[][]	axisBins
protected double[]	data
protected int[]	nAxisBins

Fields inherited from interface de.gsi.dataset.DataSet

DIM_X, DIM_Y, DIM_Z

Fields inherited from interface de.gsi.dataset.DataSetMetaData

TAG_GAIN_RANGE, TAG_OVERSHOOT, TAG_UNDERSHOOT

Constructor Summary

Constructors

Constructor and Description
AbstractHistogram(String name, double[] xBins) Creates histogram with name and range [minX, maxX]
AbstractHistogram(String name, int nBins, double minX, double maxX) Creates histogram with name and range [minX, maxX]
AbstractHistogram(String name, int nBinsX, double minX, double maxX, int nBinsY, double minY, double maxY) Creates 2D histogram with name and ranges [minX, maxX] and [minY, maxY]

Method Summary

Modifier and Type	Method and Description
void	addBinContent(int bin) Increment bin content by 1.
void	addBinContent(int bin, double w) Increment bin content by a weight w.
int	findBin(double x, double y)
int	findBin(double x, double y, double z)
int	findBin(int dimIndex, double x)
protected int	findNextLargerIndex(double[] bin, double value)
double	getBinCenter(int dimIndex, int binIndex)
double	getBinContent(int bin) Return content of bin number bin.
int	getDataCount() Get the number of data points in the data set.
int	getDataCount(int dimIndex) Get the number of data points in the data set for a specific dimension.
boolean	isEquiDistant()
void	reset() reset histogram content

Methods inherited from class de.gsi.dataset.spi.AbstractDataSet

addDataLabel, addDataStyle, autoNotification, binarySearch, clearMetaInfo, equalDataLabels, equalEditConstraints, equalErrorValues, equalMetaData, equals, equals, equalValues, fireInvalidated, getAxisDescriptions, getDataLabel, getDataLabelMap, getDataStyleMap, getDimension, getEditConstraints, getErrorList, getIndex, getInfoList, getMetaInfo, getName, getStyle, getThis, getWarningList, hashCode, lock, minNeigbourSearchX, recomputeLimits, removeDataLabel, removeStyle, setEditConstraints, setName, toString, updateEventListener

Methods inherited from class de.gsi.dataset.spi.AbstractStylable

getStyle, setStyle

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.gsi.dataset.DataSet

get, getAxisDescription, getAxisDescriptions, getDataLabel, getDimension, getIndex, getName, getStyle, getStyle, getValue, getValues, lock, recomputeLimits, setStyle

Methods inherited from interface de.gsi.dataset.event.EventSource

addListener, autoNotification, invokeListener, invokeListener, invokeListener, isAutoNotification, removeListener, updateEventListener

Methods inherited from interface de.gsi.dataset.DataSetMetaData

getErrorList, getInfoList, getMetaInfo, getWarningList

Field Detail

nAxisBins

protected final int[] nAxisBins

axisBins

protected double[][] axisBins

data

protected final double[] data

Constructor Detail

AbstractHistogram

public AbstractHistogram(String name,
                         double[] xBins)

Creates histogram with name and range [minX, maxX]

Parameters:

name - of the data sets

xBins - the initial bin array (defines [minX, maxX] and nBins)

AbstractHistogram

public AbstractHistogram(String name,
                         int nBins,
                         double minX,
                         double maxX)

Creates histogram with name and range [minX, maxX]

Parameters:

name - of the data sets

nBins - number of bins

minX - minimum of range

maxX - maximum of range

AbstractHistogram

public AbstractHistogram(String name,
                         int nBinsX,
                         double minX,
                         double maxX,
                         int nBinsY,
                         double minY,
                         double maxY)

Creates 2D histogram with name and ranges [minX, maxX] and [minY, maxY]

Parameters:

name - of the data sets

nBinsX - number of horizontal bins

minX - minimum of horizontal range

maxX - maximum of horizontal range

nBinsY - number of vertical bins

minY - minimum of vertical range

maxY - maximum of vertical range

Method Detail

addBinContent

public void addBinContent(int bin)

Description copied from interface: Histogram

Increment bin content by 1. More...

Specified by:

addBinContent in interface Histogram

Parameters:

bin - global bin ID

addBinContent

public void addBinContent(int bin,
                          double w)

Description copied from interface: Histogram

Increment bin content by a weight w. More...

Specified by:

addBinContent in interface Histogram

Parameters:

bin - global bin ID

w - weight

findBin

public int findBin(double x,
                   double y)

Specified by:

findBin in interface Histogram

Parameters:

x - spatial real-valued coordinate in X

y - spatial real-valued coordinate in Y

Returns:

bin index corresponding to spatial x and y coordinates

findBin

public int findBin(double x,
                   double y,
                   double z)

Specified by:

findBin in interface Histogram

Parameters:

x - spatial real-valued coordinate in X

y - spatial real-valued coordinate in Y

z - spatial real-valued coordinate in Z

Returns:

bin index corresponding to spatial x, y and z coordinates

findBin

public int findBin(int dimIndex,
                   double x)

Specified by:

findBin in interface Histogram

Parameters:

dimIndex - the dimension index

x - spatial real-valued coordinate for dimension dimIndex

Returns:

bin index corresponding to spatial x and y coordinates

findNextLargerIndex

protected int findNextLargerIndex(double[] bin,
                                  double value)

getBinCenter

public double getBinCenter(int dimIndex,
                           int binIndex)

Specified by:

getBinCenter in interface Histogram

Parameters:

dimIndex - the dimension index

binIndex - index

Returns:

bin centre for axis with dimIndex

getBinContent

public double getBinContent(int bin)

Description copied from interface: Histogram

Return content of bin number bin. Convention for numbering bins For all histogram types: nbins, xlow, xup bin = 0; underflow bin bin = 1; first bin with low-edge xlow INCLUDED bin = nbins; last bin with upper-edge xup EXCLUDED bin = nbins+1; overflow bin

Specified by:

getBinContent in interface Histogram

Parameters:

bin - the index

Returns:

numeric bin content

getDataCount

public int getDataCount()

Description copied from interface: DataSet

Get the number of data points in the data set. The default implementation is the number of points in the highest dimension.

Specified by:

getDataCount in interface DataSet

Returns:

the number of data points

getDataCount

public int getDataCount(int dimIndex)

Description copied from interface: DataSet

Get the number of data points in the data set for a specific dimension.

Specified by:

getDataCount in interface DataSet

Parameters:

dimIndex - the dimension index (ie. '0' equals 'X', '1' equals 'Y')

Returns:

the number of data points

isEquiDistant

public boolean isEquiDistant()

Specified by:

isEquiDistant in interface Histogram

Returns:

true if bin sizes are equal

reset

public void reset()

Description copied from interface: Histogram

reset histogram content

Specified by:

reset in interface Histogram