|
Isis 3.0 Developer's Reference (API) |
Home |
Gaussian stretch class. More...
#include <GaussianStretch.h>
Inherits Isis::Statistics.
Public Member Functions | |
| GaussianStretch (Histogram &histogram, const double mean=0.0, const double standardDeviation=1.0) | |
| Constructs a gaussian stretch object. | |
| ~GaussianStretch () | |
| double | Map (const double value) const |
| Maps an input value to an output value based on the gaussian distribution. | |
| 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 | StandardDeviation () const |
| Computes and returns the standard deviation. | |
| 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. | |
Gaussian stretch class.
This class is used to stretch the input histogram to a gaussian distribution with the specified mean and standard deviation.
| Isis::GaussianStretch::GaussianStretch | ( | Histogram & | histogram, | |
| const double | mean = 0.0, |
|||
| const double | standardDeviation = 1.0 | |||
| ) |
Constructs a gaussian stretch object.
| histogram | The input histogram | |
| mean | The mean of the output distribution | |
| standardDeviation | The standard deviation of the output distribution |
References Isis::Stretch::AddPair(), Isis::Histogram::Bins(), Isis::Stretch::ClearPairs(), Isis::GaussianDistribution::InverseCumulativeDistribution(), Isis::Statistics::Maximum(), Isis::Statistics::Minimum(), and Isis::Histogram::Percent().
| Isis::GaussianStretch::~GaussianStretch | ( | ) | [inline] |
| bool Isis::Statistics::AboveRange | ( | const double | value | ) | [inline, inherited] |
Referenced by Isis::Statistics::AddData(), and Isis::Statistics::RemoveData().
| void Isis::Statistics::AddData | ( | const double | data | ) | [inline, 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. |
References Isis::Statistics::AboveRange(), Isis::Statistics::InRange(), Isis::IsHisPixel(), Isis::IsHrsPixel(), Isis::IsLisPixel(), Isis::IsLrsPixel(), Isis::IsNullPixel(), and Isis::IsValidPixel().
| 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.
References value.
Referenced by Isis::HiEqualization::HiCalculateFunctor::addStats(), Isis::Equalization::CalculateFunctor::addStats(), Isis::Process::CalculateStatistics(), Isis::ControlNetStatistics::GenerateImageStats(), Isis::ControlPoint::GetLineResidualRms(), Isis::ControlPoint::GetResidualRms(), Isis::ControlPoint::GetSampleResidualRms(), Isis::ControlPoint::GetStatistic(), Isis::Cube::getStatistics(), Isis::AutoReg::Reduce(), Isis::SpectralPlotTool::refreshPlot(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::VisualDisplay::setPixelData(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::BundleAdjust::Solve(), 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::ControlNetStatistics::GenerateControlNetStats(), Isis::VisualDisplay::paintPixmap(), Isis::AutoReg::Reduce(), Isis::Histogram::Skew(), Isis::BundleAdjust::Solve(), Isis::OverlapStatistics::toPvl(), and Isis::Statistics::ZScore().
| bool Isis::Statistics::BelowRange | ( | const double | value | ) | [inline, inherited] |
| 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::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(), min(), Isis::Statistics::Minimum(), and Isis::NULL8.
Referenced by 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::iException::Message(), 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::iException::Message(), Isis::NULL8, Isis::iException::Programmer, and Isis::Statistics::StandardDeviation().
Referenced by Isis::Statistics::BestMinimum().
| 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 | ) | [inline, inherited] |
Referenced by Isis::Statistics::AddData(), Isis::Histogram::AddData(), and Isis::Statistics::RemoveData().
| 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::GaussianStretch::Map | ( | const double | value | ) | const |
Maps an input value to an output value based on the gaussian distribution.
| value | Value to map |
References Isis::Stretch::Map().
| 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::iException::Message(), Isis::NULL8, and Isis::iException::Programmer.
Referenced by Isis::Statistics::BestMaximum(), GaussianStretch(), Isis::ControlNetStatistics::GenerateControlNetStats(), Isis::ControlNet::GetMaximumResidual(), Isis::VisualDisplay::paintPixmap(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::HistogramWidget::setHistogram(), Isis::StretchTool::stretchBuffer(), and Isis::Statistics::ZScore().
| 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::iException::Message(), Isis::NULL8, and Isis::iException::Programmer.
Referenced by Isis::Statistics::BestMinimum(), GaussianStretch(), Isis::ControlNetStatistics::GenerateControlNetStats(), Isis::VisualDisplay::paintPixmap(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::HistogramWidget::setHistogram(), and Isis::StretchTool::stretchBuffer().
| 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.
| void Isis::Statistics::RemoveData | ( | const double | data | ) | [inherited] |
References Isis::Statistics::RemoveData().
| 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. |
| Isis::iException::Message | RemoveData is trying to remove data that doesn't exist. |
Reimplemented in Isis::Histogram.
References _FILEINFO_, Isis::Statistics::AboveRange(), Isis::Statistics::InRange(), Isis::IsHisPixel(), Isis::IsHrsPixel(), Isis::IsLisPixel(), Isis::IsLrsPixel(), Isis::IsNullPixel(), Isis::IsValidPixel(), Isis::iException::Message(), and Isis::iException::Programmer.
Referenced by Isis::Statistics::RemoveData().
| void Isis::Statistics::Reset | ( | ) | [inherited] |
Reset all accumulators and counters to zero.
Reimplemented in Isis::Histogram.
Referenced by Isis::AutoReg::Reduce(), 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::SetValidRange | ( | const double | minimum = Isis::ValidMinimum, |
|
| const double | maximum = Isis::ValidMaximum | |||
| ) | [inherited] |
| double Isis::Statistics::StandardDeviation | ( | ) | const [inherited] |
Computes and returns the standard deviation.
If there are no valid pixels, then NULL8 is returned.
Reimplemented in Isis::GaussianDistribution.
References Isis::NULL8, and Isis::Statistics::Variance().
Referenced by Isis::Statistics::ChebyshevMaximum(), Isis::Statistics::ChebyshevMinimum(), Isis::VisualDisplay::paintPixmap(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::Histogram::Skew(), Isis::OverlapStatistics::toPvl(), and Isis::Statistics::ZScore().
| double Isis::Statistics::Sum | ( | ) | const [inline, inherited] |
Returns the sum of all the data.
| double Isis::Statistics::SumSquare | ( | ) | const [inline, inherited] |
Returns the sum of all the squared data.
Referenced by 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 [inline, inherited] |
| double Isis::Statistics::ValidMinimum | ( | ) | const [inline, inherited] |
| 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::QHistogram::Load(), Isis::Histogram::Percent(), 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::Statistics::StandardDeviation(), and Isis::OverlapStatistics::toPvl().
| 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::Message(), Isis::iException::Programmer, and Isis::Statistics::StandardDeviation().