hep.aida.ref.histogram

Class Cloud3D

java.lang.Object

hep.aida.ref.event.AIDAObservable

hep.aida.ref.ManagedObject

hep.aida.ref.histogram.AbstractBaseHistogram

hep.aida.ref.histogram.Cloud

hep.aida.ref.histogram.Cloud3D

All Implemented Interfaces:

IDevManagedObject, IBaseHistogram, ICloud, ICloud3D, IManagedObject, Connectable, IsObservable, java.io.Serializable

public class Cloud3D
extends Cloud
implements ICloud3D

See Also:

Serialized Form

Field Summary

Fields inherited from class hep.aida.ref.histogram.Cloud

CLOUD_ARRAY_ENTRIES

Constructor Summary

Constructors

Constructor and Description
Cloud3D() Create a new Cloud3D

Method Summary

Modifier and Type	Method and Description
int	conversionBinsX()
int	conversionBinsY()
int	conversionBinsZ()
double	conversionLowerEdgeX()
double	conversionLowerEdgeY()
double	conversionLowerEdgeZ()
double	conversionUpperEdgeX()
double	conversionUpperEdgeY()
double	conversionUpperEdgeZ()
void	convert(double[] binEdgesX, double[] binEdgesY, double[] binEdgesZ) Convert internally the ICloud3D to an IHistogram3D with given bin edges.
void	convert(int nBinsX, double lowerEdgeX, double upperEdgeX, int nBinsY, double lowerEdgeY, double upperEdgeY, int nBinsZ, double lowerEdgeZ, double upperEdgeZ) Convert the Cloud to a Histogram.
void	convertToHistogram() Convert the ICloud to an IHistogram using the default number of bins.
int	entries() Get the Cloud's entries.
void	fill(double xValue, double yValue, double zValue) Fill the Cloud with new values with unit weight
void	fill(double xValue, double yValue, double zValue, double weight) Fill the Cloud with new values with given weight
void	fillHistogram(IHistogram3D hist3d) Project the ICloud3D on an IHistogram3D.
IHistogram3D	histogram() Get the Histogram representing the Cloud
boolean	isConverted() Has the Cloud been converted to a Histogram?
double	lowerEdgeX() Get the Cloud's x lower edge.
double	lowerEdgeXWithMargin()
double	lowerEdgeY() Get the Cloud's y lower edge.
double	lowerEdgeYWithMargin()
double	lowerEdgeZ() Get the Cloud's z lower edge.
double	lowerEdgeZWithMargin()
double	meanX() Get the Cloud's x mean.
double	meanY() Get the Cloud's y mean.
double	meanZ() Get the Cloud's z mean.
void	reset() Reset the histogram; as if just created.
double	rmsX() Get the Cloud's x rms.
double	rmsY() Get the Cloud's y rms.
double	rmsZ() Get the Cloud's z rms.
void	scale(double scaleFactor) Scale the weights by a given factor.
void	setConversionParameters(int binsX, double lowerEdgeX, double upperEdgeX, int binsY, double lowerEdgeY, double upperEdgeY, int binsZ, double lowerEdgeZ, double upperEdgeZ) Set the parameters for the ICloud conversion to an IHistogram.
void	setHistogram(IHistogram3D hist) Set the Histogram representation of the Cloud.
void	setLowerEdgeX(double lowerEdgeX) Set the Cloud's x lower edge
void	setLowerEdgeY(double lowerEdgeY) Set the Cloud's y lower edge
void	setLowerEdgeZ(double lowerEdgeZ) Set the Cloud's z lower edge
void	setUpperEdgeX(double upperEdgeX) Set the Cloud's x upper edge
void	setUpperEdgeY(double upperEdgeY) Set the Cloud's y upper edge
void	setUpperEdgeZ(double upperEdgeZ) Set the Cloud's z upper edge
double	sumOfWeights() Get the sum of weights of of all the entries
double	upperEdgeX() Get the Cloud's x upper edge.
double	upperEdgeXWithMargin()
double	upperEdgeY() Get the Cloud's y upper edge.
double	upperEdgeYWithMargin()
double	upperEdgeZ() Get the Cloud's z upper edge.
double	upperEdgeZWithMargin()
double	valueX(int index) Get a given x value from the Cloud.
double	valueY(int index) Get a given y value from the Cloud.
double	valueZ(int index) Get a given z value from the Cloud.
double	weight(int index) Get a given weight from the Cloud.

