hep.aida

Interface IProfile1D

All Superinterfaces:

IBaseHistogram, IProfile

All Known Implementing Classes:

Profile1D

public interface IProfile1D
extends IProfile

User level interface to a 1-dimensional profile histogram

Method Summary

Modifier and Type	Method and Description
void	add(IProfile1D profile) Modifies this IProfile1D by adding the contents of profile to it.
IAxis	axis() Returns the X axis.
int	binEntries(int index) Number of entries in the corresponding bin (ie the number of times fill was called for this bin).
double	binError(int index) The error on this bin.
double	binHeight(int index) Total height of the corresponding bin (ie the sum of the weights in this bin).
double	binMean(int index) The weighted mean of the corresponding bin.
double	binRms(int index) The spread (RMS) of a bin.
int	coordToIndex(double coord) Convenience method, equivalent to axis().coordToIndex(coord).
void	fill(double x, double y) Fill the IProfile1D.
void	fill(double x, double y, double weight) Fill the IProfile1D.
double	mean() Returns the mean of the in-range data of the profile as calculated on filling-time.
double	rms() Returns the rms of the in-range data of the profile as calculated on filling-time.

Methods inherited from interface hep.aida.IProfile

allEntries, extraEntries, maxBinHeight, minBinHeight, 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 IProfile1D. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.

Throws:

java.lang.IllegalArgumentException

fill

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

Fill the IProfile1D. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.

Throws:

java.lang.IllegalArgumentException

binMean

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

The weighted mean of the corresponding bin.

Parameters:

index - the 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 index is not a valid bin number.

binEntries

int binEntries(int index)

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

Parameters:

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

binHeight

double binHeight(int index)

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

Parameters:

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

binError

double binError(int index)

The error on this bin.

Parameters:

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

binRms

double binRms(int index)

The spread (RMS) of a bin.

Parameters:

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

mean

double mean()

Returns the mean of the in-range data of the profile as calculated on filling-time.

rms

double rms()

Returns the rms of the in-range data of the profile as calculated on filling-time.

axis

IAxis axis()

Returns the X axis.

coordToIndex

int coordToIndex(double coord)

Convenience method, equivalent to axis().coordToIndex(coord).

See Also:

IAxis.coordToIndex(double)

add

void add(IProfile1D profile)
  throws java.lang.IllegalArgumentException

Modifies this IProfile1D by adding the contents of profile to it.

Parameters:

profile - The IProfile1D to be added to this IProfile1D

Throws:

java.lang.IllegalArgumentException - if profile binnings are incompatible