Mosaic two cubs together. More...

#include <ProcessMapMosaic.h>

Inheritance diagram for Isis::ProcessMapMosaic:

Collaboration diagram for Isis::ProcessMapMosaic:

Public Types
enum	ImageOverlay { PlaceImagesOnTop, PlaceImagesBeneath, UseBandPlacementCriteria, AverageImageWithMosaic, NumImageOverlayOptions }
	Enumeration for different Mosaic priorities (input, mosaic, band) More...

Public Member Functions
	ProcessMapMosaic ()
	Constructs a Mosaic object. More...

virtual	~ProcessMapMosaic ()
	Destructor. More...

virtual Isis::Cube *	SetOutputCube (FileList &propagationCubes, CubeAttributeOutput &oAtt, const QString &mosaicFile)
	Set the output cube to specified file name and specified input images and output attributes. More...

Isis::Cube *	RingsSetOutputCube (FileList &propagationCubes, CubeAttributeOutput &oAtt, const QString &mosaicFile)
	Set the output cube to specified file name and specified input images and output attributes. More...

virtual Isis::Cube *	SetOutputCube (FileList &propagationCubes, double slat, double elat, double slon, double elon, CubeAttributeOutput &oAtt, const QString &mosaicFile)
	Set the output cube to specified file name and specified input images and output attributes and lat,lons. More...

Isis::Cube *	RingsSetOutputCube (FileList &propagationCubes, double srad, double erad, double saz, double eaz, CubeAttributeOutput &oAtt, const QString &mosaicFile)
	Set the output cube to specified file name using the specified input images, output attributes, ring radii values and ring longitude values. More...

virtual Isis::Cube *	SetOutputCube (const QString &inputFile, double xmin, double xmax, double ymin, double ymax, double slat, double elat, double slon, double elon, int nbands, CubeAttributeOutput &oAtt, const QString &mosaicFile, bool latlonflag=true)
	Set the output cube to specified file name and specified input images and output attributes and lat,lons. More...

Isis::Cube *	RingsSetOutputCube (const QString &inputFile, double xmin, double xmax, double ymin, double ymax, double srad, double erad, double saz, double eaz, int nbands, CubeAttributeOutput &oAtt, const QString &mosaicFile)
	Set the output cube to specified file name using the specified input file name, output attributes, ring radii values and ring longitude values. More...

virtual Isis::Cube *	SetOutputCube (const QString &inputFile, PvlGroup mapping, CubeAttributeOutput &oAtt, const QString &mosaicFile)
	Set the output cube to specified file name and specified input images and output attributes and lat,lons. More...

Isis::Cube *	RingsSetOutputCube (const QString &inputFile, PvlGroup mapping, CubeAttributeOutput &oAtt, const QString &mosaicFile)
	Set the output cube to specified file name and specified input images and output attributes and lat,lons. More...

Isis::Cube *	SetOutputCube (const QString &mosaicFile)
	Mosaic output method for Mosaic Processing Method, this will use an existing mosaic. More...

Isis::Cube *	RingsSetOutputCube (const QString &mosaicFile)
	Mosaic output method for Mosaic Processing Method, this will use an existing mosaic. More...

virtual Isis::Cube *	SetInputCube ()
	Input cube cannot be set here. More...

virtual bool	StartProcess (QString inputFile)
	Mosaic Processing method, returns false if the cube is not inside the mosaic. More...

virtual void	StartProcess (const int &piOutSample, const int &piOutLine, const int &piOutBand)
	This method invokes the process by mosaic operation over a single input cube and single output cube. More...

virtual void	StartProcess (void funct())
	In the base class, this method will invoked a user-specified function exactly one time. More...

virtual void	EndProcess ()
	Cleans up by closing input, output and tracking cubes. More...

PvlObject	imagePositions ()
	Accessor for the placed images and their locations. More...

virtual Isis::Cube *	SetInputCube (const QString &parameter, const int ss, const int sl, const int sb, const int ns, const int nl, const int nb)
	Opens an input cube specified by the user. More...

virtual Isis::Cube *	SetInputCube (const QString &fname, Isis::CubeAttributeInput &att, const int ss=1, const int sl=1, const int sb=1, const int ns=-1, const int nl=-1, const int nb=-1)
	Opens an input cube specified by the user. More...

virtual Isis::Cube *	SetInputCube (const QString &parameter, const int requirements=0)
	Opens an input cube specified by the user and verifies requirements are met. More...

virtual Isis::Cube *	SetInputCube (const QString &fname, const Isis::CubeAttributeInput &att, int requirements=0)
	Opens an input cube specified by the programmer and verifies requirements are met. More...

virtual void	SetInputCube (Isis::Cube *inCube, int requirements=0)
	Set the InputCube vector to an opened Cube which was dynamically allocated. More...

Isis::Cube *	SetOutputCube (const QString &psParameter, UserInterface &ui)

virtual Isis::Cube *	SetOutputCube (const QString &parameter, const int nsamps, const int nlines, const int nbands=1)
	Allocates a user specified output cube whose size is specified by the programmer. More...

virtual Isis::Cube *	SetOutputCube (const QString &fname, const Isis::CubeAttributeOutput &att, const int nsamps, const int nlines, const int nbands=1)
	Allocates a output cube whose name and size is specified by the programmer. More...

void	SetBandBinMatch (bool enforceBandBinMatch)

void	SetBandKeyword (QString bandPriorityKeyName, QString bandPriorityKeyValue)
	Set the keyword/value to use for comparing when using band priority. More...

void	SetBandNumber (int bandPriorityBandNumber)
	Set the band to use for priorities when using band priority. More...

void	SetBandUseMaxValue (bool useMax)
	Set whether to take the image with the max or min value when using band priority. More...

void	SetCreateFlag (bool createOutputMosaic)
	Flag to indicate that the mosaic is being newly created Indication that the new label specific to the mosaic needs to be created. More...

void	SetHighSaturationFlag (bool placeHighSatPixels)
	When true, high saturation (HRS, HIS) will be considered valid data for the purposes of placing pixels in the output mosaic. More...

void	SetImageOverlay (ImageOverlay placement)

void	SetLowSaturationFlag (bool placeLowSatPixels)
	When true, low saturation (LRS, LIS) will be considered valid data for the purposes of placing pixels in the output mosaic. More...

void	SetMatchDEM (bool matchDEM)
	Set the DEM match flag. More...

void	SetNullFlag (bool placeNullPixels)
	When true, Null pixels will be considered valid data for the purposes of placing pixels in the output mosaic. More...

void	SetTrackFlag (bool trackingEnabled)

bool	GetHighSaturationFlag () const

ImageOverlay	GetImageOverlay () const

bool	GetLowSaturationFlag () const

bool	GetNullFlag () const

bool	GetTrackFlag () const

int	GetInputStartLineInMosaic () const
	This is the line where the image was placed into the output mosaic. More...

int	GetInputStartSampleInMosaic () const
	This is the sample where the image was placed into the output mosaic. More...

int	GetInputStartBandInMosaic () const
	This is the band where the image was placed into the output mosaic. More...

virtual void	Finalize ()
	Cleans up by closing cubes and freeing memory for owned cubes. More...

virtual Isis::Cube *	SetOutputCubeStretch (const QString &parameter, UserInterface *ui=nullptr)
	Allocates a user-specified output cube whose size matches the first input cube. More...

virtual Isis::Cube *	SetOutputCubeStretch (const QString &parameter, const int nsamps, const int nlines, const int nbands=1, UserInterface *ui=nullptr)
	Allocates a user specified output cube whose size is specified by the programmer. More...

void	AddInputCube (Cube *cube, bool owned=true)

void	AddOutputCube (Cube *cube, bool owned=true)

void	CheckRequirements (const Cube *cube, const int requirements)
	Checks to make sure the input cube meets the inputted requirements. More...

void	ClearCubes ()
	Close owned cubes from the list and clear the list. More...

void	ClearInputCubes ()
	Close owned input cubes from the list and clear the list. More...

void	ClearOutputCubes ()
	Close owned output cubes from the list and clear the list. More...

void	PropagateLabels (const bool prop)
	This method allows the programmer to turn on/off the propagation of labels from the 1st input cube to any of the output cubes. More...

void	PropagateLabels (const QString &cube)
	This method allows the programmer to propagate labels from a specific secondary cube. More...

void	PropagateTables (const bool prop)
	This method allows the programmer to propagate input tables to the output cube (default is true) More...

void	PropagateTables (const QString &fromName, const QList< QString > &tableNames=QList< QString >())
	Propagate the tables from the cube with the given filename to the output cube. More...

void	PropagatePolygons (const bool prop)
	This method allows the programmer to propagate input blobs to the output cube (default is true) More...

void	PropagateHistory (const bool prop)
	This method allows the programmer to propagate history to the output cube (default is true) More...

void	PropagateOriginalLabel (const bool prop)
	This method allows the programmer to propagate original labels to the output cube (default is true) More...

Isis::Progress *	Progress ()
	This method returns a pointer to a Progress object. More...

QString	MissionData (const QString &mission, const QString &file, bool highestVersion=false)
	This method reads the mission specific data directory from the user preference file, makes sure that mission is available in the Isis installation, and the attaches the provided input file to the directory in order to create a full file specification. More...

void	WriteHistory (Cube &cube)
	Writes out the History blob to the cube. More...

void	CalculateStatistics ()
	Calculates and stores off statistics on every band of every cube added to this process via the SetInputCube method. More...

std::vector< Isis::Statistics * >	BandStatistics (const unsigned index)
	Get the vector of Statistics objects for each band separately of a specified input cube. More...

Isis::Statistics *	CubeStatistics (const unsigned index)
	Get the Statistics object for all bands of a specified input cube. More...

Static Public Member Functions
static QString	OverlayToString (ImageOverlay)
	Convert an ImageOverlay to a QString. More...

static ImageOverlay	StringToOverlay (QString)
	Convert a QString to an ImageOverlay (case-insensitive). More...

Static Public Attributes
static const char *	TRACKING_TABLE_NAME = "InputImages"
	This is the name of the table in the Cube which will contain the image file names. More...

static const int	FLOAT_STORE_INT_PRECISELY_MAX_VALUE = 16777216

static const int	FLOAT_STORE_INT_PRECISELY_MIN_VALUE = -16777215

Protected Attributes
Isis::Progress *	p_progress
	Pointer to a Progress object. More...

bool	p_propagateLabels
	Flag indicating if labels are be propagated to output cubes. More...

bool	p_propagateTables
	Flag indicating if tables are be propagated to output cubes. More...

bool	p_propagatePolygons
	Flag indicating if blobs are be propagated to output cubes. More...

bool	p_propagateHistory
	Flag indicating if history is to be propagated to output cubes. More...

bool	p_propagateOriginalLabel
	Flag indicating if original lable is to be propagated to output cubes. More...

std::vector< std::vector< Isis::Statistics * > >	p_bandStats
	Holds the calculated statistics for each band separately of every input cubei after the CalculateStatistics method is called. More...

std::vector< Isis::Statistics * >	p_cubeStats
	Holds the calculated statistics for every band together of every input cubei after the CalculateStatistics method is called. More...

std::vector< Isis::Cube * >	InputCubes
	A vector of pointers to opened Cube objects. More...

std::vector< Isis::Cube * >	OutputCubes
	A vector of pointers to allocated Cube objects. More...

QSet< Isis::Cube * > *	m_ownedCubes
	A list of cubes owned by this instant. More...

Private Member Functions
void	BandComparison (int iss, int isl, int ins, int inl, int bandPriorityInputBandNumber, int bandPriorityOutputBandNumber, int index)
	This method compares the specified band of the input and output using the criteria (lesser or greater) to assign the pixel origin(input fileindex) to the origin band. More...

void	BandPriorityWithNoTracking (int iss, int isl, int isb, int ins, int inl, int inb, int bandPriorityInputBandNumber, int bandPriorityOutputBandNumber)
	Mosaicking for Band Priority with no Tracking. More...

int	GetOriginDefaultByPixelType ()
	This method returns the defaults(unassigned origin value) depending on the pixel type. More...

int	GetBandIndex (bool inputFile)
	Get the Band Index in an image of type (input/output) More...

bool	GetTrackStatus ()
	This method searchs the mosaic label for a table with name "InputFile". More...

void	AddBandBinGroup (int origIsb)
	This method adds the BandBin group to the mosaic corresponding to the actual bands in the mosaic. More...

void	AddDefaultBandBinGroup ()
	AddDefaultBandBinGroup. More...

void	MatchBandBinGroup (int origIsb, int &inb)
	This method matches the input BandBin group to the mosaic BandBin Group and allows band to be replaced in mosaic if it is NA (not assigned). More...

bool	ProcessAveragePriority (int piPixel, Portal &pInPortal, Portal &pOutPortal, Portal &pOrigPortal)
	Calculate DN value for a pixel for AverageImageWithMosaic priority and set the Count band portal. More...

void	ResetCountBands ()
	Reset all the count bands to default at the time of mosaic creation. More...

void	MatchDEMShapeModel ()
	Match the Shape Model for input and mosaic. More...

Static Private Member Functions
static void	FillNull (Buffer &data)
	Reset the buffer with NULL pixels. More...

Private Attributes
bool	p_createMosaic
	Internal use; SetOutputMosaic (const QString &) sets to false to not attempt creation when using SetOutputMosaic. More...

bool	m_trackingEnabled

Cube *	m_trackingCube
	Output tracking cube. NULL unless tracking is enabled. More...

bool	m_createOutputMosaic

int	m_bandPriorityBandNumber

QString	m_bandPriorityKeyName

QString	m_bandPriorityKeyValue

bool	m_bandPriorityUseMaxValue

int	m_iss
	The starting sample within the input cube. More...

int	m_isl
	The starting line within the input cube. More...

int	m_isb
	The starting band within the input cube. More...

int	m_ins
	The number of samples from the input cube. More...

int	m_inl
	The number of lines from the input cube. More...

int	m_inb
	The number of bands from the input cube. More...

int	m_oss
	The starting sample within the output cube. More...

int	m_osl
	The starting line within the output cube. More...

int	m_osb
	The starting band within the output cube. More...

int	m_onb
	The number of bands in the output cube. More...

bool	m_enforceBandBinMatch
	True/False value to determine whether to enforce the input cube bandbin matches the mosaic bandbin group. More...

bool	m_enforceMatchDEM
	DEM of the input and mosaic should match. More...

ImageOverlay	m_imageOverlay

PvlObject	m_imagePositions
	List of images placed on the mosaic. More...

bool	m_placeHighSatPixels

bool	m_placeLowSatPixels

bool	m_placeNullPixels

Detailed Description

Mosaic two cubs together.

This class allows a programmer to develop a program which merges two cubes together. The application sets the position where input (child) cube will be placed in the mosaic (parent) cube and priority. The the Mosaic object will merge the overlapping area.

Author: 2003-04-28 Stuart Sides

History:: 2003-04-28 Stuart Sides - Modified unitTest.cpp to do a better test

History:: 2003-09-04 Jeff Anderson - Added SetInputWorkCube method

History:: 2005-02-11 Elizabeth Ribelin - Modified file to support Doxygen documentation

History:: 2006-09-01 Elizabeth Miller - Added BandBinMatch option to propagate the bandbin group to the mosaic and make sure the input cube bandbin groups match the mosaics bandbin group

History:: 2006-10-20 Stuart Sides - Fixed bug BandBin group did not get copied to the output mosaic.

History:: 2008-10-03 Steven Lambright - Fixed problem where return values from SetUniversalGround were not checked

History:: 2008-11-18 Christopher Austin - Added the first cube's history to the mosaic's history along with the history object of the application which did the mosaic.

History:: 2008-12-08 Steven Lambright - Fixed one of the SetOutputCube(...) methods, a lat/lon range was specified but CreateFromCube was still being used (needed CreateFromCube because no cubes existed with the correct range).

History:: 2008-12-08 Steven Lambright - MinimumLatitude,MaximumLatitude, MinimumLongitude,MaximumLongitude keywords no longer required to exist if passed into SetOutputCube

History:: 2010-10-27 Sharmila Prasad - Read input file attributes

History:: 2011-01-18 Sharmila Prasad - Added "Average" priority feature, to double the number of mosaic bands to get Count info

History:: 2011-06-28 Jai Rideout and Steven Lambright - Now uses a different caching algorithm.

History:: 2011-09-08 Sharmila Prasad - Fixed Bug #406, Additional boundary checks similar to ProcessMosaic so that there will be no interruption for applications like automos

History:: 2012-10-05 Jeannie Backer - Fixed indentation of history entries. Added caught exception to new thrown exception. Moved method implementation to cpp. References #1169.

History:: 2013-03-27 Jeannie Backer - Added programmer comments. References #1248.

History:: 2012-01-20 Debbie A. Cook - Changed to use TProjection instead of Projection. References #775.

History:: 2013-11-14 Kimberly Oyama - Modified StartProcess() to account for a negative x or y from the projection. These x and y values are used to calculate the outline and outsample. Fixes #1736.

History:: 2013-12-27 Janet Barrett - Added additional latlonflag parameter to the SetOutputCube method so that valid lat/lon values are checked for in the input files that make up a mosaic. This change was needed to handle input files that are missing the min/max lat/lon keywords (such as those that were cropped). Fixes #1500.

History:: 2015-01-15 Sasha Brownsberger - Added virtual keyword to several functions to ensure successful inheritance between Process and its child classes. Made destructor virtual. References #2215.

Todo:: 2005-02-11 Stuart Sides - add coded example and implementation example to class documentation

History:: 2016-08-28 Kelvin Rodriguez - Changed SetOutputCube default parameters to avoid hidden virtual function warnings in clang and the abiguous called errors. Part of porting to OS X 10.11.

History:: 2018-08-13 Summer Stapleton - Removed code that added tracking band to mosaic cube as tracking is now being stored in a separate tracking cube. This was part of a larger refactoring project to turn the tracking band of a mosaic cube into its own tracking cube containing the InputImages table to relate DN values to input images. Mosaic cube no longer holds tracking band or InputImages table, but instead has a Tracking group that points to external tracking cube.

Definition at line 97 of file ProcessMapMosaic.h.

Member Enumeration Documentation

◆ ImageOverlay

enum Isis::ProcessMosaic::ImageOverlay

inherited

Enumeration for different Mosaic priorities (input, mosaic, band)

Enumerator
PlaceImagesOnTop	ontop priority
PlaceImagesBeneath	beneath priority
UseBandPlacementCriteria	band priority
AverageImageWithMosaic	average priority

Definition at line 207 of file ProcessMosaic.h.

Constructor & Destructor Documentation

◆ ProcessMapMosaic()

Isis::ProcessMapMosaic::ProcessMapMosaic ( )

Constructs a Mosaic object.

Definition at line 29 of file ProcessMapMosaic.cpp.

◆ ~ProcessMapMosaic()

Isis::ProcessMapMosaic::~ProcessMapMosaic ( )

virtual

Destructor.

Definition at line 35 of file ProcessMapMosaic.cpp.

Member Function Documentation

◆ AddBandBinGroup()

void Isis::ProcessMosaic::AddBandBinGroup ( int origIsb )

privateinherited

This method adds the BandBin group to the mosaic corresponding to the actual bands in the mosaic.

returns None

Author: Sharmila Prasad (9/24/2009)

History:: 2011-01-12 Sharmila Prasad Added logic for Count Bands for AverageImageWithMosaic Priority

Definition at line 1147 of file ProcessMosaic.cpp.

References Isis::PvlObject::findGroup(), Isis::PvlObject::findObject(), Isis::PvlContainer::keywords(), Isis::PvlKeyword::name(), Isis::PvlKeyword::setUnits(), Isis::PvlKeyword::size(), and Isis::PvlKeyword::unit().

◆ AddDefaultBandBinGroup()

void Isis::ProcessMosaic::AddDefaultBandBinGroup ( )

privateinherited

AddDefaultBandBinGroup.

This method adds a default BandBin group on Mosaic creation if the MatchBandBin Group is set to false and Tracking to set to true

Return void

Definition at line 1232 of file ProcessMosaic.cpp.

References Isis::PvlObject::findObject().

◆ BandComparison()

void Isis::ProcessMosaic::BandComparison	(	int	iss,
		int	isl,
		int	ins,
		int	inl,
		int	bandPriorityInputBandNumber,
		int	bandPriorityOutputBandNumber,
		int	index
	)

privateinherited

This method compares the specified band of the input and output using the criteria (lesser or greater) to assign the pixel origin(input fileindex) to the origin band.

In the StartProcess(), input pixel is assigned to the output if the origin pixel equals the current input file index

Parameters

iss	- Comparison start sample
isl	- Comparison start line
ins	- The number of samples to compare
inl	- The number of lines to compare
bandPriorityInputBandNumber	- The band in the input cube to use for comparison
bandPriorityOutputBandNumber	- The band in the output cube to use for comparison
index	- Tracking index for the input cube

Author: Sharmila Prasad (9/04/2009)

Definition at line 1335 of file ProcessMosaic.cpp.

References Isis::IsHighPixel(), Isis::IsLowPixel(), Isis::IsNullPixel(), Isis::IsSpecial(), Isis::IsValidPixel(), Isis::Portal::SetPosition(), and Isis::Buffer::size().

◆ BandPriorityWithNoTracking()

void Isis::ProcessMosaic::BandPriorityWithNoTracking	(	int	iss,
		int	isl,
		int	isb,
		int	ins,
		int	inl,
		int	inb,
		int	bandPriorityInputBandNumber,
		int	bandPriorityOutputBandNumber
	)

privateinherited

Mosaicking for Band Priority with no Tracking.

Author: Sharmila Prasad (1/4/2012)

Definition at line 1381 of file ProcessMosaic.cpp.

References Isis::IsHighPixel(), Isis::IsLowPixel(), Isis::IsNullPixel(), Isis::IsValidPixel(), and Isis::Portal::SetPosition().

◆ BandStatistics()

std::vector<Isis::Statistics *> Isis::Process::BandStatistics ( const unsigned index )

inlineinherited

Get the vector of Statistics objects for each band separately of a specified input cube.

Parameters

index The index of the input cube in InputCubes

Returns: vector<Statistics*> A list of statistics ordered by band

Definition at line 279 of file Process.h.

References Isis::Process::p_bandStats.

◆ CalculateStatistics()

void Isis::Process::CalculateStatistics ( )

inherited

Calculates and stores off statistics on every band of every cube added to this process via the SetInputCube method.

The newly calculated statistics are stored in two ways: as a vector where each entry is a single Statistics object for every band of a particular input cube, and as a vector where each entry is a vector of Statistics objects, for each band separately, of a particular input cube.

Definition at line 824 of file Process.cpp.

References Isis::Statistics::AddData(), Isis::Cube::bandCount(), Isis::Progress::CheckStatus(), Isis::Buffer::DoubleBuffer(), Isis::Cube::lineCount(), Isis::Cube::read(), Isis::LineManager::SetLine(), Isis::Progress::SetMaximumSteps(), Isis::Progress::SetText(), Isis::Buffer::size(), and Isis::toString().

◆ CheckRequirements()

void Isis::Process::CheckRequirements	(	const Cube *	cube,
		const int	requirements
	)

inherited

Checks to make sure the input cube meets the inputted requirements.

Parameters

cube Cube to check

requirements Use to specify requirements for the input file. The following requirments are checked against 1) ic_base::SizeMatch checks to make sure the input cube has the same bands, samples, and lines as the first input cube open using this method, 2) ic_base::SpatialMatch checks to make sure the input cube has the same samples and lines as the first input cube, 3) ic_base::Georeferenced checks to make sure latitude/longitudes can be obtained from the input cube, 4) ic_base::FullyGeoreferenced checks to make sure latitude/longitude, phase/incidence/emission, and other geometric parameters can be obtained from the input cube, 5) ic_base::OneBand checks to make sure the input cube has exactly one band. Note, that these requirements can be logically or'ed. For example, ic_base::SpatialMatch | ic_base::georeferenced. Defaults to 0

Exceptions

Isis::iException::Message

Definition at line 503 of file Process.cpp.

References Isis::Cube::bandCount(), Isis::Cube::fileName(), Isis::Cube::lineCount(), and Isis::Cube::sampleCount().

◆ ClearCubes()

void Isis::Process::ClearCubes ( )

inherited

Close owned cubes from the list and clear the list.

Definition at line 593 of file Process.cpp.

◆ ClearInputCubes()

void Isis::Process::ClearInputCubes ( )

inherited

Close owned input cubes from the list and clear the list.

Definition at line 603 of file Process.cpp.

Referenced by RingsSetOutputCube(), Isis::FileTool::saveAsReducedCube(), and SetOutputCube().

◆ ClearOutputCubes()

void Isis::Process::ClearOutputCubes ( )

inherited

Close owned output cubes from the list and clear the list.

Definition at line 617 of file Process.cpp.

◆ CubeStatistics()

Isis::Statistics* Isis::Process::CubeStatistics ( const unsigned index )

inlineinherited

Get the Statistics object for all bands of a specified input cube.

Parameters

index The index of the input cube in InputCubes

Returns: Statistics* Collections of statistics gathered on all bands

Definition at line 293 of file Process.h.

References Isis::Process::p_cubeStats.

◆ EndProcess()

void Isis::ProcessMosaic::EndProcess ( )

virtualinherited

Cleans up by closing input, output and tracking cubes.

Reimplemented from Isis::Process.

Definition at line 517 of file ProcessMosaic.cpp.

◆ FillNull()

void Isis::ProcessMapMosaic::FillNull ( Buffer & data )

staticprivate

Reset the buffer with NULL pixels.

Definition at line 825 of file ProcessMapMosaic.cpp.

References Isis::Null, and Isis::Buffer::size().

◆ Finalize()

void Isis::Process::Finalize ( )

virtualinherited

Cleans up by closing cubes and freeing memory for owned cubes.

Clears the lists for all cubes.

Reimplemented in Isis::ProcessPolygons, Isis::ProcessImportPds, Isis::ProcessGroundPolygons, Isis::ProcessByTile, Isis::ProcessByBrick, and Isis::ProcessByBoxcar.

Definition at line 463 of file Process.cpp.

Referenced by Isis::ProcessByBoxcar::Finalize().

◆ GetBandIndex()

int Isis::ProcessMosaic::GetBandIndex ( bool inputFile )

privateinherited

Get the Band Index in an image of type (input/output)

Definition at line 1272 of file ProcessMosaic.cpp.

References Isis::PvlObject::findGroup(), and Isis::PvlKeyword::size().

◆ GetHighSaturationFlag()

bool Isis::ProcessMosaic::GetHighSaturationFlag ( ) const

inherited

See also: SetHighSaturationFlag()

Definition at line 824 of file ProcessMosaic.cpp.

◆ GetInputStartBandInMosaic()

int Isis::ProcessMosaic::GetInputStartBandInMosaic ( ) const

inherited

This is the band where the image was placed into the output mosaic.

Definition at line 880 of file ProcessMosaic.cpp.

◆ GetInputStartLineInMosaic()

int Isis::ProcessMosaic::GetInputStartLineInMosaic ( ) const

inherited

This is the line where the image was placed into the output mosaic.

Definition at line 864 of file ProcessMosaic.cpp.

◆ GetInputStartSampleInMosaic()

int Isis::ProcessMosaic::GetInputStartSampleInMosaic ( ) const

inherited

This is the sample where the image was placed into the output mosaic.

Definition at line 872 of file ProcessMosaic.cpp.

◆ GetLowSaturationFlag()

bool Isis::ProcessMosaic::GetLowSaturationFlag ( ) const

inherited

See also: SetLowSaturationFlag()

Definition at line 840 of file ProcessMosaic.cpp.

◆ GetNullFlag()

bool Isis::ProcessMosaic::GetNullFlag ( ) const

inherited

See also: SetNullFlag()

Definition at line 848 of file ProcessMosaic.cpp.

◆ GetOriginDefaultByPixelType()

int Isis::ProcessMosaic::GetOriginDefaultByPixelType ( )

privateinherited

This method returns the defaults(unassigned origin value) depending on the pixel type.

@No parameters

Returns: default value

Exceptions

IException::Message

Author: Sharmila Prasad (9/10/2009)

Definition at line 1473 of file ProcessMosaic.cpp.

References Isis::SizeOf().

◆ GetTrackFlag()

bool Isis::ProcessMosaic::GetTrackFlag ( ) const

inherited

See also: SetTrackFlag()

Definition at line 856 of file ProcessMosaic.cpp.

◆ GetTrackStatus()

bool Isis::ProcessMosaic::GetTrackStatus ( )

privateinherited

This method searchs the mosaic label for a table with name "InputFile".

If found return true else false. Checks for the existence of the origin table

Returns: the table index of the current image

Author: Sharmila Prasad (9/22/2009)

Definition at line 1507 of file ProcessMosaic.cpp.

References Isis::PvlObject::hasGroup().

◆ imagePositions()

PvlObject Isis::ProcessMosaic::imagePositions ( )

inherited

Accessor for the placed images and their locations.

Returns: The list of placed images

Definition at line 532 of file ProcessMosaic.cpp.

◆ MatchBandBinGroup()

void Isis::ProcessMosaic::MatchBandBinGroup	(	int	origIsb,
		int &	inb
	)

privateinherited

This method matches the input BandBin group to the mosaic BandBin Group and allows band to be replaced in mosaic if it is NA (not assigned).

It expects the bands to be contiguous

returns None

Exceptions

IException::Message

Author: Sharmila Prasad (9/25/2009)

Definition at line 1076 of file ProcessMosaic.cpp.

References Isis::PvlContainer::fileName(), Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), Isis::PvlContainer::keywords(), Isis::PvlContainer::name(), Isis::PvlKeyword::name(), and Isis::PvlKeyword::size().

◆ MatchDEMShapeModel()

void Isis::ProcessMosaic::MatchDEMShapeModel ( )

privateinherited

Match the Shape Model for input and mosaic.

If creating the mosaic, copy the input ShapeModel from the input label. Store only the file name of the Shape Model

Author: Sharmila Prasad (1/24/2011)

Definition at line 948 of file ProcessMosaic.cpp.

References Isis::PvlContainer::findKeyword(), Isis::PvlObject::findObject(), and Isis::PvlContainer::hasKeyword().

◆ MissionData()

QString Isis::Process::MissionData	(	const QString &	mission,
		const QString &	file,
		bool	highestVersion = `false`
	)

inherited

This method reads the mission specific data directory from the user preference file, makes sure that mission is available in the Isis installation, and the attaches the provided input file to the directory in order to create a full file specification.

Parameters

mission	Name of the mission data directory
file	Name of the file to attach to the end of the directory
highestVersion	If set to true the method will return the highest version number of the given file. Therefore, file must contain question marks such as "file???.dat". See the FileName class for more information on versioned files. Defaults to false.

Definition at line 768 of file Process.cpp.

References Isis::FileName::expanded(), Isis::FileName::fileExists(), Isis::PvlObject::findGroup(), and Isis::FileName::highestVersion().

◆ OverlayToString()

QString Isis::ProcessMosaic::OverlayToString ( ImageOverlay imageOverlay )

staticinherited

Convert an ImageOverlay to a QString.

This is used to translate between mapmos, handmos, and automos' interfaces into an ImageOverlay.

Definition at line 889 of file ProcessMosaic.cpp.

References Isis::toString().

◆ ProcessAveragePriority()

bool Isis::ProcessMosaic::ProcessAveragePriority	(	int	piPixel,
		Portal &	piPortal,
		Portal &	poPortal,
		Portal &	countPortal
	)

privateinherited

Calculate DN value for a pixel for AverageImageWithMosaic priority and set the Count band portal.

Author: Sharmila Prasad (1/13/2011)

Parameters

piPixel	- Pixel index
piPortal	- Input Portal
poPortal	- Output Portal
countPortal	- Count Portal

Returns: bool

Definition at line 1034 of file ProcessMosaic.cpp.

References Isis::IsHighPixel(), Isis::IsLowPixel(), Isis::IsNullPixel(), Isis::IsSpecial(), and Isis::IsValidPixel().

◆ Progress()

Isis::Progress* Isis::Process::Progress ( )

inlineinherited

This method returns a pointer to a Progress object.

Returns: Progress*

Definition at line 259 of file Process.h.

References Isis::Process::p_progress.

Referenced by Isis::Equalization::applyCorrection(), Isis::Equalization::calculateBandStatistics(), RingsSetOutputCube(), SetOutputCube(), and Isis::SpectralDefinition2D::SpectralDefinition2D().

◆ PropagateHistory()

void Isis::Process::PropagateHistory ( const bool prop )

inherited

This method allows the programmer to propagate history to the output cube (default is true)

Parameters

prop	Flag indicating if history is to be propagated to output cubes.

Definition at line 737 of file Process.cpp.

Referenced by RingsSetOutputCube(), and SetOutputCube().

◆ PropagateLabels() [1/2]

void Isis::Process::PropagateLabels ( const bool prop )

inherited

This method allows the programmer to turn on/off the propagation of labels from the 1st input cube to any of the output cubes.

By default, propagation occurs automatically in the Process class when a call to either of the SetOutputCube methods is invoked. If the program * requires no propagation then utilize this method. This method can be invoked between successive calls of SetOutputCube so that some cube will have labels propagated while others will not.

Parameters

prop	Flag indicating if labels are be propagated to output cubes.

Definition at line 639 of file Process.cpp.

Referenced by RingsSetOutputCube(), and SetOutputCube().

◆ PropagateLabels() [2/2]

void Isis::Process::PropagateLabels ( const QString & cube )

inherited

This method allows the programmer to propagate labels from a specific secondary cube.

Parameters

cube	IString containing the name of the cube containing the labels to propagate.

Definition at line 650 of file Process.cpp.

References Isis::PvlObject::addGroup(), Isis::PvlObject::addObject(), Isis::PvlObject::findObject(), Isis::PvlObject::group(), Isis::PvlObject::groups(), and Isis::PvlObject::hasObject().

◆ PropagateOriginalLabel()

void Isis::Process::PropagateOriginalLabel ( const bool prop )

inherited

This method allows the programmer to propagate original labels to the output cube (default is true)

Parameters

prop	Flag indicating if original labels is to be propagated to output cubes.

Definition at line 748 of file Process.cpp.

Referenced by RingsSetOutputCube(), and SetOutputCube().

◆ PropagatePolygons()

void Isis::Process::PropagatePolygons ( const bool prop )

inherited

This method allows the programmer to propagate input blobs to the output cube (default is true)

Parameters

prop	Flag indicating if input blobs are to be propagated to output cubes.

Definition at line 727 of file Process.cpp.

Referenced by RingsSetOutputCube(), and SetOutputCube().

◆ PropagateTables() [1/2]

void Isis::Process::PropagateTables ( const bool prop )

inherited

This method allows the programmer to propagate input tables to the output cube (default is true)

Parameters

prop	Flag indicating if input tables are to be propagated to output cubes.

Definition at line 678 of file Process.cpp.

Referenced by RingsSetOutputCube(), and SetOutputCube().

◆ PropagateTables() [2/2]

void Isis::Process::PropagateTables	(	const QString &	fromName,
		const QList< QString > &	tableNames = `QList<QString>()`
	)

inherited

Propagate the tables from the cube with the given filename to the output cube.

This is done at the time this method is called, not during normal processing. The names of the tables to propagate can be provided through the second paramter, by specifing a list of table names. Not providing any list (or providing an empty list) will propagate all tables.

Parameters

fromName	QString of the name of the cube containing the tables to propagate.
tableNames	List of QStrings of the names of the tables to propagate; default is empty, which indicates that all tables will be propagated.

History:: 2016-11-30 Ian Humphrey - Added tableNames parameter so that only specified tables will be propagated when calling this method. Note that a default of an empty QList is used to propagate all tables. References #4433.

Definition at line 698 of file Process.cpp.

References Isis::Cube::close(), Isis::Cube::label(), Isis::PvlObject::object(), Isis::PvlObject::objects(), Isis::Cube::open(), and Isis::Cube::read().

◆ ResetCountBands()

void Isis::ProcessMosaic::ResetCountBands ( )

privateinherited

Reset all the count bands to default at the time of mosaic creation.

Author: Sharmila Prasad (1/13/2011)

Definition at line 999 of file ProcessMosaic.cpp.

References Isis::Portal::SetPosition(), and Isis::Buffer::size().

◆ RingsSetOutputCube() [1/5]

Isis::Cube * Isis::ProcessMapMosaic::RingsSetOutputCube	(	const QString &	inputFile,
		double	xmin,
		double	xmax,
		double	ymin,
		double	ymax,
		double	srad,
		double	erad,
		double	saz,
		double	eaz,
		int	nbands,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile
	)

Set the output cube to specified file name using the specified input file name, output attributes, ring radii values and ring longitude values.

Parameters

inputFile	Name of input file
xmin	Minimum x-value
xmax	Maximum x-value
ymin	Minimum y-value
ymax	Maximum y-value
srad	Start ring radius
erad	End ring radius
saz	Start ring longitude (azimuth)
eaz	End ring longitude (azimuth)
oAtt	Output attributes
mosaicFile	Name of the output mosaic file

Definition at line 607 of file ProcessMapMosaic.cpp.

References Isis::Cube::addCachingAlgorithm(), Isis::PvlObject::addGroup(), Isis::PvlContainer::addKeyword(), Isis::Process::ClearInputCubes(), Isis::ProcessByBrick::EndProcess(), Isis::PvlObject::findGroup(), Isis::Cube::open(), Isis::Process::Progress(), Isis::Process::PropagateHistory(), Isis::Process::PropagateLabels(), Isis::Process::PropagateOriginalLabel(), Isis::Process::PropagatePolygons(), Isis::Process::PropagateTables(), Isis::Cube::putGroup(), Isis::ProcessByLine::SetInputCube(), Isis::ProcessByBrick::SetOutputCube(), Isis::Progress::SetText(), Isis::ProcessByLine::StartProcess(), Isis::toString(), Isis::Projection::ToWorldX(), and Isis::Projection::ToWorldY().

◆ RingsSetOutputCube() [2/5]

Isis::Cube * Isis::ProcessMapMosaic::RingsSetOutputCube	(	const QString &	inputFile,
		PvlGroup	mapping,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile
	)

Set the output cube to specified file name and specified input images and output attributes and lat,lons.

Definition at line 729 of file ProcessMapMosaic.cpp.

References Isis::Cube::addCachingAlgorithm(), Isis::PvlObject::addGroup(), Isis::Cube::bandCount(), Isis::Process::ClearInputCubes(), Isis::PvlContainer::deleteKeyword(), Isis::ProcessByBrick::EndProcess(), Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), Isis::Cube::open(), Isis::Process::Progress(), Isis::Process::PropagateHistory(), Isis::Process::PropagateLabels(), Isis::Cube::putGroup(), Isis::ProcessByLine::SetInputCube(), Isis::ProcessByBrick::SetOutputCube(), Isis::Progress::SetText(), and Isis::ProcessByLine::StartProcess().

◆ RingsSetOutputCube() [3/5]

Cube * Isis::ProcessMapMosaic::RingsSetOutputCube ( const QString & mosaicFile )

Mosaic output method for Mosaic Processing Method, this will use an existing mosaic.

Definition at line 806 of file ProcessMapMosaic.cpp.

References Isis::PvlObject::findGroup(), Isis::Cube::label(), and Isis::Cube::open().

◆ RingsSetOutputCube() [4/5]

Isis::Cube * Isis::ProcessMapMosaic::RingsSetOutputCube	(	FileList &	propagationCubes,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile
	)

Set the output cube to specified file name and specified input images and output attributes.

Definition at line 272 of file ProcessMapMosaic.cpp.

References Isis::Cube::bandCount(), Isis::Cube::close(), Isis::ProjectionFactory::CreateFromCube(), Isis::Cube::label(), Isis::Cube::lineCount(), Isis::RingPlaneProjection::MaximumRingLongitude(), Isis::RingPlaneProjection::MaximumRingRadius(), Isis::RingPlaneProjection::MinimumRingLongitude(), Isis::RingPlaneProjection::MinimumRingRadius(), Isis::Cube::open(), Isis::Cube::sampleCount(), Isis::Projection::ToProjectionX(), Isis::Projection::ToProjectionY(), and Isis::toString().

◆ RingsSetOutputCube() [5/5]

Isis::Cube * Isis::ProcessMapMosaic::RingsSetOutputCube	(	FileList &	propagationCubes,
		double	srad,
		double	erad,
		double	saz,
		double	eaz,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile
	)

Set the output cube to specified file name using the specified input images, output attributes, ring radii values and ring longitude values.

Parameters

propagationCubes	List of input images
srad	Start ring radius
erad	End ring radius
saz	Start ring longitude (azimuth)
eaz	End ring longitude (azimuth)
oAtt	Output attributes
mosaicFile	Name of the output mosaic file

Definition at line 434 of file ProcessMapMosaic.cpp.

References Isis::PvlContainer::addKeyword(), Isis::Cube::bandCount(), Isis::PvlContainer::deleteKeyword(), Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), Isis::Cube::label(), Isis::Cube::open(), Isis::Pvl::read(), Isis::ProjectionFactory::RingsCreateForCube(), Isis::ProjectionFactory::RingsCreateFromCube(), and Isis::toString().

◆ SetBandKeyword()

void Isis::ProcessMosaic::SetBandKeyword	(	QString	bandPriorityKeyName,
		QString	bandPriorityKeyValue
	)

inherited

Set the keyword/value to use for comparing when using band priority.

Definition at line 740 of file ProcessMosaic.cpp.

◆ SetBandNumber()

void Isis::ProcessMosaic::SetBandNumber ( int bandPriorityBandNumber )

inherited

Set the band to use for priorities when using band priority.

Definition at line 749 of file ProcessMosaic.cpp.

◆ SetBandUseMaxValue()

void Isis::ProcessMosaic::SetBandUseMaxValue ( bool useMax )

inherited

Set whether to take the image with the max or min value when using band priority.

Definition at line 758 of file ProcessMosaic.cpp.

◆ SetCreateFlag()

void Isis::ProcessMosaic::SetCreateFlag ( bool createOutputMosaic )

inherited

Flag to indicate that the mosaic is being newly created Indication that the new label specific to the mosaic needs to be created.

Author: Sharmila Prasad (1/19/2011)

Parameters

createOutputMosaic - Set Create Flag True/False

Definition at line 771 of file ProcessMosaic.cpp.

◆ SetHighSaturationFlag()

void Isis::ProcessMosaic::SetHighSaturationFlag ( bool placeHighSatPixels )

inherited

When true, high saturation (HRS, HIS) will be considered valid data for the purposes of placing pixels in the output mosaic.

Definition at line 780 of file ProcessMosaic.cpp.

◆ SetInputCube() [1/6]

Isis::Cube * Isis::ProcessMapMosaic::SetInputCube ( )

virtual

Input cube cannot be set here.

Definition at line 41 of file ProcessMapMosaic.cpp.

◆ SetInputCube() [2/6]

Isis::Cube * Isis::Process::SetInputCube	(	const QString &	fname,
		const Isis::CubeAttributeInput &	att,
		int	requirements = `0`
	)

virtualinherited

Opens an input cube specified by the programmer and verifies requirements are met.

Parameters

fname	Programmer specified work file. For example, "myfile.cub".
att	The cube attributes to use when opening the input cube.
requirements	Requirements to check that the input cube meets. See CheckRequirements().

Returns: Cube*

Exceptions

Isis::iException::Message

Reimplemented in Isis::ProcessByBrick.

Definition at line 66 of file Process.cpp.

References Isis::CubeAttributeInput::bands(), Isis::Cube::open(), and Isis::Cube::setVirtualBands().

◆ SetInputCube() [3/6]

Cube * Isis::ProcessMosaic::SetInputCube	(	const QString &	fname,
		Isis::CubeAttributeInput &	att,
		const int	ss = `1`,
		const int	sl = `1`,
		const int	sb = `1`,
		const int	ns = `-1`,
		const int	nl = `-1`,
		const int	nb = `-1`
	)

virtualinherited

Opens an input cube specified by the user.

This method is overloaded and adds the requirement that only one input cube can be specified.

Returns: Cube*

Parameters

fname
att
ss	The starting sample within the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to 1
sl	The starting line within the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to 1
sb	The starting band within the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to 1
ns	The number of samples from the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to number of samples in the cube
nl	The number of lines from the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to number of lines in the cube
nb	The number of bands from the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to number of bands in the cube

Exceptions

IException

Definition at line 644 of file ProcessMosaic.cpp.

References Isis::PvlObject::findGroup(), and Isis::toInt().

◆ SetInputCube() [4/6]

Isis::Cube * Isis::Process::SetInputCube	(	const QString &	parameter,
		const int	requirements = `0`
	)

virtualinherited

Opens an input cube specified by the user and verifies requirements are met.

Returns: Cube*

Parameters

parameter	User parameter to obtain file to open. Typically, the value is "FROM". For example, the user can specify on the command line FROM=myfile.cub and this method will attempt to open the cube "myfile.cub" if the parameter was set to "FROM".
requirements	Requirements to check that the input cube meets. See CheckRequirements().

Exceptions

Isis::iException::Message

Reimplemented in Isis::ProcessBySample, Isis::ProcessByBrick, Isis::ProcessBySpectra, and Isis::ProcessByLine.

Definition at line 136 of file Process.cpp.

Referenced by Isis::ImageExporter::addChannel(), Isis::JigsawRunWidget::on_JigsawAcceptButton_clicked(), Isis::FileTool::saveAsEnlargedCube(), and Isis::ProcessGroundPolygons::SetStatCubes().

◆ SetInputCube() [5/6]

Cube * Isis::ProcessMosaic::SetInputCube	(	const QString &	parameter,
		const int	ss,
		const int	sl,
		const int	sb,
		const int	ns,
		const int	nl,
		const int	nb
	)

virtualinherited

Opens an input cube specified by the user.

This method is overloaded and adds the requirement that only one input cube can be specified.

Returns: Cube*

Parameters

parameter	User parameter to obtain file to open. Typically, the value is "FROM". For example, the user can specify on the command line FROM=myfile.cub and this method will attempt to open the cube "myfile.cub" if the parameter was set to "FROM".
ss	The starting sample within the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to 1
sl	The starting line within the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to 1
sb	The starting band within the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to 1
ns	The number of samples from the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to number of samples in the cube
nl	The number of lines from the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to number of lines in the cube
nb	The number of bands from the input cube. This allowd the application to choose a sub-area from the input cube to be place into the mosaic. Defaults to number of bands in the cube

Exceptions

IException::Message

Definition at line 574 of file ProcessMosaic.cpp.

References Isis::PvlObject::findGroup(), and Isis::toInt().

◆ SetInputCube() [6/6]

void Isis::Process::SetInputCube	(	Isis::Cube *	inCube,
		int	requirements = `0`
	)

virtualinherited

Set the InputCube vector to an opened Cube which was dynamically allocated.

This is used if there already exists a valid opened cube

Author: Sharmila Prasad (5/7/2011)

Parameters

inCube	- Pointer to input Cube
requirements	Requirements to check that the input cube meets. See CheckRequirements().

Definition at line 107 of file Process.cpp.

References Isis::Cube::isOpen().

◆ SetLowSaturationFlag()

void Isis::ProcessMosaic::SetLowSaturationFlag ( bool placeLowSatPixels )

inherited

When true, low saturation (LRS, LIS) will be considered valid data for the purposes of placing pixels in the output mosaic.

Definition at line 794 of file ProcessMosaic.cpp.

◆ SetMatchDEM()

void Isis::ProcessMosaic::SetMatchDEM ( bool matchDEM )

inherited

Set the DEM match flag.

Parameters

matchDEM If true, the match is enforced between Input & Mosaic

Definition at line 802 of file ProcessMosaic.cpp.

◆ SetNullFlag()

void Isis::ProcessMosaic::SetNullFlag ( bool placeNullPixels )

inherited

When true, Null pixels will be considered valid data for the purposes of placing pixels in the output mosaic.

Definition at line 811 of file ProcessMosaic.cpp.

◆ SetOutputCube() [1/7]

Isis::Cube * Isis::Process::SetOutputCube	(	const QString &	fname,
		const Isis::CubeAttributeOutput &	att,
		const int	ns,
		const int	nl,
		const int	nb = `1`
	)

virtualinherited

Allocates a output cube whose name and size is specified by the programmer.

Returns: Cube*

Parameters

fname	Name of the output cube to allocate
att	The cube attributes to use when creating the output cube.
ns	Number of samples to allocate
nl	Number of lines to allocate
nb	Number of bands to allocate

Exceptions

Isis::iException::Message

Definition at line 309 of file Process.cpp.

References Isis::PvlObject::addGroup(), Isis::PvlObject::addObject(), Isis::AttachedLabel, Isis::CubeAttributeOutput::byteOrder(), Isis::Cube::create(), Isis::CubeAttributeOutput::fileFormat(), Isis::PvlObject::findObject(), Isis::PvlObject::group(), Isis::PvlObject::groups(), Isis::PvlContainer::isNamed(), Isis::Cube::label(), Isis::Cube::labelSize(), Isis::CubeAttributeOutput::maximum(), Isis::CubeAttributeOutput::minimum(), Isis::PvlContainer::name(), Isis::PvlObject::object(), Isis::PvlObject::objects(), Isis::Cube::pixelType(), Isis::CubeAttributeOutput::pixelType(), Isis::CubeAttributeOutput::propagateMinimumMaximum(), Isis::CubeAttributeOutput::propagatePixelType(), Isis::Cube::setBaseMultiplier(), Isis::Cube::setByteOrder(), Isis::Cube::setDimensions(), Isis::Cube::setFormat(), Isis::Cube::setLabelsAttached(), Isis::Cube::setLabelSize(), Isis::Cube::setMinMax(), Isis::Cube::setPixelType(), and Isis::Cube::write().

◆ SetOutputCube() [2/7]

Isis::Cube * Isis::ProcessMapMosaic::SetOutputCube	(	const QString &	inputFile,
		double	xmin,
		double	xmax,
		double	ymin,
		double	ymax,
		double	slat,
		double	elat,
		double	slon,
		double	elon,
		int	nbands,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile,
		bool	latlonflag = `true`
	)

virtual

Set the output cube to specified file name and specified input images and output attributes and lat,lons.

Definition at line 505 of file ProcessMapMosaic.cpp.

References Isis::Cube::addCachingAlgorithm(), Isis::PvlObject::addGroup(), Isis::PvlContainer::addKeyword(), Isis::Process::ClearInputCubes(), Isis::PvlContainer::deleteKeyword(), Isis::ProcessByBrick::EndProcess(), Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), Isis::Cube::open(), Isis::Process::Progress(), Isis::Process::PropagateHistory(), Isis::Process::PropagateLabels(), Isis::Process::PropagateOriginalLabel(), Isis::Process::PropagatePolygons(), Isis::Process::PropagateTables(), Isis::Cube::putGroup(), Isis::ProcessByLine::SetInputCube(), Isis::ProcessByBrick::SetOutputCube(), Isis::Progress::SetText(), Isis::ProcessByLine::StartProcess(), Isis::toString(), Isis::Projection::ToWorldX(), and Isis::Projection::ToWorldY().

◆ SetOutputCube() [3/7]

Isis::Cube * Isis::ProcessMapMosaic::SetOutputCube	(	const QString &	inputFile,
		PvlGroup	mapping,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile
	)

virtual

Set the output cube to specified file name and specified input images and output attributes and lat,lons.

Definition at line 671 of file ProcessMapMosaic.cpp.

References Isis::Cube::addCachingAlgorithm(), Isis::PvlObject::addGroup(), Isis::Cube::bandCount(), Isis::Process::ClearInputCubes(), Isis::PvlContainer::deleteKeyword(), Isis::ProcessByBrick::EndProcess(), Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), Isis::Cube::open(), Isis::Process::Progress(), Isis::Process::PropagateHistory(), Isis::Process::PropagateLabels(), Isis::Cube::putGroup(), Isis::ProcessByLine::SetInputCube(), Isis::ProcessByBrick::SetOutputCube(), Isis::Progress::SetText(), and Isis::ProcessByLine::StartProcess().

◆ SetOutputCube() [4/7]

Cube * Isis::ProcessMapMosaic::SetOutputCube ( const QString & mosaicFile )

virtual

Mosaic output method for Mosaic Processing Method, this will use an existing mosaic.

Reimplemented from Isis::Process.

Definition at line 786 of file ProcessMapMosaic.cpp.

References Isis::PvlObject::findGroup(), Isis::Cube::label(), and Isis::Cube::open().

◆ SetOutputCube() [5/7]

Isis::Cube * Isis::Process::SetOutputCube	(	const QString &	parameter,
		const int	ns,
		const int	nl,
		const int	nb = `1`
	)

virtualinherited

Allocates a user specified output cube whose size is specified by the programmer.

Returns: Cube*

Parameters

parameter	User specified output file. For example, "TO" is a popular user parameter. If the user specified TO=output.cub, then this routine would allocate the file output.cub with size specified by the first opened input cube. The output pixel type will be propagated from the first loaded input cube or will use the value in the application XML file for pixelType.
ns	Number of samples to allocate
nl	Number of lines to allocate
nb	Number of bands to allocate

Exceptions

Isis::iException::Message

Definition at line 229 of file Process.cpp.

◆ SetOutputCube() [6/7]

Isis::Cube * Isis::ProcessMapMosaic::SetOutputCube	(	FileList &	propagationCubes,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile
	)

virtual

Set the output cube to specified file name and specified input images and output attributes.

Definition at line 193 of file ProcessMapMosaic.cpp.

References Isis::Cube::bandCount(), Isis::Cube::close(), Isis::ProjectionFactory::CreateFromCube(), Isis::Cube::label(), Isis::Cube::lineCount(), Isis::TProjection::MaximumLatitude(), Isis::TProjection::MaximumLongitude(), Isis::TProjection::MinimumLatitude(), Isis::TProjection::MinimumLongitude(), Isis::Cube::open(), Isis::Cube::sampleCount(), Isis::Projection::ToProjectionX(), Isis::Projection::ToProjectionY(), and Isis::toString().

◆ SetOutputCube() [7/7]

Isis::Cube * Isis::ProcessMapMosaic::SetOutputCube	(	FileList &	propagationCubes,
		double	slat,
		double	elat,
		double	slon,
		double	elon,
		CubeAttributeOutput &	oAtt,
		const QString &	mosaicFile
	)

virtual

Set the output cube to specified file name and specified input images and output attributes and lat,lons.

Definition at line 345 of file ProcessMapMosaic.cpp.

References Isis::PvlContainer::addKeyword(), Isis::Cube::bandCount(), Isis::ProjectionFactory::CreateForCube(), Isis::ProjectionFactory::CreateFromCube(), Isis::PvlContainer::deleteKeyword(), Isis::PvlObject::findGroup(), Isis::PvlContainer::hasKeyword(), Isis::Cube::label(), Isis::Cube::open(), Isis::Pvl::read(), and Isis::toString().

◆ SetOutputCubeStretch() [1/2]

Isis::Cube * Isis::Process::SetOutputCubeStretch	(	const QString &	parameter,
		const int	ns,
		const int	nl,
		const int	nb = `1`,
		UserInterface *	ui = `nullptr`
	)

virtualinherited

Allocates a user specified output cube whose size is specified by the programmer.

Returns: Cube*

Parameters

parameter	User specified output file. For example, "TO" is a popular user parameter. If the user specified TO=output.cub, then this routine would allocate the file output.cub with size specified by the first opened input cube. The output pixel type will be propagated from the first loaded input cube or will use the value in the application XML file for pixelType.
ns	Number of samples to allocate
nl	Number of lines to allocate
nb	Number of bands to allocate
ui	A user interface used to get the attributes needed. If null, the user interface will be obtained from the application.

Exceptions

Isis::iException::Message

Definition at line 270 of file Process.cpp.

References IsisAml::GetFileName(), and IsisAml::GetOutputAttribute().

◆ SetOutputCubeStretch() [2/2]

Isis::Cube * Isis::Process::SetOutputCubeStretch	(	const QString &	parameter,
		UserInterface *	ui = `nullptr`
	)

virtualinherited

Allocates a user-specified output cube whose size matches the first input cube.

Returns: Cube*

Parameters

parameter	User specified output file. For example, "TO" is a popular user parameter. If the user specified TO=output.cub, then this routine would allocate the file output.cub with size specified by the first opened input cube. The output pixel type will be propagated from the first loaded input cube or will use the value in the application XML file for pixelType.
ui	A user interface used to get the attributes needed for SetOutputCube.

Exceptions

Isis::iException::Message

Definition at line 193 of file Process.cpp.

◆ StartProcess() [1/3]

void Isis::ProcessMosaic::StartProcess	(	const int &	os,
		const int &	ol,
		const int &	ob
	)

virtualinherited

This method invokes the process by mosaic operation over a single input cube and single output cube.

Unlike other Isis process objects, no application . function will be called. The processing is handled entirely within the mosaic object. The input cube must be pixel aligned with the output cube before mosaiking. If the input cube does not overlay any of the output cube, no processing takes place. There are 3 priorities input, mosaic and band. Has the ability to track the origin of the mosaic if the flag is set. Some conditions apply like tracking turned off for multiband input with input or mosaic priority.

Parameters

os	The sample position of input cube starting sample relative to the output cube. The cordinate is in output cube space and may be any integer value negative or positive.
ol	The line position of input cube starting line relative to the output cube. The cordinate is in output cube space and may be any integer value negative or positive.
ob	The band position of input cube starting band relative to the output cube. The cordinate is in output cube space and must be a legal band number within the output cube.

Exceptions

IException::Message

Author: Sharmila Prasad (8/25/2009)

Definition at line 106 of file ProcessMosaic.cpp.

References Isis::PvlContainer::addKeyword(), Isis::FileName::expanded(), Isis::TrackingTable::fileNameToPixel(), Isis::PvlObject::findObject(), Isis::IsHighPixel(), Isis::IsLowPixel(), Isis::IsNullPixel(), Isis::IsValidPixel(), Isis::FileName::path(), Isis::FileName::removeExtension(), Isis::Cube::setPixelType(), Isis::Portal::SetPosition(), Isis::PvlKeyword::setValue(), Isis::Buffer::size(), Isis::toString(), and Isis::TrackingTable::toTable().

◆ StartProcess() [2/3]

bool Isis::ProcessMapMosaic::StartProcess ( QString inputFile )

virtual

Mosaic Processing method, returns false if the cube is not inside the mosaic.

Definition at line 51 of file ProcessMapMosaic.cpp.

References Isis::Projection::IsEquatorialCylindrical(), Isis::Cube::lineCount(), Isis::FileName::name(), Isis::Cube::projection(), Isis::Cube::sampleCount(), Isis::Progress::SetText(), Isis::Projection::SetUniversalGround(), Isis::Projection::ToProjectionX(), Isis::Projection::ToProjectionY(), Isis::Projection::ToWorldX(), Isis::Projection::ToWorldY(), and Isis::Projection::WorldX().

◆ StartProcess() [3/3]

virtual void Isis::Process::StartProcess ( void funct() )

inlinevirtualinherited

In the base class, this method will invoked a user-specified function exactly one time.

In derived classes such as ProcessByLine, the StartProcess will invoke a user-specified function for every line in a cube.

Parameters

funct() Name of your processing function

Definition at line 213 of file Process.h.

◆ StringToOverlay()

ProcessMosaic::ImageOverlay Isis::ProcessMosaic::StringToOverlay ( QString imageOverlayString )

staticinherited

Convert a QString to an ImageOverlay (case-insensitive).

This is used to translate between mapmos, handmos, and automos' interfaces into an ImageOverlay.

Definition at line 927 of file ProcessMosaic.cpp.

◆ WriteHistory()

void Isis::Process::WriteHistory ( Cube & cube )

inherited

Writes out the History blob to the cube.

Definition at line 789 of file Process.cpp.

References Isis::History::AddEntry(), Isis::PvlContainer::isNamed(), Isis::PvlObject::object(), Isis::PvlObject::objects(), Isis::Cube::readHistory(), and Isis::Cube::write().

Referenced by Isis::ImageImporter::import().

Member Data Documentation

◆ InputCubes

std::vector<Isis::Cube *> Isis::Process::InputCubes

protectedinherited

A vector of pointers to opened Cube objects.

The pointers are established in the SetInputCube/SetInputWorkCube methods.

Definition at line 185 of file Process.h.

Referenced by Isis::ProcessExport::CreateWorldFile(), Isis::ProcessExport::GetBuffersBIL(), Isis::ProcessExport::GetBuffersBIP(), Isis::ProcessExport::GetBuffersBSQ(), Isis::ProcessExport::InitProcess(), Isis::ProcessByBrick::ProcessCube(), Isis::ProcessByBrick::ProcessCubes(), Isis::ProcessExport::SetInputRange(), Isis::ProcessExport::StartProcess(), and Isis::ProcessByQuickFilter::StartProcess().

◆ m_enforceBandBinMatch

bool Isis::ProcessMosaic::m_enforceBandBinMatch

privateinherited

True/False value to determine whether to enforce the input cube bandbin matches the mosaic bandbin group.

Definition at line 345 of file ProcessMosaic.h.

◆ m_enforceMatchDEM

bool Isis::ProcessMosaic::m_enforceMatchDEM

privateinherited

DEM of the input and mosaic should match.

Definition at line 349 of file ProcessMosaic.h.

◆ m_imagePositions

PvlObject Isis::ProcessMosaic::m_imagePositions

privateinherited

List of images placed on the mosaic.

Definition at line 353 of file ProcessMosaic.h.

◆ m_inb

int Isis::ProcessMosaic::m_inb

privateinherited

The number of bands from the input cube.

Definition at line 338 of file ProcessMosaic.h.

◆ m_inl

int Isis::ProcessMosaic::m_inl

privateinherited

The number of lines from the input cube.

Definition at line 337 of file ProcessMosaic.h.

◆ m_ins

int Isis::ProcessMosaic::m_ins

privateinherited

The number of samples from the input cube.

Definition at line 336 of file ProcessMosaic.h.

◆ m_isb

int Isis::ProcessMosaic::m_isb

privateinherited

The starting band within the input cube.

Definition at line 335 of file ProcessMosaic.h.

◆ m_isl

int Isis::ProcessMosaic::m_isl

privateinherited

The starting line within the input cube.

Definition at line 334 of file ProcessMosaic.h.

◆ m_iss

int Isis::ProcessMosaic::m_iss

privateinherited

The starting sample within the input cube.

Definition at line 333 of file ProcessMosaic.h.

◆ m_onb

int Isis::ProcessMosaic::m_onb

privateinherited

The number of bands in the output cube.

Definition at line 343 of file ProcessMosaic.h.

◆ m_osb

int Isis::ProcessMosaic::m_osb

privateinherited

The starting band within the output cube.

Definition at line 342 of file ProcessMosaic.h.

◆ m_osl

int Isis::ProcessMosaic::m_osl

privateinherited

The starting line within the output cube.

Definition at line 341 of file ProcessMosaic.h.

◆ m_oss

int Isis::ProcessMosaic::m_oss

privateinherited

The starting sample within the output cube.

Definition at line 340 of file ProcessMosaic.h.

◆ m_ownedCubes

QSet<Isis::Cube *>* Isis::Process::m_ownedCubes

protectedinherited

A list of cubes owned by this instant.

These cubes will be deleted on finalization. Process will not take ownership of cubes allocated outside of Process. It is the caller's responsibility to delete such cubes.

Definition at line 199 of file Process.h.

◆ m_trackingCube

Cube* Isis::ProcessMosaic::m_trackingCube

privateinherited

Output tracking cube. NULL unless tracking is enabled.

Definition at line 325 of file ProcessMosaic.h.

◆ OutputCubes

std::vector<Isis::Cube *> Isis::Process::OutputCubes

protectedinherited

A vector of pointers to allocated Cube objects.

The pointers are established in the SetOutputCube method.

Definition at line 191 of file Process.h.

Referenced by Isis::ProcessImport::ProcessBil(), Isis::ProcessImport::ProcessBip(), Isis::ProcessImport::ProcessBsq(), Isis::ProcessByBrick::ProcessCube(), Isis::ProcessByBrick::ProcessCubes(), Isis::ProcessImport::ProcessJp2(), and Isis::ProcessByQuickFilter::StartProcess().

◆ p_bandStats

std::vector< std::vector< Isis::Statistics * > > Isis::Process::p_bandStats

protectedinherited

Holds the calculated statistics for each band separately of every input cubei after the CalculateStatistics method is called.

Definition at line 172 of file Process.h.

Referenced by Isis::Process::BandStatistics().

◆ p_createMosaic

bool Isis::ProcessMapMosaic::p_createMosaic

private

Internal use; SetOutputMosaic (const QString &) sets to false to not attempt creation when using SetOutputMosaic.

Definition at line 157 of file ProcessMapMosaic.h.

◆ p_cubeStats

std::vector< Isis::Statistics * > Isis::Process::p_cubeStats

protectedinherited

Holds the calculated statistics for every band together of every input cubei after the CalculateStatistics method is called.

Definition at line 179 of file Process.h.

Referenced by Isis::Process::CubeStatistics().

◆ p_progress

Isis::Progress* Isis::Process::p_progress

protectedinherited

Pointer to a Progress object.

Definition at line 145 of file Process.h.

Referenced by Isis::ProcessExport::InitProcess(), Isis::ProcessImport::ProcessBil(), Isis::ProcessImport::ProcessBip(), Isis::ProcessImport::ProcessBsq(), Isis::ProcessExport::ProcessExport(), Isis::ProcessImport::ProcessImport(), Isis::ProcessImport::ProcessJp2(), Isis::Process::Progress(), Isis::ProcessByBrick::RunProcess(), Isis::ProcessExport::StartProcess(), and Isis::ProcessByQuickFilter::StartProcess().

◆ p_propagateHistory

bool Isis::Process::p_propagateHistory

protectedinherited

Flag indicating if history is to be propagated to output cubes.

Definition at line 161 of file Process.h.

◆ p_propagateLabels

bool Isis::Process::p_propagateLabels

protectedinherited

Flag indicating if labels are be propagated to output cubes.

Definition at line 149 of file Process.h.

◆ p_propagateOriginalLabel

bool Isis::Process::p_propagateOriginalLabel

protectedinherited

Flag indicating if original lable is to be propagated to output cubes.

Definition at line 165 of file Process.h.

◆ p_propagatePolygons

bool Isis::Process::p_propagatePolygons

protectedinherited

Flag indicating if blobs are be propagated to output cubes.

Definition at line 157 of file Process.h.

◆ p_propagateTables

bool Isis::Process::p_propagateTables

protectedinherited

Flag indicating if tables are be propagated to output cubes.

Definition at line 153 of file Process.h.

◆ TRACKING_TABLE_NAME

const char * Isis::ProcessMosaic::TRACKING_TABLE_NAME = "InputImages"

staticinherited

This is the name of the table in the Cube which will contain the image file names.

Definition at line 197 of file ProcessMosaic.h.

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

src/base/objs/ProcessMapMosaic/ProcessMapMosaic.h
src/base/objs/ProcessMapMosaic/ProcessMapMosaic.cpp

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ ImageOverlay

Constructor & Destructor Documentation

◆ ProcessMapMosaic()

◆ ~ProcessMapMosaic()

Member Function Documentation

◆ AddBandBinGroup()

◆ AddDefaultBandBinGroup()

◆ BandComparison()

◆ BandPriorityWithNoTracking()

◆ BandStatistics()

◆ CalculateStatistics()

◆ CheckRequirements()

◆ ClearCubes()

◆ ClearInputCubes()

◆ ClearOutputCubes()

◆ CubeStatistics()

◆ EndProcess()

◆ FillNull()

◆ Finalize()

◆ GetBandIndex()

◆ GetHighSaturationFlag()

◆ GetInputStartBandInMosaic()

◆ GetInputStartLineInMosaic()

◆ GetInputStartSampleInMosaic()

◆ GetLowSaturationFlag()

◆ GetNullFlag()

◆ GetOriginDefaultByPixelType()

◆ GetTrackFlag()

◆ GetTrackStatus()

◆ imagePositions()

◆ MatchBandBinGroup()

◆ MatchDEMShapeModel()

◆ MissionData()

◆ OverlayToString()

◆ ProcessAveragePriority()

◆ Progress()

◆ PropagateHistory()

◆ PropagateLabels() [1/2]

◆ PropagateLabels() [2/2]

◆ PropagateOriginalLabel()

◆ PropagatePolygons()

◆ PropagateTables() [1/2]

◆ PropagateTables() [2/2]

◆ ResetCountBands()

◆ RingsSetOutputCube() [1/5]

◆ RingsSetOutputCube() [2/5]

◆ RingsSetOutputCube() [3/5]

◆ RingsSetOutputCube() [4/5]

◆ RingsSetOutputCube() [5/5]

◆ SetBandKeyword()

◆ SetBandNumber()

◆ SetBandUseMaxValue()

◆ SetCreateFlag()

◆ SetHighSaturationFlag()

◆ SetInputCube() [1/6]

◆ SetInputCube() [2/6]

◆ SetInputCube() [3/6]

◆ SetInputCube() [4/6]

◆ SetInputCube() [5/6]

◆ SetInputCube() [6/6]

◆ SetLowSaturationFlag()

◆ SetMatchDEM()

◆ SetNullFlag()

◆ SetOutputCube() [1/7]

◆ SetOutputCube() [2/7]

◆ SetOutputCube() [3/7]

◆ SetOutputCube() [4/7]

◆ SetOutputCube() [5/7]

◆ SetOutputCube() [6/7]

◆ SetOutputCube() [7/7]