Calculates statistics in the area of overlap between two projected cubes. More...

#include <OverlapStatistics.h>

Collaboration diagram for Isis::OverlapStatistics:

Public Member Functions
	OverlapStatistics (Isis::Cube &x, Isis::Cube &y, QString progressMsg="Gathering Overlap Statistics", double sampPercent=100.0)
	Constructs an OverlapStatistics object. More...

	OverlapStatistics (const PvlObject &inStats)
	Constructs an OverlapStatistics from a PvlObject. More...

bool	HasOverlap (int band) const
	Checks the specified band for an overlap. More...

bool	HasOverlap () const
	Checks all bands of the cubes for an overlap, and will only return false if none of the bands overlap. More...

Isis::FileName	FileNameX () const
	Returns the filename of the first cube. More...

Isis::FileName	FileNameY () const
	Returns the filename of the second cube. More...

Isis::MultivariateStatistics	GetMStats (int band) const
	Returns the MultivariateStatistics object containing all the data from both cubes in the overlapping area. More...

int	Lines () const
	Returns the number of lines in the overlapping area. More...

int	Samples () const
	Returns the number of samples in the overlapping area. More...

int	Bands () const
	Returns the number of bands both cubes have. More...

double	SampPercent () const
	Returns the percentage of cube lines sampled. More...

int	StartSampleX () const
	Returns the starting sample position of the overlap in the first cube. More...

int	EndSampleX () const
	Returns the ending sample position of the overlap in the first cube. More...

int	StartLineX () const
	Returns the starting line position of the overlap in the first cube. More...

int	EndLineX () const
	Returns the ending line position of the overlap in the first cube. More...

int	StartSampleY () const
	Returns the starting sample position of the overlap in the second cube. More...

int	EndSampleY () const
	Returns the ending sample position of the overlap in the second cube. More...

int	StartLineY () const
	Returns the starting line position of the overlap in the second cube. More...

int	EndLineY () const
	Returns the ending line position of the overlap in the second cube. More...

void	SetMincount (unsigned int mincnt)
	Sets the minimum number of valid pixels for the overlap to be considered valid for PVL output. More...

int	MinCount () const

bool	IsValid (unsigned int band) const
	Returns whether the overlap meets the minimum valid pixel requirement. More...

PvlObject	toPvl (QString name="OverlapStatistics") const
	Creates a Pvl containing the following Overlap Statistics information File1 File2 Width Height Bands SamplingPercent MinCount MutlivariateStatisticsN (N = current band) Covariance Correlation SumXY ValidPixels InvalidPixels TotalPixels LinearRegression ValidOverlap XStatistics #FileX Statistics information YStatistics #FileY Statistics information File1 StartSample EndSample StartLine EndLine Average StandardDeviation Variance File2 StartSample EndSample StartLine EndLine Average StandardDeviation Variance. More...

Private Member Functions
void	fromPvl (const PvlObject &inStats)
	Unserialize overlap statistics from a Pvl. More...

void	init ()
	Reset member variables to default values. More...

Private Attributes
int	p_bands
	Number of bands. More...

double	p_sampPercent
	Percentage of lines sampled. More...

Isis::FileName	p_xFile
	FileName of X cube. More...

Isis::FileName	p_yFile
	FileName of Y cube. More...

int	p_sampRange
	Sample range of overlap. More...

int	p_lineRange
	Line range of overlap. More...

int	p_minSampX
	Starting Sample of overlap in X cube. More...

int	p_maxSampX
	Ending Sample of overlap in X cube. More...

int	p_minSampY
	Starting Sample of overlap in Y cube. More...

int	p_maxSampY
	Ending Sample of overlap in Y cube. More...

int	p_minLineX
	Starting Line of overlap in X cube. More...

int	p_maxLineX
	Ending Line of overlap in X cube. More...

int	p_minLineY
	Starting Line of overlap in Y cube. More...

int	p_maxLineY
	Ending Line of overlap in Y cube. More...

int	p_mincnt
	Minimum valid pixels to be valid overlap. More...

