Isis Developer Reference
|
Gaussian stretch class. More...
#include <GaussianStretch.h>
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 | readStatistics (QXmlStreamReader *xmlReader) |
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 | 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 |
PvlGroup | toPvl (QString name="Statistics") const |
Serialize statistics as a pvl group. | |
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) |
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::Statistics::Maximum(), Isis::Statistics::Minimum(), and Isis::Histogram::Percent().
|
inline |
|
inherited |
Referenced by Isis::Statistics::AddData(), Isis::Statistics::InRange(), and Isis::Statistics::RemoveData().
|
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. |
References Isis::Statistics::AddData().
Referenced by Isis::Histogram::AddData(), Isis::ImageHistogram::AddData(), Isis::Statistics::AddData(), Isis::MultivariateStatistics::AddData(), Isis::Histogram::AddData(), Isis::ImageHistogram::AddData(), Isis::MultivariateStatistics::AddData(), Isis::HiEqualization::HiCalculateFunctor::addStats(), Isis::CameraStatistics::addStats(), Isis::averageLines(), Isis::averageSamples(), Isis::IndependentCubeViewport::cubeDataChanged(), Isis::GainLineStat(), Isis::ControlNetStatistics::GenerateImageStats(), Isis::ControlPoint::GetStatistic(), Isis::ControlPoint::GetStatistic(), Isis::ControlPointGraphicsItem::paint(), and Isis::VisualDisplay::setPixelData().
|
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::BelowRange(), Isis::IsHisPixel(), Isis::IsHrsPixel(), Isis::IsLisPixel(), Isis::IsLrsPixel(), and Isis::IsNullPixel().
|
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::VisualDisplay::paintPixmap(), Isis::Histogram::Skew(), Isis::CameraStatistics::toPvl(), Isis::Statistics::toPvl(), and Isis::Statistics::ZScore().
|
inherited |
Referenced by Isis::Statistics::AddData(), Isis::Statistics::InRange(), and Isis::Statistics::RemoveData().
|
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(), Isis::Statistics::Minimum(), and Isis::NULL8.
Referenced by Isis::VisualDisplay::setPixelData(), and Isis::LinearStretchType::setStretch().
|
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::Maximum(), Isis::Statistics::Minimum(), and Isis::NULL8.
Referenced by Isis::VisualDisplay::setPixelData(), and Isis::LinearStretchType::setStretch().
|
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().
|
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().
|
inherited |
Returns the total number of high instrument saturation (HIS) pixels encountered.
Referenced by Isis::Statistics::toPvl().
|
inherited |
Returns the total number of high representation saturation (HRS) pixels encountered.
Referenced by Isis::Statistics::toPvl().
|
inherited |
References Isis::Statistics::AboveRange(), and Isis::Statistics::BelowRange().
Referenced by Isis::Histogram::AddData(), Isis::ImageHistogram::AddData(), Isis::Histogram::AddData(), and Isis::ImageHistogram::AddData().
|
inherited |
Returns the total number of low instrument saturation (LIS) pixels encountered.
Referenced by Isis::Statistics::toPvl().
|
inherited |
Returns the total number of low representation saturation (LRS) pixels encountered.
Referenced by Isis::Statistics::toPvl().
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().
|
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::Statistics::BestMinimum(), Isis::QnetPointJigsawErrorFilter::filter(), Isis::QnetPointRegistrationErrorFilter::filter(), GaussianStretch(), Isis::ControlNetStatistics::GenerateControlNetStats(), Isis::VisualDisplay::paintPixmap(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::BinaryStretchType::setStretch(), Isis::CameraStatistics::toPvl(), Isis::Statistics::toPvl(), and Isis::Statistics::ZScore().
|
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::BestMaximum(), Isis::Statistics::BestMinimum(), GaussianStretch(), Isis::ControlNetStatistics::GenerateControlNetStats(), Isis::VisualDisplay::paintPixmap(), Isis::SawtoothStretchType::SawtoothStretchType(), Isis::BinaryStretchType::setStretch(), Isis::CameraStatistics::toPvl(), and Isis::Statistics::toPvl().
|
inherited |
Returns the total number of NULL pixels encountered.
Referenced by Isis::Statistics::toPvl().
|
inherited |
Returns the total number of pixels outside of the valid range encountered.
|
inherited |
Returns the total number of pixels over the valid range encountered.
Referenced by Isis::Statistics::toPvl().
|
inherited |
Referenced by Isis::operator>>().
|
inherited |
References Isis::toBigInt(), Isis::toBool(), Isis::toDouble(), Isis::ValidMaximum, and Isis::ValidMinimum.
Referenced by Isis::Statistics::Statistics().
|
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. |
References Isis::Statistics::RemoveData().
Referenced by Isis::Histogram::RemoveData(), Isis::ImageHistogram::RemoveData(), Isis::Statistics::RemoveData(), and Isis::MultivariateStatistics::RemoveData().
|
inherited |
|
inherited |
|
inherited |
Reset all accumulators and counters to zero.
Referenced by Isis::AutoReg::Reduce(), Isis::Histogram::Reset(), Isis::MultivariateStatistics::Reset(), Isis::VisualDisplay::setLines(), Isis::VisualDisplay::setPixelData(), Isis::VisualDisplay::setSamples(), Isis::Statistics::Statistics(), Isis::Statistics::Statistics(), and Isis::Statistics::Statistics().
|
inherited |
Computes and returns the rms.
If there are no valid pixels, then NULL8 is returned.
References Isis::NULL8.
|
inherited |
References Isis::toString().
|
inherited |
|
inherited |
Computes and returns the standard deviation.
If there are no valid pixels, then NULL8 is returned.
References Isis::NULL8, and Isis::Statistics::Variance().
Referenced by Isis::Statistics::ChebyshevMaximum(), Isis::Statistics::ChebyshevMinimum(), Isis::MultivariateStatistics::Correlation(), Isis::VisualDisplay::paintPixmap(), Isis::Histogram::Skew(), Isis::CameraStatistics::toPvl(), Isis::Statistics::toPvl(), and Isis::Statistics::ZScore().
|
inherited |
Returns the sum of all the data.
Referenced by Isis::MultivariateStatistics::Covariance(), Isis::MultivariateStatistics::LinearRegression(), and Isis::Statistics::toPvl().
|
inherited |
Returns the sum of all the squared data.
Referenced by Isis::MultivariateStatistics::LinearRegression(), and Isis::Statistics::toPvl().
|
inherited |
Serialize statistics as a pvl group.
QString | name (Default value is "Statistics") - Name of the statistics group |
References Isis::Statistics::Average(), Isis::Statistics::HisPixels(), Isis::Statistics::HrsPixels(), Isis::Statistics::LisPixels(), Isis::Statistics::LrsPixels(), Isis::Statistics::Maximum(), Isis::Statistics::Minimum(), Isis::Statistics::NullPixels(), Isis::Statistics::OverRangePixels(), Isis::Statistics::StandardDeviation(), Isis::Statistics::Sum(), Isis::Statistics::SumSquare(), Isis::toString(), Isis::Statistics::TotalPixels(), Isis::Statistics::UnderRangePixels(), Isis::Statistics::ValidMaximum(), Isis::Statistics::ValidMinimum(), Isis::Statistics::ValidPixels(), and Isis::Statistics::Variance().
Referenced by Isis::MultivariateStatistics::toPvl().
|
inherited |
Returns the total number of pixels processed (valid and invalid).
Referenced by Isis::VisualDisplay::paintPixmap(), and Isis::Statistics::toPvl().
|
inherited |
Returns the total number of pixels under the valid range encountered.
Referenced by Isis::Statistics::toPvl().
|
inherited |
Referenced by Isis::Histogram::Histogram(), and Isis::Statistics::toPvl().
|
inherited |
Referenced by Isis::Histogram::Histogram(), and Isis::Statistics::toPvl().
|
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::Histogram::Percent(), Isis::Histogram::Skew(), and Isis::Statistics::toPvl().
|
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::Statistics::toPvl().
|
inherited |
Order saved must match the offsets in the static compoundH5DataType() method.
Referenced by Isis::operator<<().
|
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().