An image bundle adjustment object. More...

#include <BundleAdjust.h>

Public Slots
bool	solveCholesky ()
	Compute the least squares bundle adjustment solution using Cholesky decomposition. More...

void	abortBundle ()
	Flag to abort when bundle is threaded. More...

void	outputBundleStatus (QString status)
	Slot for deltack and jigsaw to output the bundle status. More...

ControlNetQsp	controlNet ()
	Returns a pointer to the output control network. More...

SerialNumberList *	serialNumberList ()
	Returns a pointer to the serial number list. More...

QString	fileName (int index)
	Return the ith filename in the cube list file given to constructor. More...

QString	iterationSummaryGroup () const
	Returns the iteration summary string. More...

bool	isConverged ()
	Returns if the BundleAdjust converged. More...

Table	cMatrix (int index)
	Return a table cmatrix for the ith cube in the cube list given to the constructor. More...

Table	spVector (int index)
	Return a table spacecraft vector for the ith cube in the cube list given to the constructor. More...

int	numberOfImages () const
	Returns the number of images. More...

double	iteration () const
	Returns what iteration the BundleAdjust is currently on. More...

Signals
void	statusUpdate (QString)

void	error (QString)

void	iterationUpdate (int, double)

void	resultsReady (BundleSolutionInfo *bundleSolveInformation)

void	finished ()

Public Member Functions
	BundleAdjust (BundleSettingsQsp bundleSettings, const QString &cnetFile, const QString &cubeList, bool printSummary=true)
	Construct a BundleAdjust object from the given settings, control network file, and cube list. More...

	BundleAdjust (BundleSettingsQsp bundleSettings, QString &cnet, SerialNumberList &snlist, bool printSummary=true)
	Construct a BundleAdjust object with held cubes. More...

	BundleAdjust (BundleSettingsQsp bundleSettings, Control &cnet, SerialNumberList &snlist, bool bPrintSummary)
	Constructs a BundleAdjust object using a Control object. More...

	BundleAdjust (BundleSettingsQsp bundleSettings, ControlNet &cnet, SerialNumberList &snlist, bool printSummary=true)
	Constructs a BundleAdjust object using a ControlNet object. More...

	BundleAdjust (BundleSettingsQsp bundleSettings, ControlNetQsp cnet, const QString &cubeList, bool printSummary=true)
	Constructs a BundleAdjust from an already created ControlNet within a shared pointer. More...

	BundleAdjust (BundleSettingsQsp bundleSettings, Control &control, QList< ImageList * > imgList, bool printSummary)
	Thread safe constructor. More...

	~BundleAdjust ()
	Destroys BundleAdjust object, deallocates pointers (if we have ownership), and frees variables from cholmod library. More...

BundleSolutionInfo	solveCholeskyBR ()
	Compute the least squares bundle adjustment solution using Cholesky decomposition. More...

Detailed Description

An image bundle adjustment object.

BundleAdjust is used to perform a bundle adjustment on overlapping ISIS 3 cubes. Using the collineariy condition, BundleAdjust can construct a system of normal equations and then using the CHOLMOD library, solve that system.

Author: 2006-05-30 Jeff Anderson, Debbie A. Cook, and Tracie Sucharski

Constructor & Destructor Documentation

Isis::BundleAdjust::BundleAdjust	(	BundleSettingsQsp	bundleSettings,
		const QString &	cnetFile,
		const QString &	cubeList,
		bool	printSummary = `true`
	)

Construct a BundleAdjust object from the given settings, control network file, and cube list.

Parameters

bundleSettings	A shared pointer to the BundleSettings to be used.
cnetFile	The filename of the control network to be used.
cubeList	The list of filenames of the cubes to be adjusted.
printSummary	If summaries should be printed each iteration.

Isis::BundleAdjust::BundleAdjust	(	BundleSettingsQsp	bundleSettings,
		QString &	cnetFile,
		SerialNumberList &	snlist,
		bool	printSummary = `true`
	)

Construct a BundleAdjust object with held cubes.

Parameters

bundleSettings	A shared pointer to the BundleSettings to be used.
cnetFile	The filename of the control network to be used.
cubeList	The list of filenames of the cubes to be adjusted.
heldList	The list of filenames of the held cubes. Held cubes must be in both heldList and cubeList.
printSummary	If summaries should be printed each iteration.

Isis::BundleAdjust::BundleAdjust	(	BundleSettingsQsp	bundleSettings,
		Control &	cnet,
		SerialNumberList &	snlist,
		bool	printSummary
	)

Constructs a BundleAdjust object using a Control object.

A new control network object will be created as a copy of the Control's control network.

Parameters

bundleSettings	A shared pointer to the BundleSettings to be used.
cnet	The Control object whose control network will be copied. The Control will not be modified by the BundleAdjust.
snlist	A serial number list containing the cubes to be adjusted.
printSummary	If summaries should be printed each iteration.

References Isis::Control::fileName().

Isis::BundleAdjust::BundleAdjust	(	BundleSettingsQsp	bundleSettings,
		ControlNet &	cnet,
		SerialNumberList &	snlist,
		bool	printSummary = `true`
	)

Constructs a BundleAdjust object using a ControlNet object.

A copy of the ControlNet will be used.

Parameters

bundleSettings	A shared pointer to the BundleSettings to be used.
cnet	The ControlNet that will be copied. The original ControlNet will not be modified.
snlist	A serial number list containing the cubes to be adjusted.
printSummary	If summaries should be printed each iteration.

Isis::BundleAdjust::BundleAdjust	(	BundleSettingsQsp	bundleSettings,
		ControlNetQsp	cnet,
		const QString &	cubeList,
		bool	printSummary = `true`
	)

Constructs a BundleAdjust from an already created ControlNet within a shared pointer.

Parameters

bundleSettings	QSharedPointer to the bundle settings to use.
cnet	QSharedPointer to the control net to adjust.
cubeList	QString name of list of cubes to create serial numbers for.
printSummary	Boolean indicating whether to print application output summary.

Isis::BundleAdjust::BundleAdjust	(	BundleSettingsQsp	bundleSettings,
		Control &	control,
		QList< ImageList * >	imgLists,
		bool	printSummary
	)

Thread safe constructor.

Parameters

bundleSettings	A shared pointer to the BundleSettings to be used.
control	The Control object whose control network will be copied. The Control will not be modified by the BundleAdjust.
snlist	A serial number list containing the cubes to be adjusted.
printSummary	If summaries should be printed each iteration.

References Isis::SerialNumberList::add(), Isis::Control::fileName(), and Isis::Image::fileName().

Isis::BundleAdjust::~BundleAdjust ( )

Destroys BundleAdjust object, deallocates pointers (if we have ownership), and frees variables from cholmod library.

Member Function Documentation

void Isis::BundleAdjust::abortBundle ( )

slot

Flag to abort when bundle is threaded.

Flag is set outside the bundle thread, typically by the gui thread.

Table Isis::BundleAdjust::cMatrix ( int i )

slot

Return a table cmatrix for the ith cube in the cube list given to the constructor.

Parameters

i	The index of the cube

Returns: Table The InstrumentPointing table for the cube.

ControlNetQsp Isis::BundleAdjust::controlNet ( )

slot

Returns a pointer to the output control network.

Returns: ControlNetQsp A shared pointer to the output control network.

void Isis::BundleAdjust::error ( QString _t1 )

signal

QString Isis::BundleAdjust::fileName ( int i )

slot

Return the ith filename in the cube list file given to constructor.

Parameters

i	The index of the cube.

Returns: QString The filename of the cube.

void Isis::BundleAdjust::finished ( )

signal

bool Isis::BundleAdjust::isConverged ( )

slot

Returns if the BundleAdjust converged.

Returns: bool If the BundleAdjust converged.

double Isis::BundleAdjust::iteration ( ) const

slot

Returns what iteration the BundleAdjust is currently on.

Returns: double The current iteration number.

QString Isis::BundleAdjust::iterationSummaryGroup ( ) const

slot

Returns the iteration summary string.

Returns: QString the iteration summary string.

See Also: iterationSummary()

void Isis::BundleAdjust::iterationUpdate	(	int	_t1,
		double	_t2
	)

signal

int Isis::BundleAdjust::numberOfImages ( ) const

slot

Returns the number of images.

Returns: int The number of images.

References Isis::SerialNumberList::size().

void Isis::BundleAdjust::outputBundleStatus ( QString status )

slot

Slot for deltack and jigsaw to output the bundle status.

Parameters

status The bundle status string to output.

void Isis::BundleAdjust::resultsReady ( BundleSolutionInfo * bundleSolveInformation )

signal

SerialNumberList * Isis::BundleAdjust::serialNumberList ( )

slot

Returns a pointer to the serial number list.

Returns: SerialNumberList* A pointer to the serial number list.

bool Isis::BundleAdjust::solveCholesky ( )

slot

Compute the least squares bundle adjustment solution using Cholesky decomposition.

Returns: bool If the solution was successfully computed.

References _FILEINFO_, Isis::IException::errorType(), Isis::SurfacePoint::GetLatitude(), Isis::SurfacePoint::GetLongitude(), and Isis::SurfacePoint::ResetLocalRadius().

BundleSolutionInfo Isis::BundleAdjust::solveCholeskyBR ( )

Compute the least squares bundle adjustment solution using Cholesky decomposition.

Returns: BundleSolutionInfo A container with settings and results from the adjustment.

See Also: BundleAdjust::solveCholesky

make solveCholesky return a BundleSolutionInfo object and delete this placeholder ???

Table Isis::BundleAdjust::spVector ( int i )

slot

Return a table spacecraft vector for the ith cube in the cube list given to the constructor.

Parameters

i	The index of the cube

Returns: Table The InstrumentPosition table for the cube.

void Isis::BundleAdjust::statusUpdate ( QString _t1 )

signal

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

src/control/objs/BundleAdjust/BundleAdjust.h
src/control/objs/BundleAdjust/BundleAdjust.cpp
src/control/objs/BundleAdjust/moc_BundleAdjust.cpp

Public Slots

Signals

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation