Isis::Equalization Class Reference

This class can be used to calculate, read in, and/or apply equalization statistics for a list of files. More...

#include <Equalization.h>

Classes
class	ApplyFunctor
class	CalculateFunctor
class	ImageAdjustment
Public Member Functions
	Equalization (OverlapNormalization::SolutionType sType, QString fromListName)
virtual	~Equalization ()
void	addHolds (QString holdListName)
void	calculateStatistics (double sampPercent, int mincnt, bool wtopt, LeastSquares::SolveMethod methodType)
void	importStatistics (QString instatsFileName)
void	applyCorrection (QString toListName)
PvlGroup	getResults ()
void	write (QString outstatsFileName)
double	evaluate (double dn, int imageIndex, int bandIndex) const
Protected Member Functions
	Equalization ()
void	loadInputs (QString fromListName)
void	setInput (int index, QString value)
const FileList &	getInputs () const
virtual void	fillOutList (FileList &outList, QString toListName)
virtual void	errorCheck (QString fromListName)
void	generateOutputs (FileList &outList)
void	loadOutputs (FileList &outList, QString toListName)
void	loadHolds (OverlapNormalization *oNorm)
void	setResults (std::vector< OverlapStatistics > &overlapStats)
void	setResults ()
void	clearAdjustments ()
void	addAdjustment (ImageAdjustment *adjustment)
void	addValid (int count)
void	addInvalid (int count)

Detailed Description

This class can be used to calculate, read in, and/or apply equalization statistics for a list of files.

Calculating equalization statistics
- An optional list of images to hold may be given before calculations.
- In order to calculate statistics, the class will need to know the following:
  - percentage of lines to be used for calculations,
  - the minimum number of points in overlapping area to be used,
  - whether overlapping areas should be weighted based on number of valid pixels,
  - whether to calculate gain, offset, or both
  - which LeastSquares solve method.
- Once calculated, these statistics can be returned as a PvlGroup, written to a text file, and/or applied to the images in the input file list.
Importing equalization statistics
- Statistics may be imported from a given file name and then applied to the images in the input file list.
Applying equalization statistics
- Statistics must be calculated or imported before they can be applied to the images in the input file list.

Code example for calculating statistics, writing results to a Pvl, writing results to a file, and applying results: Equalization eq(inputCubeListFileName); // calculate eq.addHolds(holdListFileName); eq.calculateStatistics(sampPercent, mincnt, wtopt, sType, methodType); // write to PvlGroup PvlGroup resultsGroup = eq.getResults(); // write to file eq.write(outputStatisticsFileName); // apply corrections to cubes in input list eq.applyCorrection();

Code example for importing statistics and applying them. Equalization eq(listFileName); eq.importStatistics(inputStatisticsFileName); // create new output cubes from equalized cube list and apply corrections eq.applyCorrection(equalizedCubeListFileName);

This class contains the classes ImageAdjustment, CalculateFunctor, and ApplyFunctor.

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

Constructor & Destructor Documentation

Isis::Equalization::Equalization	(	OverlapNormalization::SolutionType	sType,
		QString	fromListName
	)

Parameters:

sType

An integer value corresponding to the enumerated value of the OverlapNormalization::SolutionType to be used.

References loadInputs().

Isis::Equalization::~Equalization ( ) [virtual]

References clearAdjustments().

Isis::Equalization::Equalization ( ) [protected]

Member Function Documentation

void Isis::Equalization::addAdjustment ( ImageAdjustment * adjustment ) [protected]

Referenced by Isis::HiEqualization::calculateStatistics(), calculateStatistics(), and importStatistics().

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

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

void Isis::Equalization::addInvalid ( int count ) [protected]

void Isis::Equalization::addValid ( int count ) [protected]

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

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

References Isis::Cube::bandCount(), Isis::ProcessByBrick::EndProcess(), fillOutList(), Isis::Cube::lineCount(), Isis::ProcessByLine::ProcessCube(), Isis::Process::Progress(), Isis::Cube::sampleCount(), Isis::ProcessByLine::SetInputCube(), Isis::ProcessByBrick::SetOutputCube(), Isis::Progress::SetText(), and Isis::toString().

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

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.