gaussian distribution class More...

#include <GaussianDistribution.h>

Inheritance diagram for Isis::GaussianDistribution:

Collaboration diagram for Isis::GaussianDistribution:

Public Member Functions
	GaussianDistribution (const double mean=0.0, const double standardDeviation=1.0)
	Constructs a gaussian distribution object.

double	Probability (const double value)
	Computes and returns the probability of the specified value on the gaussian distribution.

double	CumulativeDistribution (const double value)
	Computes and returns the cumulative distribution up to the specified value on the gaussian distribution.

double	InverseCumulativeDistribution (const double percent)
	Computes and returns the inverse cumulative distribution evaluated at the specified percentage value on the gaussian distribution.

double	Mean () const
	Returns the mean.

double	StandardDeviation () const
	Returns the standard deviation.

void	Reset ()
	Reset all accumulators and counters to zero.

void	AddData (const double *data, const unsigned int count)
	Add an array of doubles to the accumulators and counters.

void	AddData (const double data)
	Add a double to the accumulators and counters.

void	RemoveData (const double *data, const unsigned int count)
	Remove an array of doubles from the accumulators and counters.

void	RemoveData (const double data)

void	SetValidRange (const double minimum=Isis::ValidMinimum, const double maximum=Isis::ValidMaximum)

double	ValidMinimum () const

double	ValidMaximum () const

bool	InRange (const double value)

bool	AboveRange (const double value)

bool	BelowRange (const double value)

double	Average () const
	Computes and returns the average.

double	Variance () const
	Computes and returns the variance.

double	Rms () const
	Computes and returns the rms.

double	Minimum () const
	Returns the absolute minimum double found in all data passed through the AddData method.

double	Maximum () const
	Returns the absolute maximum double found in all data passed through the AddData method.

