Isis 3.0 Developer's Reference (API) |
Home |
gaussian distribution class More...
#include <GaussianDistribution.h>
Inherits Isis::Statistics.
Public Member Functions | |
GaussianDistribution (const double mean=0.0, const double standardDeviation=1.0) | |
Constructs a gaussian distribution object. | |
~GaussianDistribution () | |
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 | Sum () const |
Returns the sum of all the data. | |
double | SumSquare () const |
Returns the sum of all the squared data. | |
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. | |
bool | RemovedData () const |
void | save (QXmlStreamWriter &stream, const Project *project) const |
QDataStream & | write (QDataStream &stream) const |
Order saved must match the offsets in the static compoundH5DataType() method. | |
QDataStream & | read (QDataStream &stream) |
Static Public Member Functions | |
static H5::CompType | compoundH5DataType () |
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.
Isis::GaussianDistribution::GaussianDistribution | ( | const double | mean = 0.0 , |
|
const double | standardDeviation = 1.0 | |||
) |
Constructs a gaussian distribution object.
mean | The Distribution's mean | |
standardDeviation | The Distribution's standard deviation |
Isis::GaussianDistribution::~GaussianDistribution | ( | ) | [inline] |
bool Isis::Statistics::AboveRange | ( | const double | value | ) | [inherited] |
Referenced by Isis::Statistics::AddData(), Isis::Statistics::InRange(), and Isis::Statistics::RemoveData().
void Isis::Statistics::AddData | ( | const double | data | ) | [inherited] |
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.
data | The data to be added to the data set used for statistical calculations. |
Reimplemented in Isis::Histogram.
References Isis::Statistics::AboveRange(), Isis::Statistics::BelowRange(), Isis::IsHisPixel(), Isis::IsHrsPixel(), Isis::IsLisPixel(), Isis::IsLrsPixel(), and Isis::IsNullPixel().
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.
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. |
Reimplemented in Isis::Histogram.
Referenced by Isis::MultivariateStatistics::AddData(), Isis::HiEqualization::HiCalculateFunctor::addStats(), Isis::Equalization::CalculateFunctor::addStats(), Isis::CameraStatistics::addStats(), Isis::Process::CalculateStatistics(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::ControlNetStatistics::GenerateImageStats(), Isis::ControlPoint::GetLineResidualRms(), Isis::ControlPoint::GetResidualRms(), Isis::ControlPoint::GetSampleResidualRms(), Isis::ControlPoint::GetStatistic(), Isis::StandardDeviationOperator::Interest(), Isis::ControlPointGraphicsItem::paint(), Isis::AutoReg::Reduce(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::VisualDisplay::setPixelData(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::BundleAdjust::Solve(), Isis::Cube::statistics(), Isis::Chip::Statistics(), and Isis::StretchTool::statsFromCube().
double Isis::Statistics::Average | ( | ) | const [inherited] |
Computes and returns the average.
If there are no valid pixels, then NULL8 is returned.
References Isis::NULL8.
Referenced by Isis::OverlapNormalization::AddOverlap(), Isis::ControlNet::AverageResidual(), Isis::Statistics::ChebyshevMaximum(), Isis::Statistics::ChebyshevMinimum(), Isis::MultivariateStatistics::Covariance(), Isis::ControlNetStatistics::GenerateControlNetStats(), Isis::ControlPointGraphicsItem::paint(), Isis::VisualDisplay::paintPixmap(), Isis::AutoReg::Reduce(), Isis::HistogramTool::refreshPlot(), Isis::Histogram::Skew(), Isis::BundleAdjust::Solve(), Isis::CameraStatistics::toPvl(), and Isis::Statistics::ZScore().
bool Isis::Statistics::BelowRange | ( | const double | value | ) | [inherited] |
Referenced by Isis::Statistics::AddData(), Isis::Statistics::InRange(), and Isis::Statistics::RemoveData().
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.
percent | The probability that the maximum is within K standard deviations of the mean (Used to compute the Chebyshev maximum). Default value = 99.5. |
References Isis::Statistics::ChebyshevMaximum(), Isis::Statistics::Maximum(), and Isis::NULL8.
Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), 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.
percent | The probability that the minimum is within K standard deviations of the mean (Used to compute the Chebyshev minimum). Default value = 99.5. |
References Isis::Statistics::ChebyshevMinimum(), Isis::Statistics::Minimum(), and Isis::NULL8.
Referenced by Isis::IndependentCubeViewport::cubeDataChanged(), 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.
percent | The probability that the maximum is within K standard deviations of the mean. Default value = 99.5. |
Isis::IException::Message |
References _FILEINFO_, Isis::Statistics::Average(), Isis::NULL8, Isis::IException::Programmer, and Isis::Statistics::StandardDeviation().
Referenced by Isis::Statistics::BestMaximum().
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.
percent | The probability that the minimum is within K standard deviations of the mean. Default value = 99.5. |
Isis::IException::Message |
References _FILEINFO_, Isis::Statistics::Average(), Isis::NULL8, Isis::IException::Programmer, and Isis::Statistics::StandardDeviation().
Referenced by Isis::Statistics::BestMinimum().
static H5::CompType Isis::Statistics::compoundH5DataType | ( | ) | [static, inherited] |
double Isis::GaussianDistribution::CumulativeDistribution | ( | const double | value | ) |
Computes and returns the cumulative distribution up to the specified value on the gaussian distribution.
value | the input value |
References Isis::PI().
Referenced by InverseCumulativeDistribution().
BigInt Isis::Statistics::HisPixels | ( | ) | const [inherited] |
Returns the total number of high instrument saturation (HIS) pixels encountered.
BigInt Isis::Statistics::HrsPixels | ( | ) | const [inherited] |
Returns the total number of high representation saturation (HRS) pixels encountered.
bool Isis::Statistics::InRange | ( | const double | value | ) | [inherited] |
References Isis::Statistics::AboveRange(), and Isis::Statistics::BelowRange().
Referenced by Isis::Histogram::AddData().
double Isis::GaussianDistribution::InverseCumulativeDistribution | ( | const double | percent | ) |
Computes and returns the inverse cumulative distribution evaluated at the specified percentage value on the gaussian distribution.
percent | The input percentage value |
References _FILEINFO_, CumulativeDistribution(), Isis::PI(), and Isis::IException::Programmer.
Referenced by Isis::GaussianStretch::GaussianStretch().
BigInt Isis::Statistics::LisPixels | ( | ) | const [inherited] |
Returns the total number of low instrument saturation (LIS) pixels encountered.
BigInt Isis::Statistics::LrsPixels | ( | ) | const [inherited] |
Returns the total number of low representation saturation (LRS) pixels encountered.
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.
Isis::IException::Message | The data set is blank, so the maximum is invalid. |
References _FILEINFO_, Isis::NULL8, and Isis::IException::Programmer.
Referenced by Isis::Statistics::BestMaximum(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::QnetPointRegistrationErrorFilter::filter(), Isis::QnetPointJigsawErrorFilter::filter(), Isis::GaussianStretch::GaussianStretch(), Isis::ControlNetStatistics::GenerateControlNetStats(), Isis::ControlNet::GetMaximumResidual(), Isis::ControlPointGraphicsItem::paint(), Isis::VisualDisplay::paintPixmap(), Isis::HistogramTool::refreshPlot(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::ScatterPlotData::ScatterPlotData(), Isis::HistogramWidget::setHistogram(), Isis::BinaryStretchType::setStretch(), Isis::StretchTool::stretchBuffer(), Isis::CameraStatistics::toPvl(), and Isis::Statistics::ZScore().
double Isis::GaussianDistribution::Mean | ( | ) | const [inline] |
Returns the 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.
Isis::IException::Message | The data set is blank, so the minimum is invalid. |
References _FILEINFO_, Isis::NULL8, and Isis::IException::Programmer.
Referenced by Isis::Statistics::BestMinimum(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::GaussianStretch::GaussianStretch(), Isis::ControlNetStatistics::GenerateControlNetStats(), Isis::VisualDisplay::paintPixmap(), Isis::HistogramTool::refreshPlot(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::ScatterPlotData::ScatterPlotData(), Isis::HistogramWidget::setHistogram(), Isis::BinaryStretchType::setStretch(), Isis::StretchTool::stretchBuffer(), and Isis::CameraStatistics::toPvl().
BigInt Isis::Statistics::NullPixels | ( | ) | const [inherited] |
Returns the total number of NULL pixels encountered.
BigInt Isis::Statistics::OutOfRangePixels | ( | ) | const [inherited] |
Returns the total number of pixels outside of the valid range encountered.
BigInt Isis::Statistics::OverRangePixels | ( | ) | const [inherited] |
Returns the total number of pixels over the valid range encountered.
double Isis::GaussianDistribution::Probability | ( | const double | value | ) |
Computes and returns the probability of the specified value on the gaussian distribution.
value | The input value |
References Isis::PI().
QDataStream & Isis::Statistics::read | ( | QDataStream & | stream | ) | [inherited] |
void Isis::Statistics::RemoveData | ( | const double | data | ) | [inherited] |
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.
data | The data to be removed from data set used for statistical calculations. | |
count | The number of elements in the data to be removed. |
IException::Message | RemoveData is trying to remove data that doesn't exist. |
Reimplemented in Isis::Histogram.
Referenced by Isis::MultivariateStatistics::RemoveData().
bool Isis::Statistics::RemovedData | ( | ) | const [inherited] |
void Isis::Statistics::Reset | ( | ) | [inherited] |
Reset all accumulators and counters to zero.
Reimplemented in Isis::Histogram.
Referenced by Isis::AutoReg::Reduce(), Isis::MultivariateStatistics::Reset(), Isis::VisualDisplay::setLines(), Isis::VisualDisplay::setPixelData(), Isis::VisualDisplay::setSamples(), Isis::BundleAdjust::Solve(), and Isis::Statistics::Statistics().
double Isis::Statistics::Rms | ( | ) | const [inherited] |
Computes and returns the rms.
If there are no valid pixels, then NULL8 is returned.
References Isis::NULL8.
Referenced by Isis::ControlPoint::GetLineResidualRms(), Isis::ControlPoint::GetResidualRms(), and Isis::ControlPoint::GetSampleResidualRms().
void Isis::Statistics::save | ( | QXmlStreamWriter & | stream, | |
const Project * | project | |||
) | const [inherited] |
References Isis::toString().
void Isis::Statistics::SetValidRange | ( | const double | minimum = Isis::ValidMinimum , |
|
const double | maximum = Isis::ValidMaximum | |||
) | [inherited] |
Reimplemented in Isis::Histogram.
References _FILEINFO_, Isis::IException::Programmer, and Isis::toString().
Referenced by Isis::StandardDeviationOperator::Interest(), Isis::Statistics::Statistics(), Isis::Cube::statistics(), and Isis::Chip::Statistics().
double Isis::GaussianDistribution::StandardDeviation | ( | ) | const [inline] |
double Isis::Statistics::Sum | ( | ) | const [inherited] |
Returns the sum of all the data.
Referenced by Isis::MultivariateStatistics::Covariance(), and Isis::MultivariateStatistics::LinearRegression().
double Isis::Statistics::SumSquare | ( | ) | const [inherited] |
Returns the sum of all the squared data.
Referenced by Isis::MultivariateStatistics::LinearRegression(), and Isis::BundleAdjust::Solve().
BigInt Isis::Statistics::TotalPixels | ( | ) | const [inherited] |
Returns the total number of pixels processed (valid and invalid).
Referenced by Isis::VisualDisplay::paintPixmap(), and Isis::BundleAdjust::Solve().
BigInt Isis::Statistics::UnderRangePixels | ( | ) | const [inherited] |
Returns the total number of pixels under the valid range encountered.
double Isis::Statistics::ValidMaximum | ( | ) | const [inherited] |
Referenced by Isis::Histogram::Histogram().
double Isis::Statistics::ValidMinimum | ( | ) | const [inherited] |
Referenced by Isis::Histogram::Histogram().
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.
Referenced by Isis::OverlapNormalization::AddOverlap(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::QHistogram::Load(), Isis::Histogram::Percent(), Isis::HistogramTool::refreshPlot(), Isis::Histogram::Skew(), 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.
References Isis::NULL8.
Referenced by Isis::HistogramTool::refreshPlot(), and Isis::Statistics::StandardDeviation().
QDataStream & Isis::Statistics::write | ( | QDataStream & | stream | ) | const [inherited] |
Order saved must match the offsets in the static compoundH5DataType() method.
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.
value | The value to calculate the z-score of. |
References _FILEINFO_, Isis::Statistics::Average(), Isis::Statistics::Maximum(), Isis::IException::Programmer, Isis::Statistics::StandardDeviation(), and Isis::toString().