Statistical and similar ControlMeasure associated information. More...

#include <ControlMeasureLogData.h>

Collaboration diagram for Isis::ControlMeasureLogData:

Public Types
enum	NumericLogDataType { InvalidNumericLogDataType = 0, Obsolete_Eccentricity = 1, GoodnessOfFit = 2, MinimumPixelZScore = 3, MaximumPixelZScore = 4, PixelShift = 5, WholePixelCorrelation = 6, SubPixelCorrelation = 7, Obsolete_AverageResidual = 8 }
	Please do not change existing values in this list except the size - it will break backwards compadibility. More...

Public Member Functions
	ControlMeasureLogData ()
	This creates an empty, invalid (IsValid() will return false), instance. More...

	ControlMeasureLogData (NumericLogDataType dataType)
	This creates an instance with the given type but no value yet. More...

	ControlMeasureLogData (PvlKeyword keywordRep)
	This creates an instance while attempting to interpret keywordRep. More...

	ControlMeasureLogData (NumericLogDataType dataType, double value)
	This creates an instance with the given type and value for that type. More...

	ControlMeasureLogData (const ControlMeasureLogData &other)
	Copy constructor. More...

	~ControlMeasureLogData ()
	Destructor. More...

void	SetNumericalValue (double value)
	This updates the value associated with a NumericLogDataType. More...

void	SetDataType (NumericLogDataType newDataType)
	This changes the type of this log data. More...

double	GetNumericalValue () const
	Get the value associated with this log data. More...

NumericLogDataType	GetDataType () const
	Get the data type associated with this log data. More...

QVariant	GetValue () const
	Get the data type associated with this log data. More...

bool	IsValid () const
	This tests if the log data is complete and valid. More...

PvlKeyword	ToKeyword () const
	This converts the log data to a PvlKeyword. More...

NumericLogDataType	NameToDataType (QString name) const
	This converts a string to a log data type and is useful for converting Pvl keywords to Numeric Log Data Type. More...

QString	DataTypeToName (NumericLogDataType type) const
	This converts the log data type to a string and is used internally for convertions to and from Pvl. More...

Static Public Attributes
static const int	MaximumNumericLogDataType = 9
	This value must be > the largest enumerated value in this type or convertions to and from Pvl will not work. More...

Private Member Functions
void	Init ()
	This is a helper method for the constructor that initializes the data to a default, invalid state. More...

Private Attributes
NumericLogDataType	p_dataType
	Which kind of value are we storing. More...

double	p_numericalValue
	The actual value of the data. More...

Detailed Description

Statistical and similar ControlMeasure associated information.

This class represents information that is related to, or associated with, a control measure but is not part of the measure itself.

Author: 2010-12-22 Steven Lambright

See also: ControlMeasure

History:

2010-12-22 Steven Lambright - Original version

2011-03-08 Eric Hyer - MaximumNumericLogDataType now makes sense

2011-04-04 Steven Lambright - Added error checking to the conversion to protocol buffer

2011-04-11 Steven Lambright - Added GetValue method

2017-12-21 Adam Goins - Removed protobuf references.

2018-01-04 Adam Goins - Added variable names to method declarations.

Definition at line 51 of file ControlMeasureLogData.h.

Member Enumeration Documentation

◆ NumericLogDataType

enum Isis::ControlMeasureLogData::NumericLogDataType

Please do not change existing values in this list except the size - it will break backwards compadibility.

This is the list of log data for control measures. To add a new element, put it in the list (anywhere), assign it a value one greater than the current maximum, and increase the maximum's value. Then add a case to ControlMeasureLogData::DataTypeToName. Once you've done that, you're done! :)

Enumerator
InvalidNumericLogDataType	This is a placeholder for unset values.
Obsolete_Eccentricity	Deprecated keyword kept for backwards compatability with older Control Networks. DO NOT USE!!
GoodnessOfFit	GoodnessOfFit is pointreg information for reference measures. This measures how well the computed fit area matches the pattern area.
MinimumPixelZScore	Control measures store z-scores in pairs. A pair contains the z-scores of the minimum and maximum pixels in the pattern chip generated for the given measure during point registration. Each z-score indicates how many standard deviations the given pixel value is above or below the mean DN.
MaximumPixelZScore	See also MinimumPixelZScore
PixelShift	Deprecated keyword kept for backwards compatability with older Control Networks. DO NOT USE!!
WholePixelCorrelation	Deprecated keyword kept for backwards compatability with older Control Networks. DO NOT USE!!
SubPixelCorrelation	Deprecated keyword kept for backwards compatability with older Control Networks. DO NOT USE!!
Obsolete_AverageResidual	Deprecated keyword kept for backwards compatability with older Control Networks. DO NOT USE!!