double	ChebyshevMinimum (const double percent=99.5) const
	This method returns a minimum such that X percent of the data will fall with K standard deviations of the average (Chebyshev's Theorem).

double	ChebyshevMaximum (const double percent=99.5) const
	This method returns a maximum such that X percent of the data will fall with K standard deviations of the average (Chebyshev's Theorem).

double	BestMinimum (const double percent=99.5) const
	This method returns the better of the absolute minimum or the Chebyshev minimum.

double	BestMaximum (const double percent=99.5) const
	This method returns the better of the absolute maximum or the Chebyshev maximum.

double	ZScore (const double value) const
	This method returns the better of the z-score of the given value.

BigInt	TotalPixels () const
	Returns the total number of pixels processed (valid and invalid).

BigInt	ValidPixels () const
	Returns the total number of valid pixels processed.

BigInt	OverRangePixels () const
	Returns the total number of pixels over the valid range encountered.

BigInt	UnderRangePixels () const
	Returns the total number of pixels under the valid range encountered.

BigInt	NullPixels () const
	Returns the total number of NULL pixels encountered.

BigInt	LisPixels () const
	Returns the total number of low instrument saturation (LIS) pixels encountered.

BigInt	LrsPixels () const
	Returns the total number of low representation saturation (LRS) pixels encountered.

BigInt	HisPixels () const
	Returns the total number of high instrument saturation (HIS) pixels encountered.

BigInt	HrsPixels () const
	Returns the total number of high representation saturation (HRS) pixels encountered.

BigInt	OutOfRangePixels () const
	Returns the total number of pixels outside of the valid range encountered.

double	Sum () const
	Returns the sum of all the data.

double	SumSquare () const
	Returns the sum of all the squared data.

Private Member Functions
double	A (const double x)

double	B (const double x)

double	C (const double x)

double	D (const double x)

Private Attributes
double	p_mean
	Value of the mean.

double	p_stdev
	Value of the standard deviation.

Detailed Description

gaussian distribution class

This class is used to calculate the probability distribution function, the cumulative distribution function, and the inverse cumulative distribution function of a gaussian (or normal) distribution.

Author: 2006-05-25 Jacob Danton

History:

2006-05-25 Jacob Danton Original Version

2007-07-09 Janet Barrett - Removed invalid declaration of "static const double" variables p_lowCutoff and p_highCutoff from this file and moved them to the GaussianDistribution.cpp file. The variables were also renamed to lowCutoff and highCutoff.

Definition at line 53 of file GaussianDistribution.h.

Constructor & Destructor Documentation

Isis::GaussianDistribution::GaussianDistribution	(	const double	mean = `0.0`,
		const double	standardDeviation = `1.0`
	)

Constructs a gaussian distribution object.

Parameters

mean	The Distribution's mean
standardDeviation	The Distribution's standard deviation

Definition at line 36 of file GaussianDistribution.cpp.

Member Function Documentation

void Isis::Statistics::AddData	(	const double *	data,
		const unsigned int	count
	)

inherited

Add an array of doubles to the accumulators and counters.

This method can be invoked multiple times (for example: once for each line in a cube) before obtaining statistics.

Parameters

data	The data to be added to the data set used for statistical calculations.
count	The number of elements in the incoming data to be added.

Definition at line 66 of file Statistics.cpp.

Referenced by Isis::MultivariateStatistics::AddData(), Isis::CameraStatistics::addStats(), Isis::Process::CalculateStatistics(), Isis::Gruen::CheckConstraints(), Isis::BundleAdjust::ComputeBundleStatistics(), Isis::AutoReg::ComputeChipZScore(), Isis::ChipViewport::computeStretch(), Isis::ControlPoint::GetLineResidualRms(), Isis::ControlNetStatistics::GetPointDoubleStats(), Isis::ControlPoint::GetResidualRms(), Isis::ControlPoint::GetSampleResidualRms(), Isis::SpatialPlotTool::getSpatialStatistics(), Isis::SpectralPlotTool::getSpectralStatistics(), Isis::ControlPoint::GetStatistic(), Isis::StatisticsTool::getStatistics(), Isis::MosaicSceneItem::getStretch(), Isis::StandardDeviationOperator::Interest(), Isis::AutoReg::Reduce(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::VisualDisplay::setPixelData(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::Chip::Statistics(), Isis::Cube::statistics(), and Isis::StretchTool::statsFromCube().

void Isis::Statistics::AddData ( const double data )

inlineinherited

Add a double to the accumulators and counters.

This method can be invoked multiple times (for example: once for each pixel in a cube) before obtaining statistics.

Parameters

data	The data to be added to the data set used for statistical calculations.

Definition at line 94 of file Statistics.h.

double Isis::Statistics::Average ( ) const

inherited

Computes and returns the average.

If there are no valid pixels, then NULL8 is returned.

Returns: The Average

Definition at line 150 of file Statistics.cpp.

Referenced by Isis::OverlapNormalization::AddOverlap(), Isis::ControlNet::AverageResidual(), Isis::MultivariateStatistics::Covariance(), Isis::ControlNetStatistics::GetPointDoubleStats(), Isis::SpatialPlotTool::getSpatialStatistics(), Isis::SpectralPlotTool::getSpectralStatistics(), Isis::StatisticsTool::getStatistics(), Isis::VisualDisplay::paintPixmap(), Isis::AutoReg::Reduce(), Isis::HistogramTool::refreshPlot(), Isis::OverlapNormalization::Solve(), Isis::Gruen::StatsLog(), and Isis::CameraStatistics::toPvl().

double Isis::Statistics::BestMaximum ( const double percent = 99.5 ) const

inherited

This method returns the better of the absolute maximum or the Chebyshev maximum.

The better value is considered the value closest to the mean.

Parameters

percent The probability that the maximum is within K standard deviations of the mean (Used to compute the Chebyshev maximum). Default value = 99.5.

Returns: Best of absolute and Chebyshev maximums

See Also: Statistics::Maximum Statistics::ChebyshevMaximum

Definition at line 427 of file Statistics.cpp.

Referenced by Isis::ChipViewport::computeStretch(), Isis::MosaicSceneItem::getStretch(), Isis::StretchTool::histFromBuffer(), Isis::VisualDisplay::setPixelData(), Isis::LinearStretchType::setStretch(), Isis::StretchTool::stretchBand(), and Isis::StretchTool::stretchBuffer().

double Isis::Statistics::BestMinimum ( const double percent = 99.5 ) const

inherited

This method returns the better of the absolute minimum or the Chebyshev minimum.

The better value is considered the value closest to the mean.

Parameters

percent The probability that the minimum is within K standard deviations of the mean (Used to compute the Chebyshev minimum). Default value = 99.5.

Returns: Best of absolute and Chebyshev minimums

See Also: Statistics::Minimum Statistics::ChebyshevMinimum

Definition at line 405 of file Statistics.cpp.

Referenced by Isis::ChipViewport::computeStretch(), Isis::MosaicSceneItem::getStretch(), Isis::StretchTool::histFromBuffer(), Isis::VisualDisplay::setPixelData(), Isis::LinearStretchType::setStretch(), Isis::StretchTool::stretchBand(), and Isis::StretchTool::stretchBuffer().

double Isis::Statistics::ChebyshevMaximum ( const double percent = 99.5 ) const

inherited

This method returns a maximum such that X percent of the data will fall with K standard deviations of the average (Chebyshev's Theorem).

It can be used to obtain a minimum that does not include statistical outliers.

Parameters

percent The probability that the maximum is within K standard deviations of the mean. Default value = 99.5.

Returns: maximum value excluding statistical outliers

Exceptions

Isis::IException::Message

Definition at line 380 of file Statistics.cpp.

References _FILEINFO_.

double Isis::Statistics::ChebyshevMinimum ( const double percent = 99.5 ) const

inherited

This method returns a minimum such that X percent of the data will fall with K standard deviations of the average (Chebyshev's Theorem).

It can be used to obtain a minimum that does not include statistical outliers.

Parameters

percent The probability that the minimum is within K standard deviations of the mean. Default value = 99.5.

Returns: Minimum value (excluding statistical outliers)

Exceptions

Isis::IException::Message

Definition at line 354 of file Statistics.cpp.

References _FILEINFO_.

double Isis::GaussianDistribution::CumulativeDistribution ( const double value )

Computes and returns the cumulative distribution up to the specified value on the gaussian distribution.

Parameters

value the input value

Returns: The CDF evaluated at the specified value

Definition at line 62 of file GaussianDistribution.cpp.

References Isis::PI().

BigInt Isis::Statistics::HisPixels ( ) const

inherited

Returns the total number of high instrument saturation (HIS) pixels encountered.

Returns: The number of HIS pixels (data) processed

Definition at line 315 of file Statistics.cpp.

BigInt Isis::Statistics::HrsPixels ( ) const

inherited

Returns the total number of high representation saturation (HRS) pixels encountered.

Returns: The number of HRS pixels (data) processed

Definition at line 325 of file Statistics.cpp.

double Isis::GaussianDistribution::InverseCumulativeDistribution ( const double percent )

Computes and returns the inverse cumulative distribution evaluated at the specified percentage value on the gaussian distribution.

See Also

"Rational Chebyshev Approximations for the Error Function

W. J. Cody

http://home.online.no/~pjacklam/notes/invnorm/#The_distribution_function

Parameters

percent The input percentage value

Returns: The ICDF evaluated at the specified percentage value

Definition at line 104 of file GaussianDistribution.cpp.

References _FILEINFO_, and Isis::PI().

Referenced by Isis::GaussianStretch::GaussianStretch().

BigInt Isis::Statistics::LisPixels ( ) const

inherited

Returns the total number of low instrument saturation (LIS) pixels encountered.

Returns: The number of LIS pixels (data) processed

Definition at line 295 of file Statistics.cpp.

BigInt Isis::Statistics::LrsPixels ( ) const

inherited

Returns the total number of low representation saturation (LRS) pixels encountered.

Returns: The number of LRS pixels (data) processed

Definition at line 305 of file Statistics.cpp.

double Isis::Statistics::Maximum ( ) const

inherited

Returns the absolute maximum double found in all data passed through the AddData method.

If there are no valid pixels, then NULL8 is returned.

Returns: Current maximum value in data set

Exceptions

Isis::IException::Message The data set is blank, so the maximum is invalid.

Definition at line 228 of file Statistics.cpp.

References _FILEINFO_.

Referenced by Isis::BinaryStretchType::calculateNewStretch(), Isis::SawtoothStretchType::calculateNewStretch(), Isis::AutoReg::ComputeChipZScore(), Isis::BinaryStretchType::endEditChanged(), Isis::LinearStretchType::endEditChanged(), Isis::BinaryStretchType::endSliderMoved(), Isis::LinearStretchType::endSliderMoved(), Isis::QnetPointJigsawErrorFilter::filter(), Isis::QnetPointRegistrationErrorFilter::filter(), Isis::GaussianStretch::GaussianStretch(), Isis::ControlNet::GetMaximumResidual(), Isis::ControlNetStatistics::GetPointDoubleStats(), Isis::StatisticsTool::getStatistics(), Isis::SawtoothStretchType::offsetEditChanged(), Isis::SawtoothStretchType::offsetSliderMoved(), Isis::VisualDisplay::paintPixmap(), Isis::HistogramTool::refreshPlot(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::ScatterPlotData::ScatterPlotData(), Isis::HistogramWidget::setHistogram(), Isis::BinaryStretchType::setStretch(), Isis::BinaryStretchType::startEditChanged(), Isis::LinearStretchType::startEditChanged(), Isis::BinaryStretchType::startSliderMoved(), Isis::LinearStretchType::startSliderMoved(), Isis::Gruen::StatsLog(), Isis::StretchTool::stretchBuffer(), Isis::CameraStatistics::toPvl(), Isis::SawtoothStretchType::widthEditChanged(), and Isis::SawtoothStretchType::widthSliderMoved().

double Isis::GaussianDistribution::Mean ( ) const

inline

Returns the mean.

Returns: The mean

Definition at line 67 of file GaussianDistribution.h.

References p_mean.

double Isis::Statistics::Minimum ( ) const

inherited

Returns the absolute minimum double found in all data passed through the AddData method.

If there are no valid pixels, then NULL8 is returned.

Returns: Current minimum value in data set.

Exceptions

Isis::IException::Message The data set is blank, so the minimum is invalid.

Definition at line 208 of file Statistics.cpp.

References _FILEINFO_.

Referenced by Isis::BinaryStretchType::calculateNewStretch(), Isis::SawtoothStretchType::calculateNewStretch(), Isis::AutoReg::ComputeChipZScore(), Isis::BinaryStretchType::endEditChanged(), Isis::LinearStretchType::endEditChanged(), Isis::BinaryStretchType::endSliderMoved(), Isis::LinearStretchType::endSliderMoved(), Isis::GaussianStretch::GaussianStretch(), Isis::ControlNetStatistics::GetPointDoubleStats(), Isis::StatisticsTool::getStatistics(), Isis::SawtoothStretchType::offsetEditChanged(), Isis::SawtoothStretchType::offsetSliderMoved(), Isis::VisualDisplay::paintPixmap(), Isis::HistogramTool::refreshPlot(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::ScatterPlotData::ScatterPlotData(), Isis::HistogramWidget::setHistogram(), Isis::BinaryStretchType::setStretch(), Isis::BinaryStretchType::startEditChanged(), Isis::LinearStretchType::startEditChanged(), Isis::BinaryStretchType::startSliderMoved(), Isis::LinearStretchType::startSliderMoved(), Isis::Gruen::StatsLog(), Isis::StretchTool::stretchBuffer(), Isis::CameraStatistics::toPvl(), Isis::SawtoothStretchType::widthEditChanged(), and Isis::SawtoothStretchType::widthSliderMoved().

BigInt Isis::Statistics::NullPixels ( ) const

inherited

Returns the total number of NULL pixels encountered.

Returns: The number of NULL pixels (data) processed

Definition at line 285 of file Statistics.cpp.

BigInt Isis::Statistics::OutOfRangePixels ( ) const

inherited

Returns the total number of pixels outside of the valid range encountered.

Returns: The number of Out of Range pixels (data) processed

Definition at line 335 of file Statistics.cpp.

BigInt Isis::Statistics::OverRangePixels ( ) const

inherited

Returns the total number of pixels over the valid range encountered.

Returns: The number of pixels less than the ValidMaximum() processed

Definition at line 266 of file Statistics.cpp.

double Isis::GaussianDistribution::Probability ( const double value )

Computes and returns the probability of the specified value on the gaussian distribution.

Parameters

value The input value

Returns: The PDF evaluated at the specified value

Definition at line 49 of file GaussianDistribution.cpp.

References Isis::PI().

void Isis::Statistics::RemoveData	(	const double *	data,
		const unsigned int	count
	)

inherited

Remove an array of doubles from the accumulators and counters.

Note that is invalidates the absolute minimum and maximum. They will no longer be usable.

Parameters

data	The data to be removed from data set used for statistical calculations.
count	The number of elements in the data to be removed.

Exceptions

Isis::IException::Message RemoveData is trying to remove data that doesn't exist.

Definition at line 88 of file Statistics.cpp.

References _FILEINFO_, Isis::IsHisPixel(), Isis::IsHrsPixel(), Isis::IsLisPixel(), Isis::IsLrsPixel(), Isis::IsNullPixel(), and Isis::IsValidPixel().

Referenced by Isis::MultivariateStatistics::RemoveData().

void Isis::Statistics::Reset ( )

inherited

Reset all accumulators and counters to zero.

Definition at line 36 of file Statistics.cpp.

Referenced by Isis::AutoReg::Reduce(), Isis::MultivariateStatistics::Reset(), Isis::Gruen::resetStats(), Isis::VisualDisplay::setLines(), Isis::VisualDisplay::setPixelData(), and Isis::VisualDisplay::setSamples().

double Isis::Statistics::Rms ( ) const

inherited

Computes and returns the rms.

If there are no valid pixels, then NULL8 is returned.

Returns: The rms (root mean square)

History:: 2011-06-13 Ken Edmundson.

Definition at line 192 of file Statistics.cpp.

Referenced by Isis::BundleAdjust::ComputeBundleStatistics(), Isis::ControlPoint::GetLineResidualRms(), Isis::ControlPoint::GetResidualRms(), and Isis::ControlPoint::GetSampleResidualRms().

double Isis::GaussianDistribution::StandardDeviation ( ) const

inline

Returns the standard deviation.

Returns: The standard deviation

Definition at line 76 of file GaussianDistribution.h.

References p_stdev.

double Isis::Statistics::Sum ( ) const

inlineinherited

Returns the sum of all the data.

Returns: The sum of the data

Definition at line 176 of file Statistics.h.

References Isis::Statistics::p_sum.

Referenced by Isis::MultivariateStatistics::Covariance(), and Isis::MultivariateStatistics::LinearRegression().

double Isis::Statistics::SumSquare ( ) const

inlineinherited

Returns the sum of all the squared data.

Returns: The sum of the squared data

Definition at line 185 of file Statistics.h.

References Isis::Statistics::p_sumsum.

Referenced by Isis::MultivariateStatistics::LinearRegression().

BigInt Isis::Statistics::TotalPixels ( ) const

inherited

Returns the total number of pixels processed (valid and invalid).

Returns: The number of pixels (data) processed

Definition at line 244 of file Statistics.cpp.

Referenced by Isis::VisualDisplay::paintPixmap().

BigInt Isis::Statistics::UnderRangePixels ( ) const

inherited

Returns the total number of pixels under the valid range encountered.

Returns: The number of pixels less than the ValidMinimum() processed

Definition at line 276 of file Statistics.cpp.

BigInt Isis::Statistics::ValidPixels ( ) const

inherited

Returns the total number of valid pixels processed.

Only valid pixels are utilized when computing the average, standard deviation, variance, minimum and maximum.

Returns: The number of valid pixels (data) processed

Definition at line 256 of file Statistics.cpp.

Referenced by Isis::OverlapNormalization::AddOverlap(), Isis::ControlNetStatistics::GetPointDoubleStats(), Isis::StatisticsTool::getStatistics(), Isis::QHistogram::Load(), Isis::HistogramTool::refreshPlot(), Isis::StretchTool::stretchBuffer(), and Isis::StretchTool::updateHistograms().

double Isis::Statistics::Variance ( ) const

inherited

Computes and returns the variance.

If there are no valid pixels, then NULL8 is returned.

Returns: The variance

History:: 2003-08-27 Jeff Anderson - Modified Variance method to compute using n*(n-1) instead of n*n.

Definition at line 176 of file Statistics.cpp.

Referenced by Isis::HistogramTool::refreshPlot().

double Isis::Statistics::ZScore ( const double value ) const

inherited

This method returns the better of the z-score of the given value.

The z-score is the number of standard deviations the value lies above or below the average.

Parameters

value The value to calculate the z-score of.

Returns: z-score

Definition at line 446 of file Statistics.cpp.

References _FILEINFO_.

Referenced by Isis::AutoReg::ComputeChipZScore().

Member Data Documentation

double Isis::GaussianDistribution::p_mean

private

Value of the mean.

Definition at line 78 of file GaussianDistribution.h.

Referenced by Mean().

double Isis::GaussianDistribution::p_stdev

private

Value of the standard deviation.

Definition at line 84 of file GaussianDistribution.h.

Referenced by StandardDeviation().

The documentation for this class was generated from the following files:

src/base/objs/GaussianDistribution/GaussianDistribution.h
src/base/objs/GaussianDistribution/GaussianDistribution.cpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation