hep.aida

Interface IHistogram2D

All Superinterfaces:

IBaseHistogram, IHistogram

All Known Implementing Classes:

Histogram2D

public interface IHistogram2D
extends IHistogram

User level interface to 2D Histogram.

Method Summary

Modifier and Type	Method and Description
void	add(IHistogram2D hist) Add to this IHistogram2D the contents of another IHistogram2D.
int	binEntries(int indexX, int indexY) Number of entries in the corresponding bin (ie the number of times fill was called for this bin).
int	binEntriesX(int index) Sum of all the entries of the bins along a given x bin.
int	binEntriesY(int index) Sum of all the entries of the bins along a given y bin.
double	binError(int indexX, int indexY) The error of a given bin.
double	binHeight(int indexX, int indexY) Total height of a give bin (ie the sum of the weights in this bin).
double	binHeightX(int index) Sum of all the heights of the bins along a given x bin.
double	binHeightY(int index) Sum of all the heights of the bins along a given y bin.
double	binMeanX(int indexX, int indexY) The weighted mean along the x axis of a given bin.
double	binMeanY(int indexX, int indexY) The weighted mean along the y axis of a given bin.
int	coordToIndexX(double coord) Get the bin number corresponding to a given coordinate along the x axis.
int	coordToIndexY(double coord) Get the bin number corresponding to a given coordinate along the y axis.
void	fill(double x, double y) Fill the IHistogram2D with a couple of values and the corresponding weight.
void	fill(double x, double y, double weight) Fill the IHistogram2D with a couple of values and the corresponding weight.
double	meanX() The mean of the in-range data of the IHistogram2D along the x axis.
double	meanY() The mean of the in-range data of the IHistogram2D along the y axis.
double	rmsX() The RMS of the in-range data of the IHistogram2D along the x axis.
double	rmsY() The RMS of the in-range data of the IHistogram2D along the y axis.
IAxis	xAxis() Get the x axis of the IHistogram2D.
IAxis	yAxis() Get the y axis of the IHistogram2D.

Methods inherited from interface hep.aida.IHistogram

allEntries, equivalentBinEntries, extraEntries, maxBinHeight, minBinHeight, scale, sumAllBinHeights, sumBinHeights, sumExtraBinHeights

Methods inherited from interface hep.aida.IBaseHistogram

annotation, dimension, entries, nanEntries, reset, setTitle, title

Method Detail

fill

void fill(double x,
          double y)
   throws java.lang.IllegalArgumentException

Fill the IHistogram2D with a couple of values and the corresponding weight. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.

Parameters:

x - The x value to be filled in.

y - The y value to be filled in.

Throws:

java.lang.IllegalArgumentException - If the weight is <0 or >1 (?).

fill

void fill(double x,
          double y,
          double weight)
   throws java.lang.IllegalArgumentException

Fill the IHistogram2D with a couple of values and the corresponding weight. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.

Parameters:

x - The x value to be filled in.

y - The y value to be filled in.

weight - The corresponding weight (by default 1).

Throws:

java.lang.IllegalArgumentException - If the weight is <0 or >1 (?).

binMeanX

double binMeanX(int indexX,
                int indexY)
         throws java.lang.IllegalArgumentException

The weighted mean along the x axis of a given bin.

Parameters:

indexX - The x bin number (0...N-1) or OVERFLOW or UNDERFLOW.

indexY - The y bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The mean of the corresponding bin along the x axis.

Throws:

java.lang.IllegalArgumentException - If the indexes are not a valid bin number.

binMeanY

double binMeanY(int indexX,
                int indexY)
         throws java.lang.IllegalArgumentException

The weighted mean along the y axis of a given bin.

Parameters:

indexX - The x bin number (0...N-1) or OVERFLOW or UNDERFLOW.

indexY - The y bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The mean of the corresponding bin along the y axis.

Throws:

java.lang.IllegalArgumentException - If the indexes are not a valid bin number.

binEntries

int binEntries(int indexX,
               int indexY)
        throws java.lang.IllegalArgumentException

Number of entries in the corresponding bin (ie the number of times fill was called for this bin).

Parameters:

indexX - The x bin number (0...N-1) or OVERFLOW or UNDERFLOW.

