#include <HiEqualization.h>

Inheritance diagram for Isis::HiEqualization:

Collaboration diagram for Isis::HiEqualization:

Classes
class	HiCalculateFunctor

Public Member Functions
	HiEqualization (QString fromListName)

virtual	~HiEqualization ()

void	calculateStatistics ()

void	addHolds (QString holdListName)
	Adds a list of images to be held in the equalization.

void	calculateStatistics (double samplingPercent, int mincnt, bool wtopt, LeastSquares::SolveMethod methodType)
	Calculates the image and overlap statistics, and then determines corrective factors if possible.

void	recalculateStatistics (QString inStatsFileName)
	Recalculates statistics for any new input images.

void	importStatistics (QString instatsFileName)
	Imports statistics for applying correction.

void	applyCorrection (QString toListName)
	Equalizes the input images.

PvlGroup	getResults ()
	Returns general information about the equalization.

void	write (QString outstatsFileName)
	Write the equalization information (results) to a file.

double	evaluate (double dn, int imageIndex, int bandIndex) const

Protected Member Functions
virtual void	fillOutList (FileList &outList, QString toListName)

virtual void	errorCheck (QString fromListName)
	Checks that the input images have the same mapping groups and same number of bands.

void	loadInputs (QString fromListName)
	Loads in the input images.

void	setInput (int index, QString value)

const FileList &	getInputs () const

void	calculateBandStatistics ()
	Calculates the image statistics on a band-by-band basis.

void	calculateOverlapStatistics ()
	Calculates the overlap statistics for each pair of input images.

void	generateOutputs (FileList &outList)
	Generates the names of the equalized cubes if no output list is provided.

void	loadOutputs (FileList &outList, QString toListName)
	Checks that the output image list is correct.

void	loadHolds (OverlapNormalization *oNorm)

void	setResults ()
	Creates the results pvl containing statistics and corrective factors.

void	clearAdjustments ()
	Frees image adjustments.

void	addAdjustment (ImageAdjustment *adjustment)
	Adds an image adjustment.

void	clearNormalizations ()
	Frees overlap normalizations.

void	clearOverlapStatistics ()
	Frees overlap statistics.

void	addValid (int count)
	Increments the number of valid overlaps by a given amount.

void	addInvalid (int count)
	Increments the number of invalid overlaps by a given amount.

void	fromPvl (const PvlObject &inStats)
	Loads a previous Equalization state from an input pvl object.

void	setSolved (bool solved)
	Sets solved state indicating if OverlapNormalizations (corrective factors) were solved.

bool	isSolved () const
	Indicates if the corrective factors were solved.

Detailed Description

Author: ????-??-?? Unknown

Constructor & Destructor Documentation

◆ HiEqualization()

Isis::HiEqualization::HiEqualization ( QString fromListName )

References Isis::Equalization::loadInputs().

◆ ~HiEqualization()

Isis::HiEqualization::~HiEqualization ( )

virtual

Member Function Documentation

◆ addAdjustment()

void Isis::Equalization::addAdjustment ( ImageAdjustment * adjustment )

protectedinherited

Adds an image adjustment.

This method adds an image adjustment to be used for equalizing.

Parameters

adjustment - ImageAdjustment pointer to add.

Referenced by Isis::Equalization::calculateOverlapStatistics(), calculateStatistics(), and Isis::Equalization::importStatistics().

◆ addHolds()

void Isis::Equalization::addHolds ( QString holdListName )

inherited

Adds a list of images to be held in the equalization.

Parameters

holdListName Name of the file containing a list of images to hold.

Exceptions

IException::User	"The list of identifiers to be held must be less than or equal to the total number of identifiers."
IException::User	"The hold list file does not match a file in the from list"

References _FILEINFO_, Isis::FileList::read(), and Isis::IException::User.

◆ addInvalid()

void Isis::Equalization::addInvalid ( int count )

protectedinherited

Increments the number of invalid overlaps by a given amount.

Parameters

count An integer value to increment the internally stored number of invalid overlaps

◆ addValid()

void Isis::Equalization::addValid ( int count )

protectedinherited

Increments the number of valid overlaps by a given amount.

Parameters

count An integer value to increment the internally stored number of valid overlaps

Referenced by calculateStatistics().

◆ applyCorrection()

void Isis::Equalization::applyCorrection ( QString toListName = "" )

inherited

Equalizes the input images.

This method applies corretive factors to the input images, thereby equalizing them.

Parameters

toListName (Default value is "") List of cube names to save the equalized images as

Exceptions

IException::User "Corrective factors have not yet been determined. Fix any " "non-overlapping images and recalculate the image statistics."

References _FILEINFO_, Isis::Equalization::fillOutList(), Isis::Equalization::isSolved(), Isis::Process::Progress(), Isis::Progress::SetText(), Isis::toString(), and Isis::IException::User.

◆ calculateBandStatistics()

void Isis::Equalization::calculateBandStatistics ( )

protectedinherited

Calculates the image statistics on a band-by-band basis.

