Read values from Cassini ISS labels. More...

#include <CissLabels.h>

Collaboration diagram for Isis::CissLabels:

Public Member Functions
	CissLabels (Pvl &lab)
	Constructs a CissLabels object from an Isis::Pvl object.

	CissLabels (const QString &file)
	Constructs a CissLabels object from a file name.

	~CissLabels ()
	Destroys the CissLabels object.

bool	NarrowAngle () const
	Returns whether InstrumentId from the Instrument group is "ISSNA".

bool	WideAngle () const
	Returns whether InstrumentId from the Instrument group is "ISSWA".

double	BiasStripMean () const
	Returns BiasStripMean from the Intstrument group.

QString	CompressionRatio () const
	Returns CompressionRatio from the Instrument group.

QString	CompressionType () const
	Returns CompressionType from the Instrument group.

QString	DataConversionType () const
	Returns DataConversionType from the Instrument group.

QString	DelayedReadoutFlag () const
	Returns DelayedReadoutFlag from the Instrument group.

double	ExposureDuration () const
	Returns ExposureDuration from the Instrument group.

std::vector< QString >	FilterName () const
	Returns a two-element array of the optical filters found in the BandBin group.

std::vector< int >	FilterIndex () const
	Returns a two-element array of indices associated with optical filter names.

QString	FlightSoftwareVersion () const
	Returns FlightSoftwareVersion from the Instrument group.

double	FrontOpticsTemp () const
	Returns the first element of OpticsTemperature from the Instrument group.

int	GainModeId () const
	Returns GainModeId from the Instrument group.

int	GainState () const
	Returns GainState from the Instrument group.

double	ImageNumber () const
	Returns ImageNumber from the Archive group.

double	InstrumentDataRate () const
	Returns InstrumentDataRate from the Instrument group.

QString	InstrumentId () const
	Returns InstrumentId from the Instrument group.

QString	InstrumentModeId ()
	Returns the lower case form of InstrumentModeId from the Instrument group.

QString	ReadoutCycleIndex () const
	Returns ReadoutCycleIndex from the Instrument group.

int	ReadoutOrder () const
	Returns ReadoutOrder from the Instrument group.

QString	ShutterModeId () const
	Returns ShutterModeId from the Instrument group.

int	SummingMode () const
	Returns SummingMode from the Instrument group.

bool	AntibloomingOn () const
	Returns whether AntiBloomingFlag from the Instrument group is "On".

Private Member Functions
void	Init (Pvl &lab)
	General initializer.

void	ReadLabels (Pvl &lab)
	Reads the Pvl Labels.

void	ComputeImgProperties ()
	Computes values of non-keyword image properties.

Private Attributes
QString	p_ABflag
	Value of the PDS keyword AntiBloomingFlag in the cube's labels.

bool	p_antiblooming
	Indicates whether anti-blooming state flag on.

double	p_biasStripMean
	Value of the PDS keyword BiasStripMean in the cube's labels.

bool	p_cissNA
	Indicates whether camera is narrow-angle.

QString	p_compressionRatio
	Value of the PDS keyword CompressionRatio in the cube's labels.

QString	p_compressionType
	Value of the PDS keyword CompressionType in the cube's labels.

QString	p_dataConversionType
	Value of the PDS keyword DataConversionType in the cube's labels.

QString	p_delayedReadoutFlag
	Value of the PDS keyword DelayedReadoutFlag in the cube's labels.

double	p_exposureDuration
	Value of the PDS keyword ExposureDuration in the cube's labels.

std::vector< QString >	p_filter
	Two-element array of optical filters used for this image.

std::vector< int >	p_filterIndex
	Two-element array of filter indices corresponding to optical filters.

QString	p_flightSoftwareVersion
	Value of the PDS keyword FlightSoftwareVersion in the cube's labels.

double	p_frontOpticsTemp
	Value of the PDS keyword OpticsTemperature[0] in the cube's labels.

int	p_gainModeId
	Value of the PDS keyword GainModeId in the cube's labels.

int	p_gainState
	Value of the PDS keyword GainState in the cube's labels.

double	p_imageNumber
	Value of the PDS keyword ImageNumber in the cube's labels.

double	p_instrumentDataRate
	Value of the PDS keyword ImageTime in the cube's labels.

QString	p_instrumentId
	Value of the PDS keyword InstrumentId in the cube's labels.