indexY - The y bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The number of entries in the corresponding bin.

Throws:

java.lang.IllegalArgumentException - If the indexes are not a valid bin number.

binEntriesX

int binEntriesX(int index)
         throws java.lang.IllegalArgumentException

Sum of all the entries of the bins along a given x bin. This is equivalent to projectionX().binEntries(index).

Parameters:

index - The x bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The number of entries in the corresponding set of bins.

Throws:

java.lang.IllegalArgumentException - If the index id not a valid bin number.

binEntriesY

int binEntriesY(int index)
         throws java.lang.IllegalArgumentException

Sum of all the entries of the bins along a given y bin. This is equivalent to projectionY().binEntries(index).

Parameters:

index - The y bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The number of entries in the corresponding set of bins.

Throws:

java.lang.IllegalArgumentException - If the index id not a valid bin number.

binHeight

double binHeight(int indexX,
                 int indexY)
          throws java.lang.IllegalArgumentException

Total height of a give bin (ie the sum of the weights in this bin).

Parameters:

indexX - The x bin number (0...N-1) or OVERFLOW or UNDERFLOW.

indexY - The y bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The height of the corresponding bin.

Throws:

java.lang.IllegalArgumentException - If the indexes are not a valid bin number.

binHeightX

double binHeightX(int index)
           throws java.lang.IllegalArgumentException

Sum of all the heights of the bins along a given x bin. This is equivalent to projectionX().binHeight(index).

Parameters:

index - The x bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The sum of the heights in the corresponding set of bins.

Throws:

java.lang.IllegalArgumentException - If the index id not a valid bin number.

binHeightY

double binHeightY(int index)
           throws java.lang.IllegalArgumentException

Sum of all the heights of the bins along a given y bin. This is equivalent to projectionY().binHeight(index).

Parameters:

index - The y bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The sum of the heights in the corresponding set of bins.

Throws:

java.lang.IllegalArgumentException - If the index id not a valid bin number.

binError

double binError(int indexX,
                int indexY)
         throws java.lang.IllegalArgumentException

The error of a given bin.

Parameters:

indexX - The x bin number (0...N-1) or OVERFLOW or UNDERFLOW.

indexY - The y bin number (0...N-1) or OVERFLOW or UNDERFLOW.

Returns:

The error on the corresponding bin.

Throws:

java.lang.IllegalArgumentException - If the indexes are not a valid bin number.

meanX

double meanX()

The mean of the in-range data of the IHistogram2D along the x axis.

Returns:

The mean of the IHistogram2D along the x axis.

meanY

double meanY()

The mean of the in-range data of the IHistogram2D along the y axis.

Returns:

The mean of the IHistogram2D along the y axis.

rmsX

double rmsX()

The RMS of the in-range data of the IHistogram2D along the x axis.

Returns:

The RMS if the IHistogram2D along the x axis.

rmsY

double rmsY()

The RMS of the in-range data of the IHistogram2D along the y axis.

Returns:

The RMS if the IHistogram2D along the y axis.

xAxis

IAxis xAxis()

Get the x axis of the IHistogram2D.

Returns:

The x coordinate IAxis.

yAxis

IAxis yAxis()

Get the y axis of the IHistogram2D.

Returns:

The y coordinate IAxis.

coordToIndexX

int coordToIndexX(double coord)

Get the bin number corresponding to a given coordinate along the x axis. This is a convenience method, equivalent to xAxis().coordToIndex(coord).

Parameters:

coord - The coordinalte along the x axis.

Returns:

The corresponding bin number.

See Also:

IAxis.coordToIndex(double)

coordToIndexY

int coordToIndexY(double coord)

Get the bin number corresponding to a given coordinate along the y axis. This is a convenience method, equivalent to yAxis().coordToIndex(coord).

Parameters:

coord - The coordinalte along the y axis.

Returns:

The corresponding bin number.

See Also:

IAxis.coordToIndex(double)

add

void add(IHistogram2D hist)
  throws java.lang.IllegalArgumentException

Add to this IHistogram2D the contents of another IHistogram2D.

Parameters:

hist - The IHistogram2D to be added to this IHistogram2D.

Throws:

java.lang.IllegalArgumentException - If the IHistogram2Ds binnings are incompatible.