std::vector< Isis::MultivariateStatistics >	p_stats
	Multivariate Stats object for overlap data from both cubes. More...

Detailed Description

Calculates statistics in the area of overlap between two projected cubes.

This class finds the overlap between two cubes. It allows the user to check whether or not two cubes overlap, and also creates a MultivariateStatistics object containing the data from each cube in the overlapping area. The cubes entered into the constructor for this class must both be projections, and must have the same projection parameters.

If you would like to see OverlapStatistics being used in implementation, see equalizer.cpp

Author: 2005-07-18 Elizabeth Ribelin

History:: 2005-11-18 Elizabeth Miller - added 1e-9 to the min and max values when computing the ranges to fix rounding issue

History:: 2006-01-12 Elizabeth Miller - removed unwanted print statements

History:: 2006-03-31 Elizabeth Miller - added unitTest

History:: 2006-04-03 Elizabeth Miller - added .001 to the min and max values when computing the ranges to re-fix rounding issue

History:: 2007-08-27 Steven Koechle - removed space from standard deviation keyword

History:: 2008-06-18 Steven Koechle - fixed Documentation Errors

History:: 2009-03-12 Travis Addair - added tracking for percent processed

History:: 2009-06-24 Travis Addair - optimized statistic gathering, changed PVL print-out for readability, and added functionality to allow the user to specify a "sampling percent" when gathering statistics to save processing time

History:: 2012-04-16 Jeannie Backer - Added forward declaration for PvlObject and ordered #includes in the implementation file. Added documentation.

History:: 2016-07-15 Ian Humphrey - Modified toPvl() method to get the internal multivariate statistics. Added init() method to initialize primitive members during construction. Added new constructor that creates an OverlapStatistics object from a PvlObject. Added private fromPvl() method to implement these details. Updated unitTest to test these changes. References #2282.

Definition at line 61 of file OverlapStatistics.h.

Constructor & Destructor Documentation

◆ OverlapStatistics() [1/2]

Isis::OverlapStatistics::OverlapStatistics	(	Isis::Cube &	x,
		Isis::Cube &	y,
		QString	progressMsg = `"Gathering Overlap Statistics"`,
		double	sampPercent = `100.0`
	)

Constructs an OverlapStatistics object.

Compares the two input cubes and finds where they overlap.

Parameters

x	The first input cube
y	The second input cube
progressMsg	(Default value of "Gathering Overlap Statistics") Text for indicating progress during statistic gathering
sampPercent	(Default value of 100.0) Sampling percent, or the percentage of lines to consider during the statistic gathering procedure

Exceptions

Isis::IException::User - All images must have the same number of bands

Definition at line 51 of file OverlapStatistics.cpp.

References Isis::Progress::AddSteps(), Isis::Cube::bandCount(), Isis::Progress::CheckStatus(), Isis::Buffer::DoubleBuffer(), Isis::Cube::fileName(), Isis::Cube::lineCount(), Isis::Cube::pixelType(), Isis::Cube::projection(), Isis::Cube::read(), Isis::Cube::sampleCount(), Isis::Brick::SetBasePosition(), Isis::Progress::SetMaximumSteps(), Isis::Progress::SetText(), Isis::Projection::ToProjectionX(), Isis::Projection::ToProjectionY(), Isis::Projection::ToWorldX(), and Isis::Projection::ToWorldY().

◆ OverlapStatistics() [2/2]

Isis::OverlapStatistics::OverlapStatistics ( const PvlObject & inStats )

Constructs an OverlapStatistics from a PvlObject.

Parameters

inStats The serialized OverlapStatistics PvlObject

Definition at line 32 of file OverlapStatistics.cpp.

Member Function Documentation

◆ Bands()

int Isis::OverlapStatistics::Bands ( ) const

inline

Returns the number of bands both cubes have.

Returns: int The number of bands both cubes have

Definition at line 138 of file OverlapStatistics.h.

References p_bands.

Referenced by Isis::Equalization::fromPvl().

◆ EndLineX()

int Isis::OverlapStatistics::EndLineX ( ) const

inline

Returns the ending line position of the overlap in the first cube.

Returns: int The ending line of the overlap in the first cube

Definition at line 183 of file OverlapStatistics.h.

References p_maxLineX.

◆ EndLineY()

int Isis::OverlapStatistics::EndLineY ( ) const

inline

Returns the ending line position of the overlap in the second cube.

Returns: int The ending line of the overlap in the second cube

Definition at line 219 of file OverlapStatistics.h.

References p_maxLineY.

◆ EndSampleX()

int Isis::OverlapStatistics::EndSampleX ( ) const

inline

Returns the ending sample position of the overlap in the first cube.

Returns: int The ending sample of the overlap in the first cube

Definition at line 165 of file OverlapStatistics.h.

References p_maxSampX.

◆ EndSampleY()

int Isis::OverlapStatistics::EndSampleY ( ) const

inline

Returns the ending sample position of the overlap in the second cube.

Returns: int The ending sample of the overlap in the second cube

Definition at line 201 of file OverlapStatistics.h.

References p_maxSampY.

◆ FileNameX()

Isis::FileName Isis::OverlapStatistics::FileNameX ( ) const

inline

Returns the filename of the first cube.

Returns: QString The name of the first cube

Definition at line 87 of file OverlapStatistics.h.

References p_xFile.

Referenced by Isis::Equalization::fromPvl().

◆ FileNameY()

Isis::FileName Isis::OverlapStatistics::FileNameY ( ) const

inline

Returns the filename of the second cube.

Returns: QString The name of the second cube

Definition at line 96 of file OverlapStatistics.h.

References p_yFile.

Referenced by Isis::Equalization::fromPvl().

◆ fromPvl()

void Isis::OverlapStatistics::fromPvl ( const PvlObject & inStats )

private

Unserialize overlap statistics from a Pvl.

Parameters

const PvlObject & - The pvl object to initialize the overlap statistics with

Definition at line 295 of file OverlapStatistics.cpp.

References Isis::PvlObject::findGroup(), Isis::PvlObject::findObject(), and Isis::toString().

◆ GetMStats()

Isis::MultivariateStatistics Isis::OverlapStatistics::GetMStats ( int band ) const

inline

Returns the MultivariateStatistics object containing all the data from both cubes in the overlapping area.

Parameters

band	The band number the MultivariateStatistics object needs to contain data from

Returns: MultivariateStatistics The MultivariateStatistics object containing all data from both cubes in the overlapping area from the specified band

Definition at line 111 of file OverlapStatistics.h.

References p_stats.

Referenced by Isis::Equalization::calculateOverlapStatistics(), Isis::Equalization::fromPvl(), and IsValid().

◆ HasOverlap() [1/2]

bool Isis::OverlapStatistics::HasOverlap ( ) const

Checks all bands of the cubes for an overlap, and will only return false if none of the bands overlap.

Returns: bool Returns true if any of the bands overlap, and false if none of the bands overlap

Definition at line 175 of file OverlapStatistics.cpp.

◆ HasOverlap() [2/2]

bool Isis::OverlapStatistics::HasOverlap ( int band ) const

inline

Checks the specified band for an overlap.

Parameters

band	The band number of the cubes to be checked for an overlap

Returns: bool Returns true if the cubes overlap in the specified band, and false if they do not overlap

Definition at line 76 of file OverlapStatistics.h.

References p_stats.

Referenced by Isis::Equalization::calculateOverlapStatistics().

◆ init()

void Isis::OverlapStatistics::init ( )

private

Reset member variables to default values.

Definition at line 332 of file OverlapStatistics.cpp.

◆ IsValid()

bool Isis::OverlapStatistics::IsValid ( unsigned int band ) const

inline

Returns whether the overlap meets the minimum valid pixel requirement.

Parameters

band	The band to check

Returns: bool Is minimum requirement met

Definition at line 244 of file OverlapStatistics.h.

References GetMStats(), p_mincnt, and Isis::MultivariateStatistics::ValidPixels().

◆ Lines()

int Isis::OverlapStatistics::Lines ( ) const

