AIDA API
Version 3.3

hep.aida
Interface IProfile2D

All Superinterfaces:
IBaseHistogram, IProfile

public interface IProfile2D
extends IProfile

User level interface to a 2-dimensional profile histogram

Author:
The AIDA team (http://aida.freehep.org/)

Method Summary
 void add(IProfile2D h)
          Modifies this profile by adding the contents of profile to it.
 int binEntries(int indexX, int indexY)
          The number of entries (ie the number of times fill was called for this bin).
 int binEntriesX(int indexX)
          Equivalent to projectionX().binEntries(indexX).
 int binEntriesY(int indexY)
          Equivalent to projectionY().binEntries(indexY).
 double binError(int indexX, int indexY)
          The error on this bin.
 double binHeight(int indexX, int indexY)
          Total height of the corresponding bin (ie the sum of the weights in this bin).
 double binHeightX(int indexX)
          Equivalent to projectionX().binHeight(indexX).
 double binHeightY(int indexY)
          Equivalent to projectionY().binHeight(indexY).
 double binMeanX(int indexX, int indexY)
          The weighted mean along x of a given bin.
 double binMeanY(int indexX, int indexY)
          The weighted mean along y of a given bin.
 double binRms(int indexX, int indexY)
          The spread (RMS) of this bin.
 int coordToIndexX(double coordX)
          Convenience method, equivalent to xAxis().coordToIndex(coord).
 int coordToIndexY(double coordY)
          Convenience method, equivalent to yAxis().coordToIndex(coord).
 void fill(double x, double y, double z)
          Fill the IProfile2D.
 void fill(double x, double y, double z, double weight)
          Fill the IProfile2D.
 double meanX()
          Returns the mean of the in-range data of the profile, as calculated on filling-time projected on the X axis.
 double meanY()
          Returns the mean of the in-range data of the profile, as calculated on filling-time projected on the Y axis.
 double rmsX()
          Returns the rms of the in-range data of the profile as calculated on filling-time projected on the X axis.
 double rmsY()
          Returns the rms of the in-range data of the profile as calculated on filling-time projected on the Y axis.
 IAxis xAxis()
          Return the X axis.
 IAxis yAxis()
          Return the Y axis.
 
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

public void fill(double x,
                 double y,
                 double z)
          throws IllegalArgumentException
Fill the IProfile2D. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.

Throws:
IllegalArgumentException

fill

public void fill(double x,
                 double y,
                 double z,
                 double weight)
          throws IllegalArgumentException
Fill the IProfile2D. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.

Throws:
IllegalArgumentException

binMeanX

public double binMeanX(int indexX,
                       int indexY)
                throws IllegalArgumentException
The weighted mean along x 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:
IllegalArgumentException - If the indexes are not a valid bin number.

binMeanY

public double binMeanY(int indexX,
                       int indexY)
                throws IllegalArgumentException
The weighted mean along y 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:
IllegalArgumentException - If the indexes are not a valid bin number.

binEntries

public int binEntries(int indexX,
                      int indexY)
The number of entries (ie the number of times fill was called for this bin).

Parameters:
indexX - the x bin number (0...Nx-1) or OVERFLOW or UNDERFLOW.
indexY - the y bin number (0...Ny-1) or OVERFLOW or UNDERFLOW.

binEntriesX

public int binEntriesX(int indexX)
Equivalent to projectionX().binEntries(indexX).


binEntriesY

public int binEntriesY(int indexY)
Equivalent to projectionY().binEntries(indexY).


binHeight

public double binHeight(int indexX,
                        int indexY)
Total height of the corresponding bin (ie the sum of the weights in this bin).

Parameters:
indexX - the x bin number (0...Nx-1) or OVERFLOW or UNDERFLOW.
indexY - the y bin number (0...Ny-1) or OVERFLOW or UNDERFLOW.

binHeightX

public double binHeightX(int indexX)
Equivalent to projectionX().binHeight(indexX).


binHeightY

public double binHeightY(int indexY)
Equivalent to projectionY().binHeight(indexY).


binError

public double binError(int indexX,
                       int indexY)
The error on this bin.

Parameters:
indexX - the x bin number (0...Nx-1) or OVERFLOW or UNDERFLOW.
indexY - the y bin number (0...Ny-1) or OVERFLOW or UNDERFLOW.

binRms

public double binRms(int indexX,
                     int indexY)
The spread (RMS) of this bin.

Parameters:
indexX - the x bin number (0...Nx-1) or OVERFLOW or UNDERFLOW.
indexY - the y bin number (0...Ny-1) or OVERFLOW or UNDERFLOW.

meanX

public double meanX()
Returns the mean of the in-range data of the profile, as calculated on filling-time projected on the X axis.


meanY

public double meanY()
Returns the mean of the in-range data of the profile, as calculated on filling-time projected on the Y axis.


rmsX

public double rmsX()
Returns the rms of the in-range data of the profile as calculated on filling-time projected on the X axis.


rmsY

public double rmsY()
Returns the rms of the in-range data of the profile as calculated on filling-time projected on the Y axis.


xAxis

public IAxis xAxis()
Return the X axis.


yAxis

public IAxis yAxis()
Return the Y axis.


coordToIndexX

public int coordToIndexX(double coordX)
Convenience method, equivalent to xAxis().coordToIndex(coord).

See Also:
IAxis.coordToIndex(double)

coordToIndexY

public int coordToIndexY(double coordY)
Convenience method, equivalent to yAxis().coordToIndex(coord).

See Also:
IAxis.coordToIndex(double)

add

public void add(IProfile2D h)
         throws IllegalArgumentException
Modifies this profile by adding the contents of profile to it.

Throws:
IllegalArgumentException - if the profile binnings are incompatible

AIDA API
Version 3.3

Copyright © 2000-2004 AIDA Team, All Rights Reserved.