This method calculates statistics by band for the input images. Each set of band statistics is used to initialize the OverlapNormalizations that will be used to determine gains and offsets for equalization.

References Isis::Equalization::loadHolds(), and Isis::toString().

Referenced by Isis::Equalization::calculateStatistics(), and Isis::Equalization::fromPvl().

◆ calculateOverlapStatistics()

void Isis::Equalization::calculateOverlapStatistics ( )

protectedinherited

Calculates the overlap statistics for each pair of input images.

This method calculates any overlap statistics that have not been previously calculated for the input images.

References Isis::Equalization::addAdjustment(), Isis::Cube::open(), and Isis::toString().

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

◆ calculateStatistics() [1/2]

void Isis::HiEqualization::calculateStatistics ( )

References Isis::Equalization::addAdjustment(), Isis::Equalization::addValid(), Isis::OverlapNormalization::Both, Isis::Equalization::clearAdjustments(), Isis::Equalization::getInputs(), Isis::Equalization::loadHolds(), Isis::Process::Progress(), Isis::Equalization::setResults(), Isis::Equalization::setSolved(), Isis::Progress::SetText(), and Isis::toString().

◆ calculateStatistics() [2/2]

void Isis::Equalization::calculateStatistics	(	double	percent,
		int	mincnt,
		bool	wtopt,
		LeastSquares::SolveMethod	methodType )

inherited

Calculates the image and overlap statistics, and then determines corrective factors if possible.

This method calculates image statistics on a band-by-band basis and calculates overlap statistics for the input images. Overlaps are considered valid if the number of valid pixels in the overlapping area is greater than or equal to the provided mincnt parameter. Corrective factors will only be determined if all of the input images have at least one valid overlap.

Parameters

percent	Percentage of the lines to consider when gathering overall cube statistics and overlap statistics
mincnt	Minimum number of points in overlapping area required to be used in the solution
wtopt	Indicates whether overlaps should be weighted
methodType	An integer value corresponding to the enumerated value of the desired LeastSquares::SolveMethod to be used.

Exceptions

IException::User	"There are input images that do not overlap with enough valid pixels." "See application log or Nonoverlaps keyword in output statistics file"
IException::Unknown	"Calculation for equalization statistics failed. Gain = 0."
IException::Unknown	"Unable to calculate the equalization statistics. You may " "want to try another LeastSquares::SolveMethod."

References _FILEINFO_, Isis::Equalization::calculateBandStatistics(), Isis::Equalization::calculateOverlapStatistics(), Isis::Equalization::setResults(), Isis::IException::Unknown, and Isis::IException::User.

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

◆ clearAdjustments()

void Isis::Equalization::clearAdjustments ( )

protectedinherited

Frees image adjustments.

Referenced by calculateStatistics(), Isis::Equalization::importStatistics(), and Isis::Equalization::~Equalization().

◆ clearNormalizations()

void Isis::Equalization::clearNormalizations ( )

protectedinherited

Frees overlap normalizations.

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

◆ clearOverlapStatistics()

void Isis::Equalization::clearOverlapStatistics ( )

protectedinherited

Frees overlap statistics.

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

◆ errorCheck()

void Isis::HiEqualization::errorCheck ( QString fromListName )

protectedvirtual

Checks that the input images have the same mapping groups and same number of bands.

Exceptions

IException::User	"Number of bands do not match between cubes"
IException::User	"Mapping groups do not match between cubes"

Reimplemented from Isis::Equalization.

References _FILEINFO_, Isis::Equalization::getInputs(), Isis::Cube::open(), Isis::Equalization::setInput(), Isis::toString(), and Isis::IException::User.

◆ evaluate()

double Isis::Equalization::evaluate	(	double	dn,
		int	imageIndex,
		int	bandIndex ) const

inherited

◆ fillOutList()

void Isis::HiEqualization::fillOutList	(	FileList &	outList,
		QString	toListName )

protectedvirtual

Reimplemented from Isis::Equalization.

References Isis::Equalization::generateOutputs(), and Isis::Equalization::loadOutputs().

◆ fromPvl()

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

protectedinherited

Loads a previous Equalization state from an input pvl object.

This method will unserialize Equalization data from an input pvl, obtaining any previously calculated overlap statistics and corrective factors (if solved).

Parameters

const PvlObject& Input pvl object containing previous Equalization state

References Isis::Equalization::calculateBandStatistics(), and Isis::PvlObject::findObject().

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

◆ generateOutputs()

void Isis::Equalization::generateOutputs ( FileList & outList )

protectedinherited

Generates the names of the equalized cubes if no output list is provided.

Referenced by Isis::Equalization::fillOutList(), and fillOutList().

◆ getInputs()

const FileList & Isis::Equalization::getInputs ( ) const

protectedinherited

Referenced by calculateStatistics(), and errorCheck().

◆ getResults()

PvlGroup Isis::Equalization::getResults ( )

inherited

Returns general information about the equalization.