QString	p_instrumentModeId
	Value of the PDS keyword InstrumentModeId in the cube's labels.

QString	p_readoutCycleIndex
	Value of the PDS keyword ReadoutCycleIndex in the cube's labels.

int	p_readoutOrder
	Value of the PDS keyword ReadoutOrder in the cube's labels.

QString	p_shutterModeId
	Value of the PDS keyword ShutterModeId in the cube's labels.

int	p_summingMode
	Value of the PDS keyword SummingMode in the cube's labels.

Detailed Description

Read values from Cassini ISS labels.

This class is designed to be used with images imported from Cassini ISS using ciss2isis. It contains accessor methods for the values of Keywords in the Instrument Group of the cube's labels.

Author: 2008-11-05 Jeannie Walldren

History:

2008-11-05 Jeannie Walldren - Original Version

2008-11-07 Jeannie Walldren - Fixed documentation.

2011-05-03 Jeannie Walldren - Fixed documentation.

Definition at line 48 of file CissLabels.h.

Constructor & Destructor Documentation

Isis::CissLabels::CissLabels ( Pvl & lab )

Constructs a CissLabels object from an Isis::Pvl object.

Parameters

lab	Pvl Labels of Cassini ISS file

Definition at line 16 of file CissLabels.cpp.

Isis::CissLabels::CissLabels ( const QString & file )

Constructs a CissLabels object from a file name.

Parameters

file	Name of Cassini ISS file

Definition at line 25 of file CissLabels.cpp.

Isis::CissLabels::~CissLabels ( )

inline

Destroys the CissLabels object.

Definition at line 53 of file CissLabels.h.

Member Function Documentation

bool Isis::CissLabels::AntibloomingOn ( ) const

inline

Returns whether AntiBloomingFlag from the Instrument group is "On".

Indicates whether anti-blooming was used for the image. False implies the anti-blooming flag is "Off" or "Unknown".

Returns: bool True if AntiBloomingStateFlag "On"

Definition at line 415 of file CissLabels.h.

References p_antiblooming.

double Isis::CissLabels::BiasStripMean ( ) const

inline

Returns BiasStripMean from the Intstrument group.

Finds the mean of the overclocked pixels. If the image has DataConversionType of "Lossy", the bias strip mean is not valid unless the Flight Software Version is 1.4. Valid values include all real numbers.

Returns: double BiasStripMean

Definition at line 96 of file CissLabels.h.

References p_biasStripMean.

QString Isis::CissLabels::CompressionRatio ( ) const

inline

Returns CompressionRatio from the Instrument group.

Finds the ratio of the expected image size to the actual size. Valid values include any real number or "NotCompressed". This method returns an QString so that values other than "NotCompressed" may be converted to double.

Returns: QString CompressionRatio

Definition at line 112 of file CissLabels.h.

References p_compressionRatio.

QString Isis::CissLabels::CompressionType ( ) const

inline

Returns CompressionType from the Instrument group.

Finds the method of data compression used for the image. Valid values include "NotCompressed", "Lossless" (a.k.a Rice), or "Lossy" (a.k.a. Discrete Cosine Transform).

Returns: QString CompressionType

Definition at line 127 of file CissLabels.h.

References p_compressionType.

void Isis::CissLabels::ComputeImgProperties ( )

private

Computes values of non-keyword image properties.

This method computes and sets the values of the image properties that are not keywords in the labels.

Definition at line 96 of file CissLabels.cpp.

References _FILEINFO_.

QString Isis::CissLabels::DataConversionType ( ) const

inline

Returns DataConversionType from the Instrument group.

Finds the method used to convert the image from 12 to 8 bits. Valid values include "12Bit" (no conversion), "Table" (converted using look-up table), or "8LSB" (kept the 8 least significant bits only).

Returns: QString DataConversionType

Definition at line 142 of file CissLabels.h.

References p_dataConversionType.

QString Isis::CissLabels::DelayedReadoutFlag ( ) const

inline

Returns DelayedReadoutFlag from the Instrument group.

Indicates whether the image waited while the ther camera was performing a readout. Valid values include "Yes", "No", or "Unknown".

Returns: QString DelayedReadoutFlag

Definition at line 156 of file CissLabels.h.

References p_delayedReadoutFlag.

double Isis::CissLabels::ExposureDuration ( ) const