inline

Returns the number of lines in the overlapping area.

Returns: int The number of lines in the overlapping area

Definition at line 120 of file OverlapStatistics.h.

References p_lineRange.

◆ Samples()

int Isis::OverlapStatistics::Samples ( ) const

inline

Returns the number of samples in the overlapping area.

Returns: int The number of samples in the overlapping area

Definition at line 129 of file OverlapStatistics.h.

References p_sampRange.

◆ SampPercent()

double Isis::OverlapStatistics::SampPercent ( ) const

inline

Returns the percentage of cube lines sampled.

Returns: int The percentage of lines sampled

Definition at line 147 of file OverlapStatistics.h.

References p_sampPercent.

◆ SetMincount()

void Isis::OverlapStatistics::SetMincount ( unsigned int mincnt )

inline

Sets the minimum number of valid pixels for the overlap to be considered valid for PVL output.

Parameters

mincnt The minimum valid pixel value to set

Definition at line 229 of file OverlapStatistics.h.

References p_mincnt.

Referenced by Isis::Equalization::calculateOverlapStatistics().

◆ StartLineX()

int Isis::OverlapStatistics::StartLineX ( ) const

inline

Returns the starting line position of the overlap in the first cube.

Returns: int The starting line of the overlap in the first cube

Definition at line 174 of file OverlapStatistics.h.

References p_minLineX.

◆ StartLineY()

int Isis::OverlapStatistics::StartLineY ( ) const

inline

Returns the starting line position of the overlap in the second cube.

Returns: int The starting line of the overlap in the second cube

Definition at line 210 of file OverlapStatistics.h.

References p_minLineY.

◆ StartSampleX()

int Isis::OverlapStatistics::StartSampleX ( ) const

inline

Returns the starting sample position of the overlap in the first cube.

Returns: int The starting sample of the overlap in the first cube

Definition at line 156 of file OverlapStatistics.h.

References p_minSampX.

◆ StartSampleY()

int Isis::OverlapStatistics::StartSampleY ( ) const

inline

Returns the starting sample position of the overlap in the second cube.

Returns: int The starting sample of the overlap in the second cube

Definition at line 192 of file OverlapStatistics.h.

References p_minSampY.

◆ toPvl()

PvlObject Isis::OverlapStatistics::toPvl ( QString name = "OverlapStatistics" ) const

Creates a Pvl containing the following Overlap Statistics information File1 File2 Width Height Bands SamplingPercent MinCount MutlivariateStatisticsN (N = current band) Covariance Correlation SumXY ValidPixels InvalidPixels TotalPixels LinearRegression ValidOverlap XStatistics #FileX Statistics information YStatistics #FileY Statistics information File1 StartSample EndSample StartLine EndLine Average StandardDeviation Variance File2 StartSample EndSample StartLine EndLine Average StandardDeviation Variance.

Serialize overlap statistics as a PvlObject.

Returns: PvlObject PvlObject containing the information for the Overlap Statistics.

Parameters

QString name (Default value of "OverlapStatistics") Name of the PvlObject created

Returns: PvlObject A pvl object representing the OverlapStatistics and its data

Exceptions

Isis::IException::User - Trivial overlap between [File1] and [File2]

Definition at line 192 of file OverlapStatistics.cpp.

References Isis::PvlObject::addGroup(), Isis::PvlObject::addObject(), Isis::PvlContainer::name(), Isis::PvlKeyword::setValue(), and Isis::toString().

Referenced by Isis::operator<<().

Member Data Documentation

◆ p_bands

int Isis::OverlapStatistics::p_bands

private

Number of bands.

Definition at line 299 of file OverlapStatistics.h.

Referenced by Bands().

◆ p_lineRange

int Isis::OverlapStatistics::p_lineRange

private

Line range of overlap.

Definition at line 304 of file OverlapStatistics.h.

Referenced by Lines().

◆ p_maxLineX

int Isis::OverlapStatistics::p_maxLineX

private

Ending Line of overlap in X cube.

Definition at line 310 of file OverlapStatistics.h.

Referenced by EndLineX().