This method returns general information about the equalization, including number of valid and invalid overlaps, any non-overlapping images, the LeastSquares solution type, the type of equalization adjustmnet, and corrective factors (if solved).

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

◆ importStatistics()

void Isis::Equalization::importStatistics ( QString instatsFileName )

inherited

Imports statistics for applying correction.

This method obtains corrective factors from an input statistics pvl file so that input images can be equalized. These corrective factors are obtained from Normalization groups within the EqualizationInformation object in the input pvl.

See also: Equalization::applyCorrection()

Parameters

instatsFileName Name of the input statistics pvl file

References Isis::Equalization::addAdjustment(), Isis::Equalization::clearAdjustments(), Isis::PvlObject::findObject(), and Isis::toDouble().

◆ isSolved()

bool Isis::Equalization::isSolved ( ) const

protectedinherited

Indicates if the corrective factors were solved.

Returns: bool Returns true if corrective factors were solved

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

◆ loadHolds()

void Isis::Equalization::loadHolds ( OverlapNormalization * oNorm )

protectedinherited

Referenced by Isis::Equalization::calculateBandStatistics(), and calculateStatistics().

◆ loadInputs()

void Isis::Equalization::loadInputs ( QString fromListName )

protectedinherited

Loads in the input images.

This method loads in the input images contained in the provided file name.

Parameters

fromListName Name of the file containing the input images

Exceptions

IException::User "The input file must contain at least 2 file names"

References _FILEINFO_, Isis::Equalization::errorCheck(), Isis::Cube::open(), Isis::FileList::read(), Isis::toString(), and Isis::IException::User.

Referenced by Isis::Equalization::Equalization(), and HiEqualization().

◆ loadOutputs()

void Isis::Equalization::loadOutputs	(	FileList &	outList,
		QString	toListName )

protectedinherited

Checks that the output image list is correct.

Exceptions

IException::User	"Each input file in the FROM LIST must have a corresponding output file in the TO LIST."
IException::User	"The to list file has the same name as its corresponding from list fil."

References _FILEINFO_, Isis::toString(), and Isis::IException::User.

Referenced by Isis::Equalization::fillOutList(), and fillOutList().

◆ recalculateStatistics()

void Isis::Equalization::recalculateStatistics ( QString instatsFileName )

inherited

Recalculates statistics for any new input images.

This method loads a previous Equalization state from an input pvl file and calculates overlap statistics for any new input images. Corrective factors will also be calculated if there are no non-overlapping images and there are enough valid overlaps.

Parameters

instatsFileName Name of input pvl file containing previously calculated statistics

References Isis::Equalization::calculateStatistics(), and Isis::Equalization::fromPvl().

◆ setInput()

void Isis::Equalization::setInput	(	int	index,
		QString	value )

protectedinherited

Referenced by errorCheck().

◆ setResults()

void Isis::Equalization::setResults ( )

protectedinherited

Creates the results pvl containing statistics and corrective factors.

This method creates the results pvl containing what is essentially serialized Equalization data, which can be unserialized via the fromPvl() method. Note that the overlap statistics in the results pvl may not be ordered if recalculating statistics with a modified input image list.

References Isis::PvlObject::addObject(), Isis::OverlapNormalization::Both, Isis::OverlapNormalization::Gains, Isis::OverlapNormalization::GainsWithoutNormalization, Isis::OverlapNormalization::Offsets, Isis::Pvl::setTerminator(), and Isis::toString().

Referenced by calculateStatistics(), and Isis::Equalization::calculateStatistics().

◆ setSolved()

void Isis::Equalization::setSolved ( bool solved )

protectedinherited

Sets solved state indicating if OverlapNormalizations (corrective factors) were solved.

Parameters

bool	Indiciates if corrective factors were solved

Referenced by calculateStatistics().

◆ write()

void Isis::Equalization::write ( QString outstatsFileName )

inherited

Write the equalization information (results) to a file.

Parameters

outstatsFileName The name of the file to write the results to

References Isis::Pvl::write().

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

/Users/chkim/repos/ISIS3/isis/src/mro/objs/HiEqualization/HiEqualization.h
/Users/chkim/repos/ISIS3/isis/src/mro/objs/HiEqualization/HiEqualization.cpp

Classes

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ HiEqualization()

◆ ~HiEqualization()

Member Function Documentation

◆ addAdjustment()

◆ addHolds()

◆ addInvalid()

◆ addValid()

◆ applyCorrection()

◆ calculateBandStatistics()

◆ calculateOverlapStatistics()

◆ calculateStatistics() [1/2]

◆ calculateStatistics() [2/2]

◆ clearAdjustments()

◆ clearNormalizations()

◆ clearOverlapStatistics()

◆ errorCheck()

◆ evaluate()

◆ fillOutList()

◆ fromPvl()

◆ generateOutputs()

◆ getInputs()

◆ getResults()

◆ importStatistics()

◆ isSolved()

◆ loadHolds()

◆ loadInputs()

◆ loadOutputs()

◆ recalculateStatistics()

◆ setInput()

◆ setResults()

◆ setSolved()

◆ write()