Definition at line 63 of file ControlMeasureLogData.h.

Constructor & Destructor Documentation

◆ ControlMeasureLogData() [1/5]

Isis::ControlMeasureLogData::ControlMeasureLogData ( )

This creates an empty, invalid (IsValid() will return false), instance.

Definition at line 12 of file ControlMeasureLogData.cpp.

References Init().

◆ ControlMeasureLogData() [2/5]

Isis::ControlMeasureLogData::ControlMeasureLogData ( NumericLogDataType dataType )

This creates an instance with the given type but no value yet.

IsValid() will return false until a value is set.

Parameters

dataType What the instance is describing (the field)

Definition at line 36 of file ControlMeasureLogData.cpp.

References Init(), and p_dataType.

◆ ControlMeasureLogData() [3/5]

Isis::ControlMeasureLogData::ControlMeasureLogData ( PvlKeyword keywordRep )

This creates an instance while attempting to interpret keywordRep.

On failure, the IsValid() test will return false.

Parameters

keywordRep The PvlKeyword representing log data

Definition at line 49 of file ControlMeasureLogData.cpp.

References Init(), InvalidNumericLogDataType, Isis::PvlKeyword::name(), NameToDataType(), p_dataType, p_numericalValue, and Isis::toDouble().

◆ ControlMeasureLogData() [4/5]

Isis::ControlMeasureLogData::ControlMeasureLogData	(	NumericLogDataType	dataType,
		double	value
	)

This creates an instance with the given type and value for that type.

Parameters

dataType	What the value is describing (the field)
value	The numerical value of this field

Definition at line 23 of file ControlMeasureLogData.cpp.

References p_dataType, and p_numericalValue.

◆ ControlMeasureLogData() [5/5]

Isis::ControlMeasureLogData::ControlMeasureLogData ( const ControlMeasureLogData & other )

Copy constructor.

Parameters

other The instance to copy into this one.

Definition at line 63 of file ControlMeasureLogData.cpp.

References p_dataType, and p_numericalValue.

◆ ~ControlMeasureLogData()

Isis::ControlMeasureLogData::~ControlMeasureLogData ( )

Destructor.

This frees allocated memory by the instance of this class.

Definition at line 73 of file ControlMeasureLogData.cpp.

Member Function Documentation

◆ DataTypeToName()

QString Isis::ControlMeasureLogData::DataTypeToName ( NumericLogDataType type ) const

This converts the log data type to a string and is used internally for convertions to and from Pvl.

This is also useful for GUI programs that need to display log information.

Parameters

type	The data type to convert to a string

Definition at line 198 of file ControlMeasureLogData.cpp.

References _FILEINFO_, GoodnessOfFit, InvalidNumericLogDataType, MaximumPixelZScore, MinimumPixelZScore, Obsolete_AverageResidual, Obsolete_Eccentricity, PixelShift, Isis::IException::Programmer, SubPixelCorrelation, Isis::toString(), and WholePixelCorrelation.

Referenced by NameToDataType(), ToKeyword(), and Isis::ControlMeasure::UpdateLogData().

◆ GetDataType()

ControlMeasureLogData::NumericLogDataType Isis::ControlMeasureLogData::GetDataType ( ) const

Get the data type associated with this log data.

The return value is InvalidNumericLogDataType is no value has been set..

Returns: A numerical representation of the current DataType

Definition at line 127 of file ControlMeasureLogData.cpp.

References p_dataType.

Referenced by Isis::ControlMeasure::DeleteLogData(), Isis::ControlMeasure::GetLogValue(), Isis::ControlMeasure::HasLogData(), Isis::ControlMeasure::SetLogData(), Isis::ControlMeasure::UpdateLogData(), and Isis::ControlNetVersioner::writeFirstPoint().

◆ GetNumericalValue()

double Isis::ControlMeasureLogData::GetNumericalValue ( ) const

Get the value associated with this log data.

Returns Null is IsValid() if false.

Returns: A numerical representation of the current DataType

Definition at line 115 of file ControlMeasureLogData.cpp.

References p_numericalValue.

Referenced by Isis::MatchTool::loadMeasureTable(), Isis::QnetTool::loadMeasureTable(), Isis::ControlNetFilter::PointGoodnessOfFitFilter(), Isis::MatchTool::updateLeftMeasureInfo(), Isis::MatchTool::updateRightMeasureInfo(), and Isis::ControlNetVersioner::writeFirstPoint().

◆ GetValue()

QVariant Isis::ControlMeasureLogData::GetValue ( ) const

Get the data type associated with this log data.

The return value is an invalid variant type if the value is not set.

Definition at line 136 of file ControlMeasureLogData.cpp.

References p_numericalValue.

Referenced by Isis::ControlMeasure::GetLogValue().

◆ Init()

void Isis::ControlMeasureLogData::Init ( )

private

This is a helper method for the constructor that initializes the data to a default, invalid state.

Definition at line 81 of file ControlMeasureLogData.cpp.

References InvalidNumericLogDataType, Isis::Null, p_dataType, and p_numericalValue.

Referenced by ControlMeasureLogData(), and SetDataType().

◆ IsValid()

bool Isis::ControlMeasureLogData::IsValid ( ) const

This tests if the log data is complete and valid.

Returns: True if type and value are known, false otherwise

Definition at line 146 of file ControlMeasureLogData.cpp.

References InvalidNumericLogDataType, Isis::Null, p_dataType, and p_numericalValue.

Referenced by Isis::ControlMeasure::SetLogData(), ToKeyword(), and Isis::ControlNetVersioner::writeFirstPoint().

◆ NameToDataType()

ControlMeasureLogData::NumericLogDataType Isis::ControlMeasureLogData::NameToDataType ( QString name ) const

This converts a string to a log data type and is useful for converting Pvl keywords to Numeric Log Data Type.

Parameters

name	The string to convert to data type

Returns: The data type converted from a string

Definition at line 172 of file ControlMeasureLogData.cpp.

References DataTypeToName(), InvalidNumericLogDataType, and MaximumNumericLogDataType.

Referenced by ControlMeasureLogData().

◆ SetDataType()

void Isis::ControlMeasureLogData::SetDataType ( NumericLogDataType newDataType )

This changes the type of this log data.

This will reset the value of the log data also.

Parameters

newDataType The data type this log data should represent

Definition at line 103 of file ControlMeasureLogData.cpp.

References Init(), and p_dataType.

Referenced by Isis::ControlNetVersioner::createMeasure().

◆ SetNumericalValue()

void Isis::ControlMeasureLogData::SetNumericalValue ( double value )

This updates the value associated with a NumericLogDataType.

Parameters

value The new value for this log data

Definition at line 92 of file ControlMeasureLogData.cpp.

References p_numericalValue.

Referenced by Isis::ControlNetVersioner::createMeasure().

◆ ToKeyword()

PvlKeyword Isis::ControlMeasureLogData::ToKeyword ( ) const

This converts the log data to a PvlKeyword.

These should be understandable by the constructor.

Returns: A PVL representation of this log data

Definition at line 158 of file ControlMeasureLogData.cpp.

References DataTypeToName(), IsValid(), p_dataType, p_numericalValue, and Isis::toString().

Referenced by Isis::ControlNetVersioner::toPvl().

Member Data Documentation

◆ MaximumNumericLogDataType

const int Isis::ControlMeasureLogData::MaximumNumericLogDataType = 9

static

This value must be > the largest enumerated value in this type or convertions to and from Pvl will not work.

Definition at line 126 of file ControlMeasureLogData.h.

Referenced by NameToDataType().

◆ p_dataType

NumericLogDataType Isis::ControlMeasureLogData::p_dataType

private

Which kind of value are we storing.

Definition at line 151 of file ControlMeasureLogData.h.

Referenced by ControlMeasureLogData(), GetDataType(), Init(), IsValid(), SetDataType(), and ToKeyword().

◆ p_numericalValue

double Isis::ControlMeasureLogData::p_numericalValue

private

The actual value of the data.

Definition at line 153 of file ControlMeasureLogData.h.

Referenced by ControlMeasureLogData(), GetNumericalValue(), GetValue(), Init(), IsValid(), SetNumericalValue(), and ToKeyword().

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

src/control/objs/ControlMeasureLogData/ControlMeasureLogData.h
src/control/objs/ControlMeasureLogData/ControlMeasureLogData.cpp

Public Types

Public Member Functions

Static Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ NumericLogDataType

Constructor & Destructor Documentation

◆ ControlMeasureLogData() [1/5]

◆ ControlMeasureLogData() [2/5]

◆ ControlMeasureLogData() [3/5]

◆ ControlMeasureLogData() [4/5]

◆ ControlMeasureLogData() [5/5]

◆ ~ControlMeasureLogData()

Member Function Documentation

◆ DataTypeToName()

◆ GetDataType()

◆ GetNumericalValue()

◆ GetValue()

◆ Init()

◆ IsValid()

◆ NameToDataType()

◆ SetDataType()

◆ SetNumericalValue()

◆ ToKeyword()

Member Data Documentation

◆ MaximumNumericLogDataType

◆ p_dataType

◆ p_numericalValue