Class for bundle observations. More...

#include <BundleObservation.h>

Inheritance diagram for Isis::BundleObservation:

Collaboration diagram for Isis::BundleObservation:

Public Member Functions
	BundleObservation ()
	Constructs a BundleObservation initialized to a default state. More...

	BundleObservation (BundleImageQsp image, QString observationNumber, QString instrumentId, BundleTargetBodyQsp bundleTargetBody)
	Constructs a BundleObservation from an BundleImage, an instrument id, an observation number to assign to this BundleObservation, and a target body. More...

	BundleObservation (const BundleObservation &src)
	Creates a copy of another BundleObservation. More...

	~BundleObservation ()
	Destructor. More...

BundleObservation &	operator= (const BundleObservation &src)
	Assignment operator. More...

void	copy (const BundleObservation &src)

void	append (const BundleImageQsp &value)
	Appends a BundleImage shared pointer to the BundleObservation. More...

BundleImageQsp	imageByCubeSerialNumber (QString cubeSerialNumber)
	Returns the BundleImage shared pointer associated with the given serial number. More...

bool	setSolveSettings (BundleObservationSolveSettings solveSettings)
	Set solve parameters. More...

void	setIndex (int n)
	Sets the index for the observation. More...

int	index ()
	Accesses the observation's index. More...

int	numberPositionParameters ()
	Returns the number of position parameters there are. More...

int	numberPointingParameters ()
	Returns the number of pointing parameters being solved for. More...

int	numberParameters ()
	Returns the number of total parameters there are for solving. More...

QString	instrumentId ()
	Accesses the instrument id. More...

SpiceRotation *	spiceRotation ()
	Accesses the instrument's spice rotation. More...

SpicePosition *	spicePosition ()
	Accesses the instrument's spice position. More...

LinearAlgebra::Vector &	parameterWeights ()
	Accesses the solve parameter weights. More...

LinearAlgebra::Vector &	parameterCorrections ()
	Accesses the parameter corrections. More...

LinearAlgebra::Vector &	aprioriSigmas ()
	Accesses the a priori sigmas. More...

LinearAlgebra::Vector &	adjustedSigmas ()
	Accesses the adjusted sigmas. More...

const BundleObservationSolveSettingsQsp	solveSettings ()
	Accesses the solve settings. More...

bool	applyParameterCorrections (LinearAlgebra::Vector corrections)
	Applies the parameter corrections. More...

bool	initializeExteriorOrientation ()
	Initializes the exterior orientation. More...

void	initializeBodyRotation ()
	Intializes the body rotation. More...

void	updateBodyRotation ()
	Updates the body rotation. More...

QString	formatBundleOutputString (bool errorPropagation, bool imageCSV=false)
	Creates and returns a formatted QString representing the bundle coefficients and parameters. More...

QStringList	parameterList ()
	Access to parameters for CorrelationMatrix to use. More...

QStringList	imageNames ()
	Access to image names for CorrelationMatrix to use. More...

Private Member Functions
bool	initParameterWeights ()
	Initializes the paramater weights for solving. More...

Private Attributes
QString	m_observationNumber
	This is typically equivalent to serial number except in the case of "observation mode" (e.g. More...

int	m_index
	Index of this observation. More...

QMap< QString, BundleImageQsp >	m_cubeSerialNumberToBundleImageMap
	Map between cube serial number and BundleImage pointers. More...

QStringList	m_serialNumbers
	List of all cube serial numbers in observation. More...

QStringList	m_parameterNamesList
	List of all cube parameters. More...

QStringList	m_imageNames
	List of all cube names. More...

QString	m_instrumentId
	Spacecraft instrument id. More...

BundleObservationSolveSettingsQsp	m_solveSettings
	Solve settings for this observation. More...

SpiceRotation *	m_instrumentRotation
	Instrument spice rotation (in primary image). More...

SpicePosition *	m_instrumentPosition
	Instrument spice position (in primary image). More...

BundleTargetBodyQsp	m_bundleTargetBody
	QShared pointer to BundleTargetBody. More...

LinearAlgebra::Vector	m_weights
	Parameter weights. Cumulative parameter correction vector. More...

LinearAlgebra::Vector	m_corrections

LinearAlgebra::Vector	m_aprioriSigmas
	A posteriori (adjusted) parameter sigmas. More...

LinearAlgebra::Vector	m_adjustedSigmas
	A posteriori (adjusted) parameter sigmas. More...

Detailed Description

Class for bundle observations.

This class is used for creating a bundle observation. Contained BundleImages are stored as shared pointers, so they will be automatically deleted when all shared pointers are deleted.

Author: 2014-07-09 Ken Edmundson

History:

2014-07-09 Ken Edmundson - Original version.

2014-07-16 Jeannie Backer - Replaced QVectors with QLists.

2014-07-17 Kimberly Oyama - Added member variables and accessors for the images and parameters in this observation. They will be used for the correlation matrix.

2014-07-23 Jeannie Backer - Replaced QVectors with QLists.

2015-02-20 Jeannie Backer - Brought closer to Isis coding standards.

2016-08-03 Jesse Mapel - Changed contained member type to a QSharedPointer. Also changed m_solveSettings to a QSharedPointer. Fixes #4150.

2016-08-03 Ian Humphrey - Updated documentation and coding standards. Fixes #4078.

2016-08-10 Jeannie Backer - Replaced boost vector with Isis::LinearAlgebra::Vector. References #4163.

2016-08-15 Jesse Mapel - Added a map between cube serial number and contained bundle image. References #4159.

2016-08-23 Ian Humphrey - The applyParameterCorrections() method now throws the last exception. Fixes #4153.

2016-10-06 Tyler Wilson - Modified the function formatBundleOutputString so that it can be used by BundleSolutionInfo::outputCSVImages() function. Fixes #4314.

2016-10-26 Ian Humphrey - Modified formatBundleOutputString() to provided default values for all solve parameters, whether they are being solved for or not. Fixes #4464.

2016-10-27 Tyler Wilson Modified formatBundleOutputString to change N/A to FREE in the output under POINTS DETAIL when no lat/lon sigmas were entered. Fixes #4317.

2016-11-14 Ken Edmundson Modified the following... -changed adjustedSigma from 0.0 to N/A if error propagation is off when writing bundleout.txt OR images.csv. -changed sigma default from -1.0 to N/A for position and pointing parameters when writing images.csv.

Definition at line 81 of file BundleObservation.h.

Constructor & Destructor Documentation

Isis::BundleObservation::BundleObservation ( )

Constructs a BundleObservation initialized to a default state.

Definition at line 22 of file BundleObservation.cpp.

Isis::BundleObservation::BundleObservation	(	BundleImageQsp	image,
		QString	observationNumber,
		QString	instrumentId,
		BundleTargetBodyQsp	bundleTargetBody
	)

Constructs a BundleObservation from an BundleImage, an instrument id, an observation number to assign to this BundleObservation, and a target body.

Parameters

image	QSharedPointer to the primary image in the observation
observationNumber	Observation number of the observation
instrumentId	Id of the instrument for the observation
bundleTargetBody	QSharedPointer to the target body of the observation

Definition at line 48 of file BundleObservation.cpp.

Isis::BundleObservation::BundleObservation ( const BundleObservation & src )

Creates a copy of another BundleObservation.

Parameters

src	Reference to the BundleObservation to copy

Definition at line 103 of file BundleObservation.cpp.

References m_cubeSerialNumberToBundleImageMap, m_index, m_instrumentId, m_instrumentPosition, m_instrumentRotation, m_observationNumber, m_serialNumbers, and m_solveSettings.

Isis::BundleObservation::~BundleObservation ( )

Destructor.

Contained BundleImages will remain until all shared pointers are deleted.

Definition at line 124 of file BundleObservation.cpp.

Member Function Documentation

LinearAlgebra::Vector & Isis::BundleObservation::adjustedSigmas ( )

Accesses the adjusted sigmas.

Returns: LinearAlgebra::Vector Returns the adjusted sigmas

Definition at line 311 of file BundleObservation.cpp.

void Isis::BundleObservation::append ( const BundleImageQsp & value )

Appends a BundleImage shared pointer to the BundleObservation.

If the pointer is valid, then the BundleImage and its serial number will be inserted into the serial number to BundleImage map.

Parameters

value The BundleImage to be appended.

See Also: QVector::append()

Definition at line 164 of file BundleObservation.cpp.

bool Isis::BundleObservation::applyParameterCorrections ( LinearAlgebra::Vector corrections )

Applies the parameter corrections.

Parameters

corrections Vector of corrections to apply

Exceptions

IException::Unknown	"Instrument position is NULL, but position solve option is [not NoPositionFactors]"
IException::Unknown	"Instrument position is NULL, but pointing solve option is [not NoPointingFactors]"
IException::Unknown	"Unable to apply parameter corrections to BundleObservation."

Returns: bool Returns true upon successful application of corrections

Todo:: always returns true?

Definition at line 618 of file BundleObservation.cpp.

References _FILEINFO_, Isis::SpicePosition::SetPolynomial(), and Isis::SpiceRotation::SetPolynomial().

LinearAlgebra::Vector & Isis::BundleObservation::aprioriSigmas ( )

Accesses the a priori sigmas.

Todo:

Returns: LinearAlgebra::Vector Returns the a priori sigmas

Definition at line 301 of file BundleObservation.cpp.

QString Isis::BundleObservation::formatBundleOutputString	(	bool	errorPropagation,
		bool	imageCSV = `false`
	)

Creates and returns a formatted QString representing the bundle coefficients and parameters.

Parameters

errorPropagation	Boolean indicating whether or not to attach more information (corrections, sigmas, adjusted sigmas...) to the output QString
imageCSV	Boolean which is set to true if the function is being called from BundleSolutionInfo::outputImagesCSV(). It is set to false by default for backwards compatibility.

Returns: QString Returns a formatted QString representing the BundleObservation

History:: 2016-10-26 Ian Humphrey - Default values are now provided for parameters that are not being solved. Fixes #4464.

Definition at line 802 of file BundleObservation.cpp.

References Isis::IsSpecial(), Isis::RAD2DEG(), and Isis::toString().

BundleImageQsp Isis::BundleObservation::imageByCubeSerialNumber ( QString cubeSerialNumber )

Returns the BundleImage shared pointer associated with the given serial number.

If no BundleImage with that serial number is contained a NULL pointer is returned.

Parameters

cubeSerialNumber The serial number of the cube to be returned.

Returns: BundleImageQsp A shared pointer to the BundleImage (NULL if not found).

Definition at line 180 of file BundleObservation.cpp.

QStringList Isis::BundleObservation::imageNames ( )

Access to image names for CorrelationMatrix to use.

Returns: QStringList Returns a QStringList of the image names

Definition at line 1151 of file BundleObservation.cpp.

int Isis::BundleObservation::index ( )

Accesses the observation's index.

Returns: int Returns the observation's index

Definition at line 781 of file BundleObservation.cpp.

void Isis::BundleObservation::initializeBodyRotation ( )

Intializes the body rotation.

Todo:: check to make sure m_bundleTargetBody is valid

Definition at line 420 of file BundleObservation.cpp.

bool Isis::BundleObservation::initializeExteriorOrientation ( )

Initializes the exterior orientation.

Returns: bool Returns true upon successful intialization

Todo:: Should this always return true?

Definition at line 335 of file BundleObservation.cpp.

References Isis::SpiceRotation::GetBaseTime(), Isis::SpiceRotation::GetPolynomial(), Isis::SpiceRotation::GetTimeScale(), Isis::SpicePosition::SetOverrideBaseTime(), Isis::SpiceRotation::SetOverrideBaseTime(), Isis::SpicePosition::SetPolynomial(), Isis::SpiceRotation::SetPolynomial(), Isis::SpicePosition::SetPolynomialDegree(), and Isis::SpiceRotation::SetPolynomialDegree().

bool Isis::BundleObservation::initParameterWeights ( )

private

Initializes the paramater weights for solving.

Returns: bool Returns true upon successful intialization

Todo:: Don't like this, don't like this, don't like this, don't like this, don't like this. By the way, this seems klunky to me, would like to come up with a better way. Also, apriori sigmas are in two places, the BundleObservationSolveSettings AND in the the BundleObservation class too - this is unnecessary should only be in the BundleObservationSolveSettings. But, they are split into position and pointing.

Todo:: always returns true?

Definition at line 512 of file BundleObservation.cpp.

References Isis::DEG2RAD().

QString Isis::BundleObservation::instrumentId ( )

Accesses the instrument id.

Returns: QString Returns the instrument id of the observation

Definition at line 242 of file BundleObservation.cpp.

int Isis::BundleObservation::numberParameters ( )

Returns the number of total parameters there are for solving.

The total number of parameters is equal to the number of position parameters and number of pointing parameters

Returns: int Returns the number of parameters there are

Definition at line 761 of file BundleObservation.cpp.

int Isis::BundleObservation::numberPointingParameters ( )

Returns the number of pointing parameters being solved for.

Returns: int Returns the number of pointing parameters

Definition at line 743 of file BundleObservation.cpp.

int Isis::BundleObservation::numberPositionParameters ( )

Returns the number of position parameters there are.

Returns: int Returns the number of position parameters

Definition at line 733 of file BundleObservation.cpp.

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

Assignment operator.

Assigns the state of the source BundleObservation to this BundleObservation

Parameters

BundleObservation Reference to the source BundleObservation to assign from

Returns: BundleObservation& Reference to this BundleObservation

Definition at line 138 of file BundleObservation.cpp.

References m_cubeSerialNumberToBundleImageMap, m_instrumentId, m_instrumentPosition, m_instrumentRotation, m_observationNumber, m_serialNumbers, and m_solveSettings.

LinearAlgebra::Vector & Isis::BundleObservation::parameterCorrections ( )

Accesses the parameter corrections.

Returns: LinearAlgebra::Vector Returns the parameter corrections

Definition at line 282 of file BundleObservation.cpp.

QStringList Isis::BundleObservation::parameterList ( )

Access to parameters for CorrelationMatrix to use.

Returns: QStringList Returns a QStringList of the names of the parameters

Definition at line 1141 of file BundleObservation.cpp.

LinearAlgebra::Vector & Isis::BundleObservation::parameterWeights ( )

Accesses the solve parameter weights.

Returns: LinearAlgebra::Vector Returns the parameter weights for solving

Definition at line 272 of file BundleObservation.cpp.

void Isis::BundleObservation::setIndex ( int n )

Sets the index for the observation.

Parameters

n	Value to set the index of the observation to

Definition at line 771 of file BundleObservation.cpp.

bool Isis::BundleObservation::setSolveSettings ( BundleObservationSolveSettings solveSettings )

Set solve parameters.

Parameters

solveSettings The solve settings to use

Returns: bool Returns true if settings were successfully set

Todo:: initParameterWeights() doesn't return false, so this methods always returns true.

Definition at line 202 of file BundleObservation.cpp.

References Isis::Null.

const BundleObservationSolveSettingsQsp Isis::BundleObservation::solveSettings ( )

Accesses the solve settings.

Returns: const BundleObservationSolveSettingsQsp Returns a pointer to the solve settings for this BundleObservation

Definition at line 322 of file BundleObservation.cpp.

SpicePosition * Isis::BundleObservation::spicePosition ( )

Accesses the instrument's spice position.

Returns: SpicePosition* Returns the SpicePosition for this observation

Definition at line 262 of file BundleObservation.cpp.

SpiceRotation * Isis::BundleObservation::spiceRotation ( )

Accesses the instrument's spice rotation.

Returns: SpiceRotation* Returns the SpiceRotation for this observation

Definition at line 252 of file BundleObservation.cpp.

void Isis::BundleObservation::updateBodyRotation ( )

Updates the body rotation.

Todo:: Is this a duplicate of initializeBodyRotation?

Definition at line 438 of file BundleObservation.cpp.

Member Data Documentation

LinearAlgebra::Vector Isis::BundleObservation::m_adjustedSigmas

private

A posteriori (adjusted) parameter sigmas.

Definition at line 177 of file BundleObservation.h.

LinearAlgebra::Vector Isis::BundleObservation::m_aprioriSigmas

private

A posteriori (adjusted) parameter sigmas.

Definition at line 175 of file BundleObservation.h.

BundleTargetBodyQsp Isis::BundleObservation::m_bundleTargetBody

private

QShared pointer to BundleTargetBody.

Definition at line 167 of file BundleObservation.h.

QMap<QString, BundleImageQsp> Isis::BundleObservation::m_cubeSerialNumberToBundleImageMap

private

Map between cube serial number and BundleImage pointers.

Definition at line 153 of file BundleObservation.h.

Referenced by BundleObservation(), and operator=().

QStringList Isis::BundleObservation::m_imageNames

private

List of all cube names.

Definition at line 157 of file BundleObservation.h.

int Isis::BundleObservation::m_index

private

Index of this observation.

Definition at line 150 of file BundleObservation.h.

Referenced by BundleObservation().

QString Isis::BundleObservation::m_instrumentId

private

Spacecraft instrument id.

Definition at line 159 of file BundleObservation.h.

Referenced by BundleObservation(), and operator=().

SpicePosition* Isis::BundleObservation::m_instrumentPosition

private

Instrument spice position (in primary image).

Definition at line 164 of file BundleObservation.h.

Referenced by BundleObservation(), and operator=().

SpiceRotation* Isis::BundleObservation::m_instrumentRotation

private

Instrument spice rotation (in primary image).

Definition at line 163 of file BundleObservation.h.

Referenced by BundleObservation(), and operator=().

QString Isis::BundleObservation::m_observationNumber

private

This is typically equivalent to serial number except in the case of "observation mode" (e.g.

Lunar Orbiter) where for each image in the observation, the observation number is the serial number augmented with an additional integer.

Definition at line 144 of file BundleObservation.h.

Referenced by BundleObservation(), and operator=().

QStringList Isis::BundleObservation::m_parameterNamesList

private

List of all cube parameters.

Definition at line 156 of file BundleObservation.h.

QStringList Isis::BundleObservation::m_serialNumbers

private

List of all cube serial numbers in observation.

Definition at line 155 of file BundleObservation.h.

Referenced by BundleObservation(), and operator=().

BundleObservationSolveSettingsQsp Isis::BundleObservation::m_solveSettings

private

Solve settings for this observation.

Definition at line 161 of file BundleObservation.h.

Referenced by BundleObservation(), and operator=().

LinearAlgebra::Vector Isis::BundleObservation::m_weights

private

                                     Parameter weights.

Cumulative parameter correction vector.

Definition at line 170 of file BundleObservation.h.

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

src/control/objs/BundleUtilities/BundleObservation.h
src/control/objs/BundleUtilities/BundleObservation.cpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation