A container class for statistical results from a BundleAdjust solution. More...

#include <BundleResults.h>

Public Member Functions
	BundleResults (QObject *parent=0)
	Constructs a BundleSettings object. More...

	BundleResults (Project project, XmlStackedHandlerReader xmlReader, QObject *parent=0)
	Construct this BundleSettings object from XML. More...

	BundleResults (const BundleResults &src)
	Copy constructor for BundleResults. More...

	~BundleResults ()
	Destroys this BundleResults object. More...

BundleResults &	operator= (const BundleResults &src)
	Assignment operator for BundleResults. More...

void	initialize ()
	Initializes the BundleResults to a default state where all numeric members are set to 0 or another default value, all QString members are set to empty, all QVectors and QLists are cleared, and all other members are set to NULL. More...

void	resizeSigmaStatisticsVectors (int numberImages)
	Resizes all image sigma vectors. More...

void	setRmsImageResidualLists (QList< Statistics > rmsImageLineResiduals, QList< Statistics > rmsImageSampleResiduals, QList< Statistics > rmsImageResiduals)
	Sets the root mean square image residual Statistics lists. More...

void	setRmsImageResidualLists (QVector< Statistics > rmsImageLineResiduals, QVector< Statistics > rmsImageSampleResiduals, QVector< Statistics > rmsImageResiduals)

void	setSigmaLatitudeRange (Distance minLatDist, Distance maxLatDist, QString minLatPointId, QString maxLatPointId)
	Sets the min and max sigma latitude distances and point ids. More...

void	setSigmaLongitudeRange (Distance minLonDist, Distance maxLonDist, QString minLonPointId, QString maxLonPointId)
	Sets the min and max sigma longitude distances and point ids. More...

void	setSigmaRadiusRange (Distance minRadDist, Distance maxRadDist, QString minRadPointId, QString maxRadPointId)
	Sets the min and max sigma radius distances and point ids. More...

void	setRmsFromSigmaStatistics (double rmsFromSigmaLatStats, double rmsFromSigmaLonStats, double rmsFromSigmaRadStats)
	Sets the root mean square values of the adjusted latitiude sigmas, adjusted longitude sigmas, and adjusted radius sigmas. More...

void	maximumLikelihoodSetUp (QList< QPair< MaximumLikelihoodWFunctions::Model, double > > modelsWithQuantiles)
	This method steps up the maximum likelihood estimation solution. More...

void	printMaximumLikelihoodTierInformation ()
	Prints out information about which tier the solution is in and the status of the residuals. More...

void	initializeResidualsProbabilityDistribution (unsigned int nodes=20)
	Initializes or resets the cumulative probability distribution of residuals used for reporting. More...

void	initializeProbabilityDistribution (unsigned int nodes=20)
	Initializes or resets the cumulative probability distribution of \|R^2 residuals\|. More...

void	addResidualsProbabilityDistributionObservation (double obsValue)
	Adds an observation to the cumulative probability distribution of residuals used for reporting. More...

void	addProbabilityDistributionObservation (double obsValue)
	Adds an observation to the cumulative probability distribution of \|R^2 residuals\|. More...

void	addProbabilityDistributionObservation (double obsValue, bool residuals)

void	incrementMaximumLikelihoodModelIndex ()
	Increases the value that indicates which stage the maximum likelihood adjustment is currently on. More...

void	incrementFixedPoints ()
	Increase the number of 'fixed' (ground) points. More...

int	numberFixedPoints () const
	Returns the number of 'fixed' (ground) points. More...

void	incrementHeldImages ()
	Increases the number of 'held' images. More...

int	numberHeldImages () const
	Returns the number of 'held' images. More...

void	incrementIgnoredPoints ()
	Increase the number of ignored points. More...

int	numberIgnoredPoints () const
	Returns the number of ignored points. More...

void	setRejectionLimit (double rejectionLimit)
	Sets the rejection limit. More...

void	setRmsXYResiduals (double rx, double ry, double rxy)
	Sets the root mean square of the x and y residuals. More...

void	setNumberRejectedObservations (int numberObservations)
	Sets the number of rejected observations. More...

void	setNumberObservations (int numberObservations)
	Sets the number of observations. More...

void	setNumberImageParameters (int numberParameters)
	Sets the number of image parameters. More...

void	resetNumberConstrainedPointParameters ()
	Resets the number of contrained point parameters to 0. More...

void	incrementNumberConstrainedPointParameters (int incrementAmount)
	Increase the number of contrained point parameters. More...

void	resetNumberConstrainedImageParameters ()
	Resets the number of constrained image parameters to 0. More...

void	incrementNumberConstrainedImageParameters (int incrementAmount)
	Increase the number of constrained image parameters. More...

void	resetNumberConstrainedTargetParameters ()
	Resets the number of constrained target parameters to 0. More...

void	incrementNumberConstrainedTargetParameters (int incrementAmount)
	Increases the number of constrained target parameters. More...

void	setNumberUnknownParameters (int numberParameters)
	Sets the total number of parameters to solve for. More...

void	computeDegreesOfFreedom ()
	Computes the degrees of freedom of the bundle adjustment and stores it internally. More...

void	computeSigma0 (double dvtpv, BundleSettings::ConvergenceCriteria criteria)
	Computes the sigma0 and stores it internally. More...

void	setDegreesOfFreedom (double degreesOfFreedom)
	Sets the degrees of freedom. More...

void	setSigma0 (double sigma0)
	Sets the sigma0. More...

void	setElapsedTime (double time)
	Sets the elapsed time for the bundle adjustment. More...

void	setElapsedTimeErrorProp (double time)
	Sets the elapsed time for error propegation. More...

void	setRadiansToMeters (double rtm)
	Sets the radians to meters conversion constant for the target body. More...

void	setConverged (bool converged)
	Sets if the bundle adjustment converged. More...

void	setBundleControlPoints (QVector< BundleControlPointQsp > controlPoints)
	Sets the bundle control point vector. More...

void	setOutputControlNet (ControlNetQsp outNet)
	Sets the output ControlNet. More...

void	setIterations (int iterations)
	Sets the number of iterations taken by the BundleAdjust. More...

void	setObservations (BundleObservationVector observations)
	Sets the vector of BundleObservations. More...

QList< Statistics >	rmsImageSampleResiduals () const
	Returns the list of RMS image sample residuals statistics. More...

QList< Statistics >	rmsImageLineResiduals () const
	Returns the list of RMS image line residuals statistics. More...

QList< Statistics >	rmsImageResiduals () const
	Returns the list of RMS image residuals statistics. More...

QVector< Statistics >	rmsImageXSigmas () const
	Returns the list of RMS image x sigma statistics. More...

QVector< Statistics >	rmsImageYSigmas () const
	Returns the list of RMS image y sigma statistics. More...

QVector< Statistics >	rmsImageZSigmas () const
	Returns the list of RMS image z sigma statistics. More...

QVector< Statistics >	rmsImageRASigmas () const
	Returns the list of RMS image right ascension sigma statistics. More...

QVector< Statistics >	rmsImageDECSigmas () const
	Returns the list of RMS image declination sigma statistics. More...

QVector< Statistics >	rmsImageTWISTSigmas () const
	Returns the list of RMS image twist sigma statistics. More...

Distance	minSigmaLatitudeDistance () const
	Returns the minimum sigma latitude distance. More...

Distance	maxSigmaLatitudeDistance () const
	Returns the maximum sigma latitude distance. More...

Distance	minSigmaLongitudeDistance () const
	Returns the minimum sigma longitude distance. More...

Distance	maxSigmaLongitudeDistance () const
	Returns the maximum sigma longitude distance. More...

Distance	minSigmaRadiusDistance () const
	Returns the minimum sigma redius distance. More...

Distance	maxSigmaRadiusDistance () const
	Returns the maximum sigma redius distance. More...

QString	maxSigmaLatitudePointId () const
	Returns the maximum sigma latitude point id. More...

QString	minSigmaLatitudePointId () const
	Returns the minimum sigma latitude point id. More...

QString	minSigmaLongitudePointId () const
	Returns the minimum sigma longitude point id. More...

QString	maxSigmaLongitudePointId () const
	Returns the maximum sigma longitude point id. More...

QString	minSigmaRadiusPointId () const
	Returns the minimum sigma radius point id. More...

QString	maxSigmaRadiusPointId () const
	Returns the maximum sigma radius point id. More...

double	sigmaLatitudeStatisticsRms () const
	Returns the RMS of the adjusted latitude sigmas. More...

double	sigmaLongitudeStatisticsRms () const
	Returns the RMS of the adjusted longitude sigmas. More...

double	sigmaRadiusStatisticsRms () const
	Returns the RMS of the adjusted raidus sigmas. More...

double	rmsRx () const
	Returns the RMS of the x residuals. More...

double	rmsRy () const
	Returns the RMS of the y residuals. More...

double	rmsRxy () const
	Returns the RMS of the x and y residuals. More...

double	rejectionLimit () const
	Returns the rejection limit. More...

double	radiansToMeters () const
	Returns the radians to meters conversion factor for the target body. More...

int	numberRejectedObservations () const
	Returns the number of observation that were rejected. More...

int	numberObservations () const
	Returns the number of observations. More...

int	numberImageParameters () const
	Returns the total number of image parameters. More...

int	numberConstrainedPointParameters () const
	Returns the number of constrained point parameters. More...

int	numberConstrainedImageParameters () const
	Returns the number of constrained image parameters. More...

int	numberConstrainedTargetParameters () const
	Return the number of constrained target parameters. More...

int	numberUnknownParameters () const
	Returns the number of unknown parameters. More...

int	degreesOfFreedom () const
	Returns the degrees of freedom. More...

double	sigma0 () const
	Returns the Sigma0 of the bundle adjustment. More...

double	elapsedTime () const
	Returns the elapsed time for the bundle adjustment. More...

double	elapsedTimeErrorProp () const
	Returns the elapsed time for error propagation. More...

bool	converged () const
	Returns whether or not the bundle adjustment converged. More...

QVector< BundleControlPointQsp > &	bundleControlPoints ()
	Returns a reference to the BundleControlPoint vector. More...

ControlNetQsp	outputControlNet () const
	Returns a shared pointer to the output control network. More...

int	iterations () const
	Returns the number of iterations taken by the BundleAdjust. More...

const BundleObservationVector &	observations () const
	Returns a reference to the observations used by the BundleAdjust. More...

int	numberMaximumLikelihoodModels () const
	Returns how many maximum likelihood models were used in the bundle adjustment. More...

int	maximumLikelihoodModelIndex () const
	Returns which step the bundle adjustment is on. More...

StatCumProbDistDynCalc	cumulativeProbabilityDistribution () const
	Returns the cumulative probability distribution of the \|R^2 residuals\|. More...

StatCumProbDistDynCalc	residualsCumulativeProbabilityDistribution () const
	Returns the cumulative probability distribution of the residuals used for reporting. More...

double	maximumLikelihoodMedianR2Residuals () const
	Returns the median of the \|R^2 residuals\|. More...

MaximumLikelihoodWFunctions	maximumLikelihoodModelWFunc (int modelIndex) const
	Returns the maximum likelihood model at the given index. More...

double	maximumLikelihoodModelQuantile (int modelIndex) const
	Returns the quantile of the maximum likelihood model at the given index. More...

QList< QPair < MaximumLikelihoodWFunctions, double > >	maximumLikelihoodModels () const

bool	setNumberHeldImages (SerialNumberList pHeldSnList, SerialNumberList *pSnList)

PvlObject	pvlObject (QString name="BundleResults") const
	Saves the BundleResults object as a PvlObject. More...

CorrelationMatrix	correlationMatrix () const
	Returns the Correlation Matrix. More...

void	setCorrMatCovFileName (FileName name)
	Set the covariance file name for the matrix used to calculate the correlation matrix. More...

void	setCorrMatImgsAndParams (QMap< QString, QStringList > imgsAndParams)
	Set the images and their associated parameters of the correlation matrix. More...

void	save (QXmlStreamWriter &stream, const Project *project) const
	Saves the BundleResults object to an XML file. More...

QDataStream &	write (QDataStream &stream) const
	Writes the BundleResults object to a QDataStream. More...

QDataStream &	read (QDataStream &stream)
	Reads the data from a QDataStream into the BundleResults object. More...

void	createH5Group (hid_t locationId, QString locationName) const

void	parseH5Group (hid_t locationId, QString locationName)

void	createH5Group (H5::CommonFG &locationObject, QString locationName) const
	Saves an hdf5 group. More...

void	openH5Group (H5::CommonFG &locationObject, QString locationName)
	Reads from an hdf5 group. More...

	BundleResults (H5::CommonFG &locationObject, QString locationName)
	Constructs this BundleSettings object from Hdf5. More...

Detailed Description

A container class for statistical results from a BundleAdjust solution.

Author: 2014-07-01 Jeannie Backer

Constructor & Destructor Documentation

Isis::BundleResults::BundleResults ( QObject * parent = 0 )

Constructs a BundleSettings object.

Parameters

parent The Qt-relationship parent.

References initialize(), and initializeResidualsProbabilityDistribution().

Isis::BundleResults::BundleResults	(	Project *	project,
		XmlStackedHandlerReader *	xmlReader,
		QObject *	parent = `0`
	)

Construct this BundleSettings object from XML.

Parameters

bundleSettingsFolder	Where the settings XML for this bundle adjustment resides - /work/.../projectRoot/images/import1
xmlReader	An XML reader that's up to a <bundleSettings> tag.
parent	The Qt-relationship parent.

References initialize(), and Isis::XmlStackedHandlerReader::pushContentHandler().

Isis::BundleResults::BundleResults ( const BundleResults & src )

Copy constructor for BundleResults.

Creates this BundleSettings object as a copy of another BundleResults object.

Parameters

src	The other BundleResults object to be copied.

Isis::BundleResults::~BundleResults ( )

Destroys this BundleResults object.

Isis::BundleResults::BundleResults	(	H5::CommonFG &	locationObject,
		QString	locationName
	)

Constructs this BundleSettings object from Hdf5.

Parameters

locationObject	The Hdf5 project file to be used.
locationName	The name of the project file containing the BundleResults.

See Also: openH5Group

References openH5Group().

Member Function Documentation

void Isis::BundleResults::addProbabilityDistributionObservation ( double observationValue )

Adds an observation to the cumulative probability distribution of |R^2 residuals|.

Parameters

observationValue The value of the added observation.

References Isis::StatCumProbDistDynCalc::addObs().

void Isis::BundleResults::addProbabilityDistributionObservation	(	double	obsValue,
		bool	residuals
	)

void Isis::BundleResults::addResidualsProbabilityDistributionObservation ( double observationValue )

Adds an observation to the cumulative probability distribution of residuals used for reporting.

Parameters

observationValue The value of the added observation.

References Isis::StatCumProbDistDynCalc::addObs().

QVector< BundleControlPointQsp > & Isis::BundleResults::bundleControlPoints ( )

Returns a reference to the BundleControlPoint vector.

Returns: QVector<BundleControlPointQsp>& The BundleControlPoint vector.

Referenced by Isis::BundleSolutionInfo::outputPointsCSV(), Isis::BundleSolutionInfo::outputResiduals(), and Isis::BundleSolutionInfo::outputText().

void Isis::BundleResults::computeDegreesOfFreedom ( )

Computes the degrees of freedom of the bundle adjustment and stores it internally.

Referenced by computeSigma0().

void Isis::BundleResults::computeSigma0	(	double	dvtpv,
		BundleSettings::ConvergenceCriteria	criteria
	)

Computes the sigma0 and stores it internally.

Parameters

dvtpv	The weighted sum of the squares of the residuals. Computed by V transpose * P * V, where V is the vector of residuals and P is the weight matrix.
criteria	The convergence criteria for the bundle adjustment.

Exceptions

IException::Io "Computed degrees of freedom is invalid."

References _FILEINFO_, computeDegreesOfFreedom(), Isis::IException::Io, Isis::BundleSettings::ParameterCorrections, and Isis::toString().

bool Isis::BundleResults::converged ( ) const

Returns whether or not the bundle adjustment converged.

Returns: bool If the bundle adjustment converged.

Referenced by Isis::JigsawDialog::bundleFinished(), createH5Group(), Isis::BundleSolutionInfo::outputImagesCSV(), Isis::BundleSolutionInfo::outputText(), pvlObject(), save(), and setConverged().

CorrelationMatrix Isis::BundleResults::correlationMatrix ( ) const

Returns the Correlation Matrix.

Returns: CorrelationMatrix The correlation matrix.

Exceptions

IException::Unknown "Correlation matrix for this bundle is NULL."

References _FILEINFO_, and Isis::IException::Unknown.

Referenced by createH5Group(), Isis::ProjectItem::ProjectItem(), pvlObject(), read(), save(), setCorrMatCovFileName(), and setCorrMatImgsAndParams().

void Isis::BundleResults::createH5Group	(	hid_t	locationId,
		QString	locationName
	)		const

Referenced by Isis::BundleSolutionInfo::createH5File().

void Isis::BundleResults::createH5Group	(	H5::CommonFG &	locationObject,
		QString	locationName
	)		const

Saves an hdf5 group.

Parameters

locationObject	The hdf5 group.
localName	The filename for the hdf5 group.

Exceptions

IException::Unknown	"H5 ATTRIBUTE exception handler has detected an error when invoking the function"
IException::Unknown	"Unable to save bundle results information to an HDF5 group."

References _FILEINFO_, Isis::Statistics::compoundH5DataType(), converged(), Isis::CorrelationMatrix::correlationFileName(), correlationMatrix(), Isis::CorrelationMatrix::covarianceFileName(), Isis::FileName::expanded(), and Isis::IException::Unknown.

StatCumProbDistDynCalc Isis::BundleResults::cumulativeProbabilityDistribution ( ) const

Returns the cumulative probability distribution of the |R^2 residuals|.

Returns: StatCumProbDistDynCalc The cumulative probability distribution of the |R^2 residuals|.

Referenced by save().

int Isis::BundleResults::degreesOfFreedom ( ) const

Returns the degrees of freedom.

Returns: int the degrees of freedom.

Referenced by pvlObject(), read(), save(), and setDegreesOfFreedom().

double Isis::BundleResults::elapsedTime ( ) const

Returns the elapsed time for the bundle adjustment.

Returns: double The elapsed time for the bundle adjustment.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), and save().

double Isis::BundleResults::elapsedTimeErrorProp ( ) const

Returns the elapsed time for error propagation.

Returns: double The elapsed time for error propagation.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), and save().

void Isis::BundleResults::incrementFixedPoints ( )

Increase the number of 'fixed' (ground) points.

void Isis::BundleResults::incrementHeldImages ( )

Increases the number of 'held' images.

void Isis::BundleResults::incrementIgnoredPoints ( )

Increase the number of ignored points.

void Isis::BundleResults::incrementMaximumLikelihoodModelIndex ( )

Increases the value that indicates which stage the maximum likelihood adjustment is currently on.

void Isis::BundleResults::incrementNumberConstrainedImageParameters ( int incrementAmount )

Increase the number of constrained image parameters.

Parameters

incrementAmount The amount to increase by.

void Isis::BundleResults::incrementNumberConstrainedPointParameters ( int incrementAmount )

Increase the number of contrained point parameters.

Parameters

incrementAmount The amount to increase by.

void Isis::BundleResults::incrementNumberConstrainedTargetParameters ( int incrementAmount )

Increases the number of constrained target parameters.

Parameters

incrementAmount The amount to increase by.

void Isis::BundleResults::initialize ( )

Initializes the BundleResults to a default state where all numeric members are set to 0 or another default value, all QString members are set to empty, all QVectors and QLists are cleared, and all other members are set to NULL.

References Isis::Distance::setMeters().

Referenced by BundleResults().

void Isis::BundleResults::initializeProbabilityDistribution ( unsigned int nodes = 20 )

Initializes or resets the cumulative probability distribution of |R^2 residuals|.

Parameters

nodes The number of quantiles in the cumulative probability distribution.

References Isis::StatCumProbDistDynCalc::setQuantiles().

Referenced by maximumLikelihoodSetUp(), and printMaximumLikelihoodTierInformation().

void Isis::BundleResults::initializeResidualsProbabilityDistribution ( unsigned int nodes = 20 )

Initializes or resets the cumulative probability distribution of residuals used for reporting.

Parameters

nodes The number of quantiles in the cumulative probability distribution.

References Isis::StatCumProbDistDynCalc::setQuantiles().

Referenced by BundleResults(), and maximumLikelihoodSetUp().

int Isis::BundleResults::iterations ( ) const

Returns the number of iterations taken by the BundleAdjust.

Returns: int The number of iterations.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), and setIterations().

double Isis::BundleResults::maximumLikelihoodMedianR2Residuals ( ) const

Returns the median of the |R^2 residuals|.

Returns: double The median of the |R^2 residuals|.

Referenced by save().

int Isis::BundleResults::maximumLikelihoodModelIndex ( ) const

Returns which step the bundle adjustment is on.

Returns: int The maximum likelihood model that the bundle adjustment is currently using.

Referenced by save().

double Isis::BundleResults::maximumLikelihoodModelQuantile ( int modelIndex ) const

Returns the quantile of the maximum likelihood model at the given index.

Parameters

modelIndex The index of the maximum likelihood model whose quantile will be returned.

Returns: double The quantile of the desired maximum likelihood model.

Referenced by Isis::BundleSolutionInfo::outputHeader().

QList< QPair< MaximumLikelihoodWFunctions, double > > Isis::BundleResults::maximumLikelihoodModels ( ) const

MaximumLikelihoodWFunctions Isis::BundleResults::maximumLikelihoodModelWFunc ( int modelIndex ) const

Returns the maximum likelihood model at the given index.

Parameters

modelIndex The index of the maximum likelihood model to be returned.

Returns: MaximumLikelihoodWFunctions The maximum likelihood model at the input index.

Referenced by Isis::BundleSolutionInfo::outputHeader().

void Isis::BundleResults::maximumLikelihoodSetUp ( QList< QPair< MaximumLikelihoodWFunctions::Model, double > > modelsWithQuantiles )

This method steps up the maximum likelihood estimation solution.

Up to three successive solutions models are available.

Parameters

modelsWithQuantiles The maixmum likelihood models and their quantiles. If empty, then maximum likelihood estimation will not be used.

References initializeProbabilityDistribution(), and initializeResidualsProbabilityDistribution().

Distance Isis::BundleResults::maxSigmaLatitudeDistance ( ) const

Returns the maximum sigma latitude distance.

Returns: Distance The maximum sigma latitude.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), read(), and save().

QString Isis::BundleResults::maxSigmaLatitudePointId ( ) const

Returns the maximum sigma latitude point id.

Returns: The maximum sigma latitude point id.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), and save().

Distance Isis::BundleResults::maxSigmaLongitudeDistance ( ) const

Returns the maximum sigma longitude distance.

Returns: Distance The maximum sigma longitude.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), read(), and save().

QString Isis::BundleResults::maxSigmaLongitudePointId ( ) const

Returns the maximum sigma longitude point id.

Returns: The maximum sigma longitude point id.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), and save().

Distance Isis::BundleResults::maxSigmaRadiusDistance ( ) const

Returns the maximum sigma redius distance.

Returns: Distance The maximum sigma radius.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), read(), and save().

QString Isis::BundleResults::maxSigmaRadiusPointId ( ) const

Returns the maximum sigma radius point id.

Returns: The maximum sigma radius point id.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), and save().

Distance Isis::BundleResults::minSigmaLatitudeDistance ( ) const

Returns the minimum sigma latitude distance.

Returns: Distance The minimum sigma latitude.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), read(), and save().

QString Isis::BundleResults::minSigmaLatitudePointId ( ) const

Returns the minimum sigma latitude point id.

Returns: The minimum sigma latitude point id.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), and save().

Distance Isis::BundleResults::minSigmaLongitudeDistance ( ) const

Returns the minimum sigma longitude distance.

Returns: Distance The minimum sigma longitude.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), read(), and save().

QString Isis::BundleResults::minSigmaLongitudePointId ( ) const

Returns the minimum sigma longitude point id.

Returns: The minimum sigma longitude point id.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), and save().

Distance Isis::BundleResults::minSigmaRadiusDistance ( ) const

Returns the minimum sigma redius distance.

Returns: Distance The minimum sigma redius.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), read(), and save().

QString Isis::BundleResults::minSigmaRadiusPointId ( ) const

Returns the minimum sigma radius point id.

Returns: The minimum sigma radius point id.

Referenced by Isis::BundleSolutionInfo::outputText(), pvlObject(), and save().

int Isis::BundleResults::numberConstrainedImageParameters ( ) const

Returns the number of constrained image parameters.

Returns: int The number of constrained image parameters.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), read(), and save().

int Isis::BundleResults::numberConstrainedPointParameters ( ) const

Returns the number of constrained point parameters.

Returns: int The number of constrained point parameters.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), read(), and save().

int Isis::BundleResults::numberConstrainedTargetParameters ( ) const

Return the number of constrained target parameters.

Returns: int The number of constrained target parameters.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), read(), and save().

int Isis::BundleResults::numberFixedPoints ( ) const

Returns the number of 'fixed' (ground) points.

Returns: int The number of fixed points.

Referenced by pvlObject(), read(), and save().

int Isis::BundleResults::numberHeldImages ( ) const

Returns the number of 'held' images.

Returns: int The number of held images.

Referenced by pvlObject(), read(), and save().

int Isis::BundleResults::numberIgnoredPoints ( ) const

Returns the number of ignored points.

Returns: int The number of ignored points.

Referenced by pvlObject(), read(), and save().

int Isis::BundleResults::numberImageParameters ( ) const

Returns the total number of image parameters.

Returns: int The total number of image parameters.

Referenced by pvlObject(), read(), and save().

int Isis::BundleResults::numberMaximumLikelihoodModels ( ) const

Returns how many maximum likelihood models were used in the bundle adjustment.

Returns: int The number fo maximum likelihood models.

Referenced by printMaximumLikelihoodTierInformation(), pvlObject(), and save().

int Isis::BundleResults::numberObservations ( ) const

Returns the number of observations.

Returns: int The number of observations.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), read(), save(), and setNumberObservations().

int Isis::BundleResults::numberRejectedObservations ( ) const

Returns the number of observation that were rejected.

Returns: int The number of rejected observations.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), read(), save(), and setNumberRejectedObservations().

int Isis::BundleResults::numberUnknownParameters ( ) const

Returns the number of unknown parameters.

Returns: int The number of unknown parameters.

Referenced by Isis::BundleSolutionInfo::outputHeader(), pvlObject(), read(), and save().

const BundleObservationVector & Isis::BundleResults::observations ( ) const

Returns a reference to the observations used by the BundleAdjust.

Returns: BundleObservationVector& A reference to the observation vector.

Referenced by Isis::BundleSolutionInfo::outputHeader(), Isis::BundleSolutionInfo::outputImagesCSV(), Isis::BundleSolutionInfo::outputText(), and setObservations().

void Isis::BundleResults::openH5Group	(	H5::CommonFG &	locationObject,
		QString	locationName
	)

Reads from an hdf5 group.

Parameters

locationObject	The hdf5 group.
locationName	The filename of the hdf5 group.

Exceptions

IException::Unknown	"H5 GENERAL exception handler has detected an error when invoking the function"
IException::Unknown	"Unable to read bundle results information to an HDF5 group."

References _FILEINFO_, Isis::Statistics::compoundH5DataType(), Isis::CorrelationMatrix::setCorrelationFileName(), Isis::CorrelationMatrix::setCovarianceFileName(), and Isis::IException::Unknown.

Referenced by BundleResults(), and Isis::BundleSolutionInfo::openH5File().

BundleResults & Isis::BundleResults::operator= ( const BundleResults & src )

Assignment operator for BundleResults.

Overwrites this BundleResults object with another BundleResults object.

Parameters

src	The other BundleResults object to be copied from.

ControlNetQsp Isis::BundleResults::outputControlNet ( ) const

Returns a shared pointer to the output control network.

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

Exceptions

IException::Programmer "Output Control Network has not been set."

References _FILEINFO_, and Isis::IException::Programmer.

Referenced by Isis::BundleSolutionInfo::outputHeader().

void Isis::BundleResults::parseH5Group	(	hid_t	locationId,
		QString	locationName
	)

void Isis::BundleResults::printMaximumLikelihoodTierInformation ( )

Prints out information about which tier the solution is in and the status of the residuals.

References initializeProbabilityDistribution(), numberMaximumLikelihoodModels(), and Isis::StatCumProbDistDynCalc::value().

PvlObject Isis::BundleResults::pvlObject ( QString name = "BundleResults" ) const

Saves the BundleResults object as a PvlObject.

Parameters

name	The name of the PvlObject to save to.

Returns: PvlObject A PvlObject containing the BundleResults object's information.

References Isis::PvlKeyword::addValue(), converged(), correlationMatrix(), degreesOfFreedom(), elapsedTime(), elapsedTimeErrorProp(), iterations(), maxSigmaLatitudeDistance(), maxSigmaLatitudePointId(), maxSigmaLongitudeDistance(), maxSigmaLongitudePointId(), maxSigmaRadiusDistance(), maxSigmaRadiusPointId(), minSigmaLatitudeDistance(), minSigmaLatitudePointId(), minSigmaLongitudeDistance(), minSigmaLongitudePointId(), minSigmaRadiusDistance(), minSigmaRadiusPointId(), Isis::MaximumLikelihoodWFunctions::modelToString(), numberConstrainedImageParameters(), numberConstrainedPointParameters(), numberConstrainedTargetParameters(), numberFixedPoints(), numberHeldImages(), numberIgnoredPoints(), numberImageParameters(), numberMaximumLikelihoodModels(), numberObservations(), numberRejectedObservations(), numberUnknownParameters(), Isis::CorrelationMatrix::pvlObject(), radiansToMeters(), rejectionLimit(), rmsRx(), rmsRxy(), rmsRy(), sigma0(), sigmaLatitudeStatisticsRms(), sigmaLongitudeStatisticsRms(), sigmaRadiusStatisticsRms(), and Isis::toString().

Referenced by Isis::BundleSolutionInfo::pvlObject().

double Isis::BundleResults::radiansToMeters ( ) const

Returns the radians to meters conversion factor for the target body.

Returns: double The conversion factor.

Referenced by Isis::BundleSolutionInfo::outputPointsCSV(), Isis::BundleSolutionInfo::outputText(), and pvlObject().

QDataStream & Isis::BundleResults::read ( QDataStream & stream )

Reads the data from a QDataStream into the BundleResults object.

Parameters

stream The QDataStream to read from.

Returns: QDataStream& A reference to the stream after reading from it.

References correlationMatrix(), degreesOfFreedom(), maxSigmaLatitudeDistance(), maxSigmaLongitudeDistance(), maxSigmaRadiusDistance(), minSigmaLatitudeDistance(), minSigmaLongitudeDistance(), minSigmaRadiusDistance(), numberConstrainedImageParameters(), numberConstrainedPointParameters(), numberConstrainedTargetParameters(), numberFixedPoints(), numberHeldImages(), numberIgnoredPoints(), numberImageParameters(), numberObservations(), numberRejectedObservations(), numberUnknownParameters(), and Isis::Distance::setMeters().

Referenced by Isis::operator>>().

double Isis::BundleResults::rejectionLimit ( ) const

Returns the rejection limit.

Returns: double The rejection limit.

Referenced by pvlObject(), save(), and setRejectionLimit().

void Isis::BundleResults::resetNumberConstrainedImageParameters ( )

Resets the number of constrained image parameters to 0.

void Isis::BundleResults::resetNumberConstrainedPointParameters ( )

Resets the number of contrained point parameters to 0.

void Isis::BundleResults::resetNumberConstrainedTargetParameters ( )

Resets the number of constrained target parameters to 0.

StatCumProbDistDynCalc Isis::BundleResults::residualsCumulativeProbabilityDistribution ( ) const

Returns the cumulative probability distribution of the residuals used for reporting.

Returns: StatCumProbDistDynCalc the cumulative probability distribution of the residuals.

Referenced by Isis::BundleSolutionInfo::outputHeader(), and save().

void Isis::BundleResults::resizeSigmaStatisticsVectors ( int numberImages )

Resizes all image sigma vectors.

Parameters

numberImages The new size for the image sigma vectors.

QVector< Statistics > Isis::BundleResults::rmsImageDECSigmas ( ) const

Returns the list of RMS image declination sigma statistics.

Returns: QList<Statistics> The RMS image declination sigma statistics.

Referenced by save().

QList< Statistics > Isis::BundleResults::rmsImageLineResiduals ( ) const

Returns the list of RMS image line residuals statistics.

Returns: QList<Statistics> The RMS image line residual statistics.

Referenced by Isis::BundleSolutionInfo::outputImagesCSV(), save(), and setRmsImageResidualLists().

QVector< Statistics > Isis::BundleResults::rmsImageRASigmas ( ) const

Returns the list of RMS image right ascension sigma statistics.

Returns: QList<Statistics> The RMS image right ascension sigma statistics.

Referenced by save().

QList< Statistics > Isis::BundleResults::rmsImageResiduals ( ) const

Returns the list of RMS image residuals statistics.

Returns: QList<Statistics> The RMS image residual statistics.

Referenced by Isis::BundleSolutionInfo::outputImagesCSV(), save(), and setRmsImageResidualLists().

QList< Statistics > Isis::BundleResults::rmsImageSampleResiduals ( ) const

Returns the list of RMS image sample residuals statistics.

Returns: QList<Statistics> The RMS image sample residual statistics.

Referenced by Isis::BundleSolutionInfo::outputImagesCSV(), save(), and setRmsImageResidualLists().

QVector< Statistics > Isis::BundleResults::rmsImageTWISTSigmas ( ) const

Returns the list of RMS image twist sigma statistics.

Returns: QList<Statistics> The RMS image twist sigma statistics.

Referenced by save().

QVector< Statistics > Isis::BundleResults::rmsImageXSigmas ( ) const

Returns the list of RMS image x sigma statistics.

Returns: QList<Statistics> The RMS image x sigma statistics.

Referenced by save().

QVector< Statistics > Isis::BundleResults::rmsImageYSigmas ( ) const

Returns the list of RMS image y sigma statistics.

Returns: QList<Statistics> The RMS image y sigma statistics.

Referenced by save().

QVector< Statistics > Isis::BundleResults::rmsImageZSigmas ( ) const

Returns the list of RMS image z sigma statistics.

Returns: QList<Statistics> The RMS image z sigma statistics.

Referenced by save().

double Isis::BundleResults::rmsRx ( ) const

Returns the RMS of the x residuals.

Returns: double The RMS of the x residuals.

Referenced by pvlObject(), and save().

double Isis::BundleResults::rmsRxy ( ) const

Returns the RMS of the x and y residuals.

Returns: double The RMS of the x and y residuals.

Referenced by pvlObject(), and save().

double Isis::BundleResults::rmsRy ( ) const

Returns the RMS of the y residuals.

Returns: double The RMS of the y residuals.

Referenced by pvlObject(), and save().

void Isis::BundleResults::save	(	QXmlStreamWriter &	stream,
		const Project *	project
	)		const

Saves the BundleResults object to an XML file.

Parameters

stream	The QXMLStreamWriter that will be used to write out the XML file.
project	The project that the BundleResults object belongs to.

References converged(), correlationMatrix(), cumulativeProbabilityDistribution(), degreesOfFreedom(), elapsedTime(), elapsedTimeErrorProp(), maximumLikelihoodMedianR2Residuals(), maximumLikelihoodModelIndex(), maxSigmaLatitudeDistance(), maxSigmaLatitudePointId(), maxSigmaLongitudeDistance(), maxSigmaLongitudePointId(), maxSigmaRadiusDistance(), maxSigmaRadiusPointId(), minSigmaLatitudeDistance(), minSigmaLatitudePointId(), minSigmaLongitudeDistance(), minSigmaLongitudePointId(), minSigmaRadiusDistance(), minSigmaRadiusPointId(), Isis::MaximumLikelihoodWFunctions::modelToString(), numberConstrainedImageParameters(), numberConstrainedPointParameters(), numberConstrainedTargetParameters(), numberFixedPoints(), numberHeldImages(), numberIgnoredPoints(), numberImageParameters(), numberMaximumLikelihoodModels(), numberObservations(), numberRejectedObservations(), numberUnknownParameters(), rejectionLimit(), residualsCumulativeProbabilityDistribution(), rmsImageDECSigmas(), rmsImageLineResiduals(), rmsImageRASigmas(), rmsImageResiduals(), rmsImageSampleResiduals(), rmsImageTWISTSigmas(), rmsImageXSigmas(), rmsImageYSigmas(), rmsImageZSigmas(), rmsRx(), rmsRxy(), rmsRy(), Isis::StatCumProbDistDynCalc::save(), sigma0(), sigmaLatitudeStatisticsRms(), sigmaLongitudeStatisticsRms(), sigmaRadiusStatisticsRms(), and Isis::toString().

Referenced by Isis::BundleSolutionInfo::save().

void Isis::BundleResults::setBundleControlPoints ( QVector< BundleControlPointQsp > controlPoints )

Sets the bundle control point vector.

Parameters

controlPoints The vector of BundleControlPointQsps.

void Isis::BundleResults::setConverged ( bool converged )

Sets if the bundle adjustment converged.

Parameters

converged If the bundle adjustment converged.

References converged().

void Isis::BundleResults::setCorrMatCovFileName ( FileName name )

Set the covariance file name for the matrix used to calculate the correlation matrix.

Parameters

name	The name of the file used to store the covariance matrix.

References correlationMatrix(), and Isis::CorrelationMatrix::setCovarianceFileName().

void Isis::BundleResults::setCorrMatImgsAndParams ( QMap< QString, QStringList > imgsAndParams )

Set the images and their associated parameters of the correlation matrix.

Parameters

imgsAndParams The QMap with all the images and parameters used for this bundle.

References correlationMatrix(), and Isis::CorrelationMatrix::setImagesAndParameters().

Referenced by Isis::BundleSolutionInfo::outputText().

void Isis::BundleResults::setDegreesOfFreedom ( double degreesOfFreedom )

Sets the degrees of freedom.

Parameters

degreesOfFreedom The degrees of freedom.

References degreesOfFreedom().

void Isis::BundleResults::setElapsedTime ( double time )

Sets the elapsed time for the bundle adjustment.

Parameters

time	The elapsed time.

void Isis::BundleResults::setElapsedTimeErrorProp ( double time )

Sets the elapsed time for error propegation.

Parameters

time	The elapsed time.

void Isis::BundleResults::setIterations ( int iterations )

Sets the number of iterations taken by the BundleAdjust.

Parameters

iterations The number of iterations.

References iterations().

bool Isis::BundleResults::setNumberHeldImages	(	SerialNumberList	pHeldSnList,
		SerialNumberList *	pSnList
	)

void Isis::BundleResults::setNumberImageParameters ( int numberParameters )

Sets the number of image parameters.

Parameters

numberParameters The number of image parameters.

void Isis::BundleResults::setNumberObservations ( int numberObservations )

Sets the number of observations.

Parameters

numberObservations The number of observations.

References numberObservations().

void Isis::BundleResults::setNumberRejectedObservations ( int numberRejectedObservations )

Sets the number of rejected observations.

Parameters

numberRejectedObservations The number of rejected observations.

References numberRejectedObservations().

void Isis::BundleResults::setNumberUnknownParameters ( int numberParameters )

Sets the total number of parameters to solve for.

Parameters

numberParameters The number of parameters to solve for.

void Isis::BundleResults::setObservations ( BundleObservationVector observations )

Sets the vector of BundleObservations.

Parameters

observations The vector of BundleObservations.

References observations().

void Isis::BundleResults::setOutputControlNet ( ControlNetQsp outNet )

Sets the output ControlNet.

Parameters

outNet A QSharedPointer to the output ControlNet.

void Isis::BundleResults::setRadiansToMeters ( double rtm )

Sets the radians to meters conversion constant for the target body.

Parameters

rtm	The (double) conversion factor.

void Isis::BundleResults::setRejectionLimit ( double rejectionLimit )

Sets the rejection limit.

Parameters

rejectionLimit The rejection limit.

References rejectionLimit().

void Isis::BundleResults::setRmsFromSigmaStatistics	(	double	rmsFromSigmaLatStats,
		double	rmsFromSigmaLonStats,
		double	rmsFromSigmaRadStats
	)

Sets the root mean square values of the adjusted latitiude sigmas, adjusted longitude sigmas, and adjusted radius sigmas.

Parameters

rmsFromSigmaLatStats	The new RMS value of the adjusted latitude sigmas.
rmsFromSigmaLonStats	The new RMS value of the adjusted longitude sigmas.
rmsFromSigmaRadStats	The new RMS value of the adjusted radius sigmas.

void Isis::BundleResults::setRmsImageResidualLists	(	QList< Statistics >	rmsImageLineResiduals,
		QList< Statistics >	rmsImageSampleResiduals,
		QList< Statistics >	rmsImageResiduals
	)

Sets the root mean square image residual Statistics lists.

Parameters

rmsImageLineResiduals	The new image line residuals list.
rmsImageSampleResiduals	The new image sample residuals list.
rmsImageResiduals	The new image residuals list.

References rmsImageLineResiduals(), rmsImageResiduals(), and rmsImageSampleResiduals().

void Isis::BundleResults::setRmsImageResidualLists	(	QVector< Statistics >	rmsImageLineResiduals,
		QVector< Statistics >	rmsImageSampleResiduals,
		QVector< Statistics >	rmsImageResiduals
	)

void Isis::BundleResults::setRmsXYResiduals	(	double	rx,
		double	ry,
		double	rxy
	)

Sets the root mean square of the x and y residuals.

Parameters

rx	The RMS value of the x residuals.
ry	The RMS value of the y residuals.
rxy	The RMS value of both the x and y residuals.

void Isis::BundleResults::setSigma0 ( double sigma0 )

Sets the sigma0.

Parameters

sigma0 The sigma0.

References sigma0().

void Isis::BundleResults::setSigmaLatitudeRange	(	Distance	minLatDist,
		Distance	maxLatDist,
		QString	minLatPointId,
		QString	maxLatPointId
	)

Sets the min and max sigma latitude distances and point ids.

Parameters

minLatDist	The new minimum sigma latitude distance.
maxLatDist	The new maximum sigma latitude distance.
minLatPointId	The new minimum sigma latitude point id.
maxLatPointId	The new maximum sigma latitude point id.

void Isis::BundleResults::setSigmaLongitudeRange	(	Distance	minLonDist,
		Distance	maxLonDist,
		QString	minLonPointId,
		QString	maxLonPointId
	)

Sets the min and max sigma longitude distances and point ids.

Parameters

minLonDist	The new minimum sigma longitude distance.
maxLonDist	The new maximum sigma longitude distance.
minLonPointId	The new minimum sigma longitude point id.
maxLonPointId	The new maximum sigma longitude point id.

void Isis::BundleResults::setSigmaRadiusRange	(	Distance	minRadDist,
		Distance	maxRadDist,
		QString	minRadPointId,
		QString	maxRadPointId
	)

Sets the min and max sigma radius distances and point ids.

Parameters

minRadDist	The new minimum sigma radius distance.
maxRadDist	The new maximum sigma radius distance.
minRadPointId	The new minimum sigma radius point id.
maxRadPointId	The new maximum sigma radius point id.