inline

Returns ExposureDuration from the Instrument group.

Finds the exposure duration in milliseconds for the image. There are 62 valid values between 0 and 1200000, or -999.0 (if data is unavailable).

Returns: double ExposureDuration

Definition at line 170 of file CissLabels.h.

References p_exposureDuration.

std::vector<int> Isis::CissLabels::FilterIndex ( ) const

inline

Returns a two-element array of indices associated with optical filter names.

Takes FilterName string from the BandBin group and assigns an index for each filter. Valid values are between 0 and 35. This method is not called for wide-angle cameras.

Returns: vector <int> The filter indices.

Definition at line 216 of file CissLabels.h.

References p_filterIndex.

std::vector<QString> Isis::CissLabels::FilterName ( ) const

inline

Returns a two-element array of the optical filters found in the BandBin group.

Takes FilterName string from the BandBin group and splits the combination into a vector of filter names.
Valid combinations include:

For narrow-angle cameras:
- Filter 1: "CL1", "RED", "BL1", "UV2", "UV1", "IRP0", "P120", "P60", "P0", "HAL", "IR4", "IR2"
- Filter 2: "CL2", "GRN", "UV3", "BL2", "MT2", "CB2", "MT3", "CB3", "MT1", "CB1", "IR3", "IR1"
For wide-angle cameras:
- Filter 1: "CL1", "IR3", "IR4", "IR5", "CB3", "MT3", "CB2", "MT2", "IR2"
- Filter 2: "CL2", "RED", "GRN", "BL1", "VIO", "HAL", "IRP90", "IRP0", "IR1"

Returns: vector <QString> The optical filter names.

Definition at line 201 of file CissLabels.h.

References p_filter.

QString Isis::CissLabels::FlightSoftwareVersion ( ) const

inline

Returns FlightSoftwareVersion from the Instrument group.

Retrieves the flight software version used for this image. Valid values include 1.2, 1.3, 1.4, or "Unknown". This method returns an QString so that any value other than "Unknown" may be converted to double.

Returns: QString FlightSoftwareVersion

Definition at line 232 of file CissLabels.h.

References p_flightSoftwareVersion.

double Isis::CissLabels::FrontOpticsTemp ( ) const

inline

Returns the first element of OpticsTemperature from the Instrument group.

Retrieves the first value of the two-element array containing front and rear optics temperatures. Valid values are greater than -999.0 degrees Celcius.

Returns: double OpticsTemperature[0]

Definition at line 247 of file CissLabels.h.

References p_frontOpticsTemp.

int Isis::CissLabels::GainModeId ( ) const

inline

Returns GainModeId from the Instrument group.

Finds the electronics gain setting in electrons per DN. Valid values include 12, 29, 95, or 215. These values correspond to GainState 3, 2, 1, and 0, respectively.

Returns: int GainModeId

See Also: GainState()

Definition at line 262 of file CissLabels.h.

References p_gainModeId.

int Isis::CissLabels::GainState ( ) const

inline

Returns GainState from the Instrument group.

Finds the gain state, which is dependent on the Gain Mode ID. Valid values include 0, 1, 2, or 3. These values correspond to GainModeId 215, 95, 29, and 12, respectively.

Returns: int GainState

See Also: GainModeId()

Definition at line 277 of file CissLabels.h.

References p_gainState.

double Isis::CissLabels::ImageNumber ( ) const

inline

Returns ImageNumber from the Archive group.

Finds the number of seconds on the clock at shutter close. Valid values include real numbers.

Returns: double ImageNumber

Definition at line 290 of file CissLabels.h.

References p_imageNumber.

void Isis::CissLabels::Init ( Pvl & lab )

private

General initializer.

Reads labels of the file and computes values of image properties not already in the labels.

Parameters

lab	Pvl Labels of Cassini ISS file

Exceptions

IException::Pvl Not valid Cassini ISS instrument

Definition at line 37 of file CissLabels.cpp.

References _FILEINFO_, and Isis::IException::print().

double Isis::CissLabels::InstrumentDataRate ( ) const

inline

Returns InstrumentDataRate from the Instrument group.

Finds the rate at which data was transferred out, in kilobits per second. Valid values include 60.9, 121.9, 182.8, 243.7, 304.6, 365.6, or -999.0 (if data is unavailable).

