USGS

Isis 3.0 Developer's Reference (API)

Home

Isis::ControlMeasureLogData Class Reference

Statistical and similar ControlMeasure associated information. More...

#include <ControlMeasureLogData.h>

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.
 
 ControlMeasureLogData (NumericLogDataType)
 This creates an instance with the given type but no value yet.
 
 ControlMeasureLogData (PvlKeyword)
 This creates an instance while attempting to interpret keywordRep.
 
 ControlMeasureLogData (NumericLogDataType, double value)
 This creates an instance with the given type and value for that type.
 
 ControlMeasureLogData (const ControlNetLogDataProtoV0001_Point_Measure_DataEntry &)
 This creates an instance based on the protocol buffer.
 
 ControlMeasureLogData (const ControlPointFileEntryV0002_Measure_MeasureLogData &)
 This creates an instance based on the protocol buffer.
 
 ControlMeasureLogData (const ControlMeasureLogData &other)
 Copy constructor.
 
 ~ControlMeasureLogData ()
 Destructor.
 
void SetNumericalValue (double)
 This updates the value associated with a NumericLogDataType.
 
void SetDataType (NumericLogDataType)
 This changes the type of this log data.
 
double GetNumericalValue () const
 Get the value associated with this log data.
 
NumericLogDataType GetDataType () const
 Get the data type associated with this log data.
 
QVariant GetValue () const
 Get the data type associated with this log data.
 
bool IsValid () const
 This tests if the log data is complete and valid.
 
PvlKeyword ToKeyword () const
 This converts the log data to a PvlKeyword.
 
ControlPointFileEntryV0002_Measure_MeasureLogData ToProtocolBuffer () const
 This converts the log data to a protocol buffer object.
 
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.
 
QString DataTypeToName (NumericLogDataType) const
 This converts the log data type to a string and is used internally for convertions to and from Pvl.
 

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.
 

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

Member Enumeration Documentation

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!!

Constructor & Destructor Documentation

Isis::ControlMeasureLogData::ControlMeasureLogData ( )

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

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
dataTypeWhat the instance is describing (the field)
Isis::ControlMeasureLogData::ControlMeasureLogData ( PvlKeyword  keywordRep)

This creates an instance while attempting to interpret keywordRep.

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

Parameters
keywordRepThe PvlKeyword representing log data

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

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

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

Parameters
dataTypeWhat the value is describing (the field)
valueThe numerical value of this field
Isis::ControlMeasureLogData::ControlMeasureLogData ( const ControlNetLogDataProtoV0001_Point_Measure_DataEntry protoBuf)

This creates an instance based on the protocol buffer.

This assumes the protocol buffer is correct and does no extra validation.

Parameters
protoBufThe protocol buffer version of a log data

References Isis::ControlNetLogDataProtoV0001_Point_Measure_DataEntry::datatype(), and Isis::ControlNetLogDataProtoV0001_Point_Measure_DataEntry::datavalue().

Isis::ControlMeasureLogData::ControlMeasureLogData ( const ControlPointFileEntryV0002_Measure_MeasureLogData protoBuf)

This creates an instance based on the protocol buffer.

This assumes the protocol buffer is correct and does no extra validation.

Parameters
protoBufThe protocol buffer version of a log data

References Isis::ControlPointFileEntryV0002_Measure_MeasureLogData::doubledatatype(), Isis::ControlPointFileEntryV0002_Measure_MeasureLogData::doubledatavalue(), and Isis::ControlPointFileEntryV0002_Measure_MeasureLogData::has_doubledatatype().

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

Copy constructor.

Parameters
otherThe instance to copy into this one.
Isis::ControlMeasureLogData::~ControlMeasureLogData ( )

Destructor.

This frees allocated memory by the instance of this class.

Member Function Documentation

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
typeThe data type to convert to a string

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().

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

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

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

Referenced by Isis::CnetViz::GoodnessOfFitFilter::evaluate(), Isis::CnetViz::AbstractMeasureItem::getData(), Isis::ControlPoint::GetStatistic(), and Isis::ControlNetFilter::PointGoodnessOfFitFilter().

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.

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

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

References InvalidNumericLogDataType, and Isis::Null.

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

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
nameThe string to convert to data type
Returns
The data type converted from a string

References DataTypeToName(), InvalidNumericLogDataType, and MaximumNumericLogDataType.

Referenced by ControlMeasureLogData().

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
newDataTypeThe data type this log data should represent
void Isis::ControlMeasureLogData::SetNumericalValue ( double  value)

This updates the value associated with a NumericLogDataType.

Parameters
valueThe new value for this log data
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

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

Referenced by Isis::ControlNetFileV0002::toPvl(), and Isis::ControlNetFileV0001::toPvl().

ControlPointFileEntryV0002_Measure_MeasureLogData Isis::ControlMeasureLogData::ToProtocolBuffer ( ) const

This converts the log data to a protocol buffer object.

This should be understandable by the constructor that takes a protocol buffer object.

Returns
A protocol buffer representation of this log data

References _FILEINFO_, IsValid(), Isis::IException::Programmer, Isis::ControlPointFileEntryV0002_Measure_MeasureLogData::set_doubledatatype(), and Isis::ControlPointFileEntryV0002_Measure_MeasureLogData::set_doubledatavalue().

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

Member Data Documentation

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.

Referenced by NameToDataType().


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