Methods inherited from class hep.aida.ref.histogram.Cloud

getOptions, initCloud, maxEntries, nanEntries

Methods inherited from class hep.aida.ref.histogram.AbstractBaseHistogram

annotation, dimension, mapBinNumber, setAnnotation, setTitle, title

Methods inherited from class hep.aida.ref.ManagedObject

isFillable, name, setFillable, setName, type, typeForClass

Methods inherited from class hep.aida.ref.event.AIDAObservable

addListener, isConnected, removeAllListeners, removeListener, setConnected, setValid, setValidForAll

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface hep.aida.ICloud

maxEntries

Methods inherited from interface hep.aida.IBaseHistogram

annotation, dimension, nanEntries, setTitle, title

Methods inherited from interface hep.aida.ref.event.IsObservable

addListener, removeAllListeners, removeListener, setValid

Methods inherited from interface hep.aida.ref.event.Connectable

isConnected, setConnected

Constructor Detail

Cloud3D

public Cloud3D()

Create a new Cloud3D

Method Detail

fill

public void fill(double xValue,
                 double yValue,
                 double zValue)

Fill the Cloud with new values with unit weight

Specified by:

fill in interface ICloud3D

Parameters:

xValue - The x value to add to the Cloud.

yValue - The y value to add to the Cloud.

zValue - The z value to add to the Cloud.

fill

public void fill(double xValue,
                 double yValue,
                 double zValue,
                 double weight)

Fill the Cloud with new values with given weight

Specified by:

fill in interface ICloud3D

Parameters:

xValue - The x value to add to the Cloud.

yValue - The y value to add to the Cloud.

zValue - The z value to add to the Cloud.

weight - The values weight.

lowerEdgeX

public double lowerEdgeX()

Get the Cloud's x lower edge.

Specified by:

lowerEdgeX in interface ICloud3D

Returns:

The Cloud's x lower edge.

lowerEdgeY

public double lowerEdgeY()

Get the Cloud's y lower edge.

Specified by:

lowerEdgeY in interface ICloud3D

Returns:

The Cloud's y lower edge.

lowerEdgeZ

public double lowerEdgeZ()

Get the Cloud's z lower edge.

Specified by:

lowerEdgeZ in interface ICloud3D

Returns:

The Cloud's z lower edge.

upperEdgeX

public double upperEdgeX()

Get the Cloud's x upper edge.

Specified by:

upperEdgeX in interface ICloud3D

Returns:

The Cloud's x upper edge.

upperEdgeY

public double upperEdgeY()

Get the Cloud's y upper edge.

Specified by:

upperEdgeY in interface ICloud3D

Returns:

The Cloud's y upper edge.

upperEdgeZ

public double upperEdgeZ()

Get the Cloud's z upper edge.

Specified by:

upperEdgeZ in interface ICloud3D

Returns:

The Cloud's z upper edge.

setLowerEdgeX

public void setLowerEdgeX(double lowerEdgeX)

Set the Cloud's x lower edge

Parameters:

lowerEdgeX - The Cloud's x lower edge.

setLowerEdgeY

public void setLowerEdgeY(double lowerEdgeY)

Set the Cloud's y lower edge

Parameters:

lowerEdgeY - The Cloud's y lower edge.

setLowerEdgeZ

public void setLowerEdgeZ(double lowerEdgeZ)

Set the Cloud's z lower edge

Parameters:

lowerEdgeZ - The Cloud's z lower edge.

setUpperEdgeX

public void setUpperEdgeX(double upperEdgeX)

Set the Cloud's x upper edge

Parameters:

upperEdgeX - The Cloud's x upper edge.

setUpperEdgeY

public void setUpperEdgeY(double upperEdgeY)

Set the Cloud's y upper edge

Parameters:

upperEdgeY - The Cloud's y upper edge.

setUpperEdgeZ

public void setUpperEdgeZ(double upperEdgeZ)

Set the Cloud's z upper edge

Parameters:

upperEdgeZ - The Cloud's z upper edge.

valueX

public double valueX(int index)

Get a given x value from the Cloud.

Specified by:

valueX in interface ICloud3D

Parameters:

index - The x value's index.

Returns:

The Cloud's corresponding x value.

Throws:

java.lang.RuntimeException - if the Cloud has been converted

valueY

public double valueY(int index)

Get a given y value from the Cloud.

Specified by:

valueY in interface ICloud3D

Parameters:

index - The y value's index.

Returns:

The Cloud's corresponding y value.

Throws:

java.lang.RuntimeException - if the Cloud has been converted

valueZ

public double valueZ(int index)

Get a given z value from the Cloud.

Specified by:

valueZ in interface ICloud3D

Parameters:

index - The z value's index.

Returns:

The Cloud's corresponding z value.

Throws:

java.lang.RuntimeException - if the Cloud has been converted

weight

public double weight(int index)

Get a given weight from the Cloud.

Specified by:

weight in interface ICloud3D

Parameters:

index - The weight's index.

Returns:

The Cloud's corresponding weight.

Throws:

java.lang.RuntimeException - if the Cloud has been converted

meanX

public double meanX()

Get the Cloud's x mean.

Specified by:

meanX in interface ICloud3D

Returns:

The Cloud's x mean.

meanY

public double meanY()

Get the Cloud's y mean.

Specified by:

meanY in interface ICloud3D

Returns:

The Cloud's y mean.

meanZ

public double meanZ()

Get the Cloud's z mean.

Specified by:

meanZ in interface ICloud3D

Returns:

The Cloud's z mean.

rmsX

public double rmsX()

Get the Cloud's x rms.

Specified by:

rmsX in interface ICloud3D

Returns:

The Cloud's x rms.

rmsY

public double rmsY()

Get the Cloud's y rms.

Specified by:

rmsY in interface ICloud3D

Returns:

The Cloud's y rms.

rmsZ

public double rmsZ()

Get the Cloud's z rms.

Specified by:

rmsZ in interface ICloud3D

Returns:

The Cloud's z rms.

entries

public int entries()

Get the Cloud's entries.

Specified by:

entries in interface IBaseHistogram

Specified by:

entries in class AbstractBaseHistogram

Returns:

The Cloud's entries.

convert

public void convert(int nBinsX,
                    double lowerEdgeX,
                    double upperEdgeX,
                    int nBinsY,
                    double lowerEdgeY,
                    double upperEdgeY,
                    int nBinsZ,
                    double lowerEdgeZ,
                    double upperEdgeZ)

Convert the Cloud to a Histogram.

Specified by:

convert in interface ICloud3D

Parameters:

nBinsX - The Histogram's x number of bins.

lowerEdgeX - The Histogram's x lower edge.

upperEdgeX - The Histogram's x upper edge.

nBinsY - The Histogram's y number of bins.

lowerEdgeY - The Histogram's y lower edge.

upperEdgeY - The Histogram's y upper edge.

nBinsZ - The Histogram's z number of bins.

lowerEdgeZ - The Histogram's z lower edge.

upperEdgeZ - The Histogram's z upper edge.

convert

public void convert(double[] binEdgesX,
                    double[] binEdgesY,
                    double[] binEdgesZ)

Description copied from interface: ICloud3D

Convert internally the ICloud3D to an IHistogram3D with given bin edges.

Specified by:

convert in interface ICloud3D

Parameters:

binEdgesX - The bins edges of the x axis.

binEdgesY - The bins edges of the y axis.

binEdgesZ - The bins edges of the z axis.

isConverted

public boolean isConverted()

Has the Cloud been converted to a Histogram?

Specified by:

isConverted in interface ICloud

Specified by:

isConverted in class Cloud

Returns:

true<\code> if the Cloud has been converted to a Histogram.

histogram

public IHistogram3D histogram()
                       throws java.lang.RuntimeException

Get the Histogram representing the Cloud

Specified by:

histogram in interface ICloud3D

Returns:

the histogram.

Throws:

java.lang.RuntimeException - if the histogram is not auto-convertible and "convert" has not been called.

setHistogram

public void setHistogram(IHistogram3D hist)

Set the Histogram representation of the Cloud.

Parameters:

hist - The Histogram representing the Cloud.

fillHistogram

public void fillHistogram(IHistogram3D hist3d)

Description copied from interface: ICloud3D

Project the ICloud3D on an IHistogram3D.

Specified by:

fillHistogram in interface ICloud3D

Parameters:

hist3d - The IHistogram3D to be filled.

reset

public void reset()

Description copied from class: Cloud

Reset the histogram; as if just created.

Specified by:

reset in interface IBaseHistogram

Overrides:

reset in class Cloud

convertToHistogram

public void convertToHistogram()

Description copied from class: Cloud

Convert the ICloud to an IHistogram using the default number of bins.

Specified by:

convertToHistogram in interface ICloud

Specified by:

convertToHistogram in class Cloud

scale

public void scale(double scaleFactor)
           throws java.lang.IllegalArgumentException

Description copied from class: Cloud

Scale the weights by a given factor.

Specified by:

scale in interface ICloud

Specified by:

scale in class Cloud

Parameters:

scaleFactor - The scale factor.

Throws:

java.lang.IllegalArgumentException - If a non-positive scale factor is provided.

lowerEdgeXWithMargin

public double lowerEdgeXWithMargin()

upperEdgeXWithMargin

public double upperEdgeXWithMargin()

lowerEdgeYWithMargin

public double lowerEdgeYWithMargin()

upperEdgeYWithMargin

public double upperEdgeYWithMargin()

lowerEdgeZWithMargin

public double lowerEdgeZWithMargin()

upperEdgeZWithMargin

public double upperEdgeZWithMargin()

sumOfWeights

public double sumOfWeights()

Get the sum of weights of of all the entries

Specified by:

sumOfWeights in interface ICloud

Specified by:

sumOfWeights in class Cloud

Returns:

The sum of the weights of all the entries.

setConversionParameters

public void setConversionParameters(int binsX,
                                    double lowerEdgeX,
                                    double upperEdgeX,
                                    int binsY,
                                    double lowerEdgeY,
                                    double upperEdgeY,
                                    int binsZ,
                                    double lowerEdgeZ,
                                    double upperEdgeZ)

Set the parameters for the ICloud conversion to an IHistogram.

Specified by:

setConversionParameters in interface ICloud3D

Parameters:

binsX - The X axis number of bins of the conversion IHistogram.

lowerEdgeX - The X axis lower edge of the conversion IHistogram.

upperEdgeX - The X axis upper edge of the conversion IHistogram.

binsY - The Y axis number of bins of the conversion IHistogram.

lowerEdgeY - The Y axis lower edge of the conversion IHistogram.

upperEdgeY - The Y axis upper edge of the conversion IHistogram.

binsZ - The Z axis number of bins of the conversion IHistogram.

lowerEdgeZ - The Z axis lower edge of the conversion IHistogram.

upperEdgeZ - The Z axis upper edge of the conversion IHistogram.

conversionBinsX

public int conversionBinsX()

conversionLowerEdgeX

public double conversionLowerEdgeX()

conversionUpperEdgeX

public double conversionUpperEdgeX()

conversionBinsY

public int conversionBinsY()

conversionLowerEdgeY

public double conversionLowerEdgeY()

conversionUpperEdgeY

public double conversionUpperEdgeY()

conversionBinsZ

public int conversionBinsZ()

conversionLowerEdgeZ

public double conversionLowerEdgeZ()

conversionUpperEdgeZ

public double conversionUpperEdgeZ()