Returns: double InstrumentDataRate

Definition at line 305 of file CissLabels.h.

References p_instrumentDataRate.

QString Isis::CissLabels::InstrumentId ( ) const

inline

Returns InstrumentId from the Instrument group.

Finds the type of camera used. Valid values include "ISSNA" (also called "NAC" or "narrow-angle") or "ISSWA" (also called "WAC" or "wide-angle").

Returns: QString InstrumentId

Definition at line 319 of file CissLabels.h.

References p_instrumentId.

QString Isis::CissLabels::InstrumentModeId ( )

inline

Returns the lower case form of InstrumentModeId from the Instrument group.

Finds the summation mode used for this image. All images have 1 band and an equal number of lines and samples. Valid values include "full" (1024x1024), "sum2" (512x512), or "sum4" (256x256). These values correspond to SummingMode 1, 2, and 4, respectively.

Returns: double lower-cased InstrumentModeId

See Also: SummingMode()

Definition at line 337 of file CissLabels.h.

References p_instrumentModeId.

bool Isis::CissLabels::NarrowAngle ( ) const

inline

Returns whether InstrumentId from the Instrument group is "ISSNA".

Indicates whether the camera used a narrow-angle lens ("ISSNA"). False implies it used a wide-angle lens ("ISSWA").

Returns: bool True if instrument ISSNA

Definition at line 66 of file CissLabels.h.

References p_cissNA.

void Isis::CissLabels::ReadLabels ( Pvl & lab )

private

Reads the Pvl Labels.

This method reads the required keywords from the labels and sets the values of the private variables.

Parameters

lab	Pvl Labels of Cassini ISS file

Definition at line 57 of file CissLabels.cpp.

References Isis::PvlObject::findGroup(), Isis::toDouble(), Isis::IString::Token(), and Isis::IString::ToQt().

QString Isis::CissLabels::ReadoutCycleIndex ( ) const

inline

Returns ReadoutCycleIndex from the Instrument group.

Finds the index associated with the image in the Readout Cycle table. Valid values are "Unknown" or in the range 0-15. This method returns an QString so that any value not equal to "Unknown" may be converted to int.

Returns: QString ReadoutCycleIndex

Definition at line 353 of file CissLabels.h.

References p_readoutCycleIndex.

int Isis::CissLabels::ReadoutOrder ( ) const

inline

Returns ReadoutOrder from the Instrument group.

Finds the integer value representing the readout order of the image. Valid values are

0 : indicates narrow-angle was read out first
1 : indicates wide-angle was read out first

Returns: int ReadoutOrder

Definition at line 370 of file CissLabels.h.

References p_readoutOrder.

QString Isis::CissLabels::ShutterModeId ( ) const

inline

Returns ShutterModeId from the Instrument group.

Indicates whether the exposure was part of a joint observation with the other ISS camera. Valid values include "BothSim", "NacOnly", "WacOnly", or "Unknown".

Returns: QString ShutterModeId

Definition at line 385 of file CissLabels.h.

References p_shutterModeId.

int Isis::CissLabels::SummingMode ( ) const

inline

Returns SummingMode from the Instrument group.

Finds the summation mode, which is dependent on the Instrument Mode ID. Valid values include 1, 2, or 4. These values correspond to InstrumentModeId "Full", "Sum2", and "Sum4", respectively.

Returns: int SummingMode

See Also: InstrumentModeId()

Definition at line 401 of file CissLabels.h.

References p_summingMode.

bool Isis::CissLabels::WideAngle ( ) const

inline

Returns whether InstrumentId from the Instrument group is "ISSWA".

Indicates whether the camera used a wide-angle lens ("ISSWA"). False implies it used a narrow-angle lens ("ISSNA").

Returns: bool True if instrument ISSWA

Definition at line 81 of file CissLabels.h.

References p_cissNA.

Member Data Documentation

QString Isis::CissLabels::p_ABflag

private

Value of the PDS keyword AntiBloomingFlag in the cube's labels.

Definition at line 427 of file CissLabels.h.

bool Isis::CissLabels::p_antiblooming

private

Indicates whether anti-blooming state flag on.

Definition at line 429 of file CissLabels.h.

Referenced by AntibloomingOn().

double Isis::CissLabels::p_biasStripMean

private

Value of the PDS keyword BiasStripMean in the cube's labels.