◆ p_maxLineY

int Isis::OverlapStatistics::p_maxLineY

private

Ending Line of overlap in Y cube.

Definition at line 312 of file OverlapStatistics.h.

Referenced by EndLineY().

◆ p_maxSampX

int Isis::OverlapStatistics::p_maxSampX

private

Ending Sample of overlap in X cube.

Definition at line 306 of file OverlapStatistics.h.

Referenced by EndSampleX().

◆ p_maxSampY

int Isis::OverlapStatistics::p_maxSampY

private

Ending Sample of overlap in Y cube.

Definition at line 308 of file OverlapStatistics.h.

Referenced by EndSampleY().

◆ p_mincnt

int Isis::OverlapStatistics::p_mincnt

private

Minimum valid pixels to be valid overlap.

Definition at line 313 of file OverlapStatistics.h.

Referenced by IsValid(), and SetMincount().

◆ p_minLineX

int Isis::OverlapStatistics::p_minLineX

private

Starting Line of overlap in X cube.

Definition at line 309 of file OverlapStatistics.h.

Referenced by StartLineX().

◆ p_minLineY

int Isis::OverlapStatistics::p_minLineY

private

Starting Line of overlap in Y cube.

Definition at line 311 of file OverlapStatistics.h.

Referenced by StartLineY().

◆ p_minSampX

int Isis::OverlapStatistics::p_minSampX

private

Starting Sample of overlap in X cube.

Definition at line 305 of file OverlapStatistics.h.

Referenced by StartSampleX().

◆ p_minSampY

int Isis::OverlapStatistics::p_minSampY

private

Starting Sample of overlap in Y cube.

Definition at line 307 of file OverlapStatistics.h.

Referenced by StartSampleY().

◆ p_sampPercent

double Isis::OverlapStatistics::p_sampPercent

private

Percentage of lines sampled.

Definition at line 300 of file OverlapStatistics.h.

Referenced by SampPercent().

◆ p_sampRange

int Isis::OverlapStatistics::p_sampRange

private

Sample range of overlap.

Definition at line 303 of file OverlapStatistics.h.

Referenced by Samples().

◆ p_stats

std::vector<Isis::MultivariateStatistics> Isis::OverlapStatistics::p_stats

private

Multivariate Stats object for overlap data from both cubes.

Definition at line 316 of file OverlapStatistics.h.

Referenced by GetMStats(), and HasOverlap().

◆ p_xFile

Isis::FileName Isis::OverlapStatistics::p_xFile

private

FileName of X cube.

Definition at line 301 of file OverlapStatistics.h.

Referenced by FileNameX().

◆ p_yFile

Isis::FileName Isis::OverlapStatistics::p_yFile

private

FileName of Y cube.

Definition at line 302 of file OverlapStatistics.h.

Referenced by FileNameY().

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

src/base/objs/OverlapStatistics/OverlapStatistics.h
src/base/objs/OverlapStatistics/OverlapStatistics.cpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ OverlapStatistics() [1/2]

◆ OverlapStatistics() [2/2]

Member Function Documentation

◆ Bands()

◆ EndLineX()

◆ EndLineY()

◆ EndSampleX()

◆ EndSampleY()

◆ FileNameX()

◆ FileNameY()

◆ fromPvl()

◆ GetMStats()

◆ HasOverlap() [1/2]

◆ HasOverlap() [2/2]

◆ init()

◆ IsValid()

◆ Lines()

◆ Samples()

◆ SampPercent()

◆ SetMincount()

◆ StartLineX()

◆ StartLineY()

◆ StartSampleX()

◆ StartSampleY()

◆ toPvl()

Member Data Documentation

◆ p_bands

◆ p_lineRange

◆ p_maxLineX

◆ p_maxLineY

◆ p_maxSampX

◆ p_maxSampY

◆ p_mincnt

◆ p_minLineX

◆ p_minLineY

◆ p_minSampX

◆ p_minSampY

◆ p_sampPercent

◆ p_sampRange

◆ p_stats

◆ p_xFile

◆ p_yFile