Definition at line 431 of file CissLabels.h.

Referenced by BiasStripMean().

bool Isis::CissLabels::p_cissNA

private

Indicates whether camera is narrow-angle.

Definition at line 433 of file CissLabels.h.

Referenced by NarrowAngle(), and WideAngle().

QString Isis::CissLabels::p_compressionRatio

private

Value of the PDS keyword CompressionRatio in the cube's labels.

Definition at line 435 of file CissLabels.h.

Referenced by CompressionRatio().

QString Isis::CissLabels::p_compressionType

private

Value of the PDS keyword CompressionType in the cube's labels.

Definition at line 437 of file CissLabels.h.

Referenced by CompressionType().

QString Isis::CissLabels::p_dataConversionType

private

Value of the PDS keyword DataConversionType in the cube's labels.

Definition at line 439 of file CissLabels.h.

Referenced by DataConversionType().

QString Isis::CissLabels::p_delayedReadoutFlag

private

Value of the PDS keyword DelayedReadoutFlag in the cube's labels.

Definition at line 441 of file CissLabels.h.

Referenced by DelayedReadoutFlag().

double Isis::CissLabels::p_exposureDuration

private

Value of the PDS keyword ExposureDuration in the cube's labels.

Definition at line 443 of file CissLabels.h.

Referenced by ExposureDuration().

std::vector<QString> Isis::CissLabels::p_filter

private

Two-element array of optical filters used for this image.

Definition at line 445 of file CissLabels.h.

Referenced by FilterName().

std::vector<int> Isis::CissLabels::p_filterIndex

private

Two-element array of filter indices corresponding to optical filters.

Definition at line 447 of file CissLabels.h.

Referenced by FilterIndex().

QString Isis::CissLabels::p_flightSoftwareVersion

private

Value of the PDS keyword FlightSoftwareVersion in the cube's labels.

Definition at line 449 of file CissLabels.h.

Referenced by FlightSoftwareVersion().

double Isis::CissLabels::p_frontOpticsTemp

private

Value of the PDS keyword OpticsTemperature[0] in the cube's labels.

Definition at line 451 of file CissLabels.h.

Referenced by FrontOpticsTemp().

int Isis::CissLabels::p_gainModeId

private

Value of the PDS keyword GainModeId in the cube's labels.

Definition at line 453 of file CissLabels.h.

Referenced by GainModeId().

int Isis::CissLabels::p_gainState

private

Value of the PDS keyword GainState in the cube's labels.

Definition at line 455 of file CissLabels.h.

Referenced by GainState().

double Isis::CissLabels::p_imageNumber

private

Value of the PDS keyword ImageNumber in the cube's labels.

Definition at line 457 of file CissLabels.h.

Referenced by ImageNumber().

double Isis::CissLabels::p_instrumentDataRate

private

Value of the PDS keyword ImageTime in the cube's labels.

Definition at line 459 of file CissLabels.h.

Referenced by InstrumentDataRate().

QString Isis::CissLabels::p_instrumentId

private

Value of the PDS keyword InstrumentId in the cube's labels.

Definition at line 461 of file CissLabels.h.

Referenced by InstrumentId().

QString Isis::CissLabels::p_instrumentModeId

private

Value of the PDS keyword InstrumentModeId in the cube's labels.

Definition at line 463 of file CissLabels.h.

Referenced by InstrumentModeId().

QString Isis::CissLabels::p_readoutCycleIndex

private

Value of the PDS keyword ReadoutCycleIndex in the cube's labels.

Definition at line 465 of file CissLabels.h.

Referenced by ReadoutCycleIndex().

int Isis::CissLabels::p_readoutOrder

private

Value of the PDS keyword ReadoutOrder in the cube's labels.

Definition at line 467 of file CissLabels.h.

Referenced by ReadoutOrder().

QString Isis::CissLabels::p_shutterModeId

private

Value of the PDS keyword ShutterModeId in the cube's labels.

Definition at line 469 of file CissLabels.h.

Referenced by ShutterModeId().

int Isis::CissLabels::p_summingMode

private

Value of the PDS keyword SummingMode in the cube's labels.

Definition at line 471 of file CissLabels.h.

Referenced by SummingMode().

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

src/cassini/objs/CissLabels/CissLabels.h
src/cassini/objs/CissLabels/CissLabels.cpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation