Isis 3 Programmer Reference
Isis::ApolloPanoramicDetectorMap Class Reference

Convert between parent image (aka encoder aka machine) coordinates and detector coordinates. More...

#include <ApolloPanoramicDetectorMap.h>

Inheritance diagram for Isis::ApolloPanoramicDetectorMap:
Inheritance graph
Collaboration diagram for Isis::ApolloPanoramicDetectorMap:
Collaboration graph

Public Member Functions

 ApolloPanoramicDetectorMap (Camera *parent, double etMiddle, double lineRate, Pvl *lab)
 Construct a detector map for line scan cameras.
 
virtual ~ApolloPanoramicDetectorMap ()
 Destroys ApolloPanoramicDetectorMap object.
 
virtual bool SetParent (const double sample, const double line)
 This method sets dector sample line coordinates from given cube coordinates.
 
virtual bool SetDetector (const double sample, const double line)
 This method sets cube sample line coordinates from given Dector coordinates.
 
void SetLineRate (const double lineRate)
 Reset the line rate.
 
double LineRate () const
 Return the time in seconds between scan lines.
 
double meanResidual ()
 Mean (average) of interior orientation residual vector lengths, accesor.
 
double maxResidual ()
 Max interior orientation residual vector length, accesor.
 
double stdevResidual ()
 Standard deviation of interior orientation residual vector lengths, accesor.
 
virtual bool SetParent (const double sample, const double line, const double deltaT)
 Compute detector position from a parent image coordinate.
 
double AdjustedStartingSample () const
 Return the starting detector sample adjusted for summation.
 
double AdjustedStartingLine () const
 Return the starting detector line adjusted for summation.
 
double ParentSample () const
 Return parent sample.
 
double ParentLine () const
 Return parent line.
 
double DetectorSample () const
 Return detector sample.
 
double DetectorLine () const
 Return detector line.
 
void SetStartingDetectorSample (const double sample)
 Set the starting detector sample.
 
void SetStartingDetectorLine (const double line)
 Set the starting detector line.
 
void SetDetectorSampleSumming (const double summing)
 Set sample summing mode.
 
void SetDetectorLineSumming (const double summing)
 Set line summing mode.
 
virtual double SampleScaleFactor () const
 Return scaling factor for computing sample resolution.
 
virtual double LineScaleFactor () const
 Return scaling factor for computing line resolution.
 
virtual double exposureDuration (const double sample, const double line, const int band) const
 This virtual method is for returning the exposure duration of a given pixel.
 

Protected Attributes

Camerap_camera
 Pointer to the camera.
 
double p_parentSample
 The parent sample calculated from the detector.
 
double p_parentLine
 The parent line calculated from the detector.
 
double p_detectorLine
 Detector coordinate line value.
 
double p_detectorSample
 Detector coordinate sample value.
 
double p_detectorSampleSumming
 The scaling factor for computing sample resolution.
 
double p_detectorLineSumming
 The scaling factor for computing line resolution.
 
double p_startingDetectorSample
 Detector start coordinate sample value.
 
double p_startingDetectorLine
 Detector start coordinate line value.
 
double p_ss
 Start sample.
 
double p_sl
 Start line.
 

Private Member Functions

int initializeInteriorOrientation ()
 This method uses the ApolloPanIO class to compute transforamtion from cube to image (aka fiducial cooraintes)
 
void Compute ()
 Compute new offsets whenenver summing or starting sample/lines change.
 

Private Attributes

double m_etMiddle
 Ephemeris time at the middle line.
 
double m_lineRate
 line exposure duration
 
Pvlm_lab
 Image label used to construct camera object.
 
ApolloPanIO p_intOri
 Class to preform transformations from cube coordiantes to image coordinates.
 

Detailed Description

Convert between parent image (aka encoder aka machine) coordinates and detector coordinates.

This class is used to convert between parent image (aka encoder aka machine) coordinates (sample/line) and detector coordinates for a the Apollo Panoramic Image.

Author
2011-11-21 Orrin Thomas
History

2011-11-21 Orrin Thomas - Original version

2012-07-10 Orrin Thomas - Updated to current coding standards

2017-06-28 Makayla Shepherd - Updated documentation. References #4807.

Definition at line 32 of file ApolloPanoramicDetectorMap.h.

Constructor & Destructor Documentation

◆ ApolloPanoramicDetectorMap()

Isis::ApolloPanoramicDetectorMap::ApolloPanoramicDetectorMap ( Camera * parent,
double etMiddle,
double lineRate,
Pvl * lab )
inline

Construct a detector map for line scan cameras.

Parameters
parentThe parent Camera Model
etMiddleTime of the center line, line 0 after interior orientation
lineRatethe time in seconds between lines (msec)
labThe labels to use for the camera creation

Definition at line 43 of file ApolloPanoramicDetectorMap.h.

References initializeInteriorOrientation(), m_etMiddle, m_lab, and m_lineRate.

◆ ~ApolloPanoramicDetectorMap()

virtual Isis::ApolloPanoramicDetectorMap::~ApolloPanoramicDetectorMap ( )
inlinevirtual

Destroys ApolloPanoramicDetectorMap object.

Definition at line 53 of file ApolloPanoramicDetectorMap.h.

Member Function Documentation

◆ AdjustedStartingLine()

double Isis::CameraDetectorMap::AdjustedStartingLine ( ) const
inherited

Return the starting detector line adjusted for summation.

Returns
(double) The starting line

Definition at line 123 of file CameraDetectorMap.cpp.

References Isis::CameraDetectorMap::p_sl.

◆ AdjustedStartingSample()

double Isis::CameraDetectorMap::AdjustedStartingSample ( ) const
inherited

Return the starting detector sample adjusted for summation.

Returns
(double) The starting sample

Definition at line 113 of file CameraDetectorMap.cpp.

References Isis::CameraDetectorMap::p_ss.

◆ Compute()

◆ DetectorLine()

double Isis::CameraDetectorMap::DetectorLine ( ) const
inherited

Return detector line.

Returns
(double) The detector line

Definition at line 163 of file CameraDetectorMap.cpp.

References Isis::CameraDetectorMap::p_detectorLine.

Referenced by Isis::Camera::SetImage(), and Isis::Camera::SetImage().

◆ DetectorSample()

double Isis::CameraDetectorMap::DetectorSample ( ) const
inherited

Return detector sample.

Returns
(double) The detector sample

Definition at line 153 of file CameraDetectorMap.cpp.

References Isis::CameraDetectorMap::p_detectorSample.

Referenced by Isis::Camera::SetImage(), and Isis::Camera::SetImage().

◆ exposureDuration()

double Isis::CameraDetectorMap::exposureDuration ( const double sample,
const double line,
const int band ) const
virtualinherited

This virtual method is for returning the exposure duration of a given pixel.

For framing cameras, exposure duration is not available so it throws an error.

Parameters
sampleThe sample of the desired pixel.
lineThe line of the desired pixel.
bandThe band of the desired pixel.
Returns
double The exposure duration for the desired pixel in seconds.
Exceptions
IException::Programmer"Exposure duration is only available for LineScan, VariableLineScan, and PushFrame Cameras."

Reimplemented in Isis::LineScanCameraDetectorMap, Isis::PushFrameCameraDetectorMap, Isis::VariableLineScanCameraDetectorMap, and Isis::NirsDetectorMap.

Definition at line 212 of file CameraDetectorMap.cpp.

References Isis::IException::Programmer.

Referenced by Isis::Camera::exposureDuration(), and Isis::Camera::exposureDuration().

◆ initializeInteriorOrientation()

int Isis::ApolloPanoramicDetectorMap::initializeInteriorOrientation ( )
private

This method uses the ApolloPanIO class to compute transforamtion from cube to image (aka fiducial cooraintes)

Exceptions
IException::User"No FID_MEASURES table found in cube blobs."
IException::User"Less than four FID_MEASURES found in cube blobs."
IException::User"Insufficient Fiducial Observations for computation of the interior orientation. At least one vertical pair must be measured, many more is recomented."
Returns
int Returns 1 on success and -1 on failure.

Definition at line 96 of file ApolloPanoramicDetectorMap.cpp.

References Isis::ApolloPanIO::computeInteriorOrienation(), Isis::ApolloPanIO::fiducialObservation(), Isis::PvlContainer::fileName(), Isis::ApolloPanIO::initialize(), m_lab, p_intOri, Isis::Table::Records(), and Isis::IException::User.

Referenced by ApolloPanoramicDetectorMap().

◆ LineRate()

double Isis::ApolloPanoramicDetectorMap::LineRate ( ) const
inlinevirtual

Return the time in seconds between scan lines.

Returns
double Time in seconds between scan lines

Reimplemented from Isis::CameraDetectorMap.

Definition at line 77 of file ApolloPanoramicDetectorMap.h.

References m_lineRate.

◆ LineScaleFactor()

double Isis::CameraDetectorMap::LineScaleFactor ( ) const
virtualinherited

◆ maxResidual()

double Isis::ApolloPanoramicDetectorMap::maxResidual ( )
inline

Max interior orientation residual vector length, accesor.

Returns
double Max interior orientation residual vector length

Definition at line 93 of file ApolloPanoramicDetectorMap.h.

References Isis::ApolloPanIO::maxResiduals(), and p_intOri.

Referenced by Isis::ApolloPanoramicCamera::ApolloPanoramicCamera().

◆ meanResidual()

double Isis::ApolloPanoramicDetectorMap::meanResidual ( )
inline

Mean (average) of interior orientation residual vector lengths, accesor.

Returns
double Mean of interior orientation residual vector lengths

Definition at line 86 of file ApolloPanoramicDetectorMap.h.

References Isis::ApolloPanIO::meanResiduals(), and p_intOri.

Referenced by Isis::ApolloPanoramicCamera::ApolloPanoramicCamera().

◆ ParentLine()

double Isis::CameraDetectorMap::ParentLine ( ) const
inherited

Return parent line.

Returns
(double) The parent line

Definition at line 143 of file CameraDetectorMap.cpp.

References Isis::CameraDetectorMap::p_parentLine.

Referenced by Isis::Camera::RawFocalPlanetoImage(), and Isis::Camera::SetRightAscensionDeclination().

◆ ParentSample()

double Isis::CameraDetectorMap::ParentSample ( ) const
inherited

Return parent sample.

Returns
(double) The parent sample

Definition at line 133 of file CameraDetectorMap.cpp.

References Isis::CameraDetectorMap::p_parentSample.

Referenced by Isis::Camera::RawFocalPlanetoImage(), and Isis::Camera::SetRightAscensionDeclination().

◆ SampleScaleFactor()

double Isis::CameraDetectorMap::SampleScaleFactor ( ) const
virtualinherited

Return scaling factor for computing sample resolution.

Returns
(double) The scaling factor for sample resolution

Definition at line 173 of file CameraDetectorMap.cpp.

References Isis::CameraDetectorMap::p_detectorSampleSumming.

Referenced by Isis::Camera::ObliqueSampleResolution(), and Isis::Camera::SampleResolution().

◆ SetDetector()

bool Isis::ApolloPanoramicDetectorMap::SetDetector ( const double sample,
const double line )
virtual

This method sets cube sample line coordinates from given Dector coordinates.

Parameters
sampledector sample coordinate
linedetector line coordinate
Returns
bool Always returns true

Reimplemented from Isis::CameraDetectorMap.

Definition at line 29 of file ApolloPanoramicDetectorMap.cpp.

References Isis::iTime::Et(), Isis::ApolloPanIO::image2Machine(), m_etMiddle, m_lineRate, Isis::CameraDetectorMap::p_camera, Isis::CameraDetectorMap::p_detectorLine, Isis::CameraDetectorMap::p_detectorSample, p_intOri, Isis::CameraDetectorMap::p_parentLine, Isis::CameraDetectorMap::p_parentSample, and Isis::Spice::time().

◆ SetDetectorLineSumming()

void Isis::CameraDetectorMap::SetDetectorLineSumming ( const double summing)
inlineinherited

Set line summing mode.

Use this method to specify if detector lines are summed/averaged. That is, one image lines represents the average of N detectors. If not set the default is 1.

Parameters
summingLine summing mode

Definition at line 123 of file CameraDetectorMap.h.

References Isis::CameraDetectorMap::Compute(), and Isis::CameraDetectorMap::p_detectorLineSumming.

Referenced by Isis::CrismCamera::CrismCamera().

◆ SetDetectorSampleSumming()

void Isis::CameraDetectorMap::SetDetectorSampleSumming ( const double summing)
inlineinherited

Set sample summing mode.

Use this method to specify if detector samples are summed/averaged. That is, one image sample represents the average of N detectors. If not set the default is 1.

Parameters
summingSample summing mode

Definition at line 108 of file CameraDetectorMap.h.

References Isis::CameraDetectorMap::Compute(), and Isis::CameraDetectorMap::p_detectorSampleSumming.

Referenced by Isis::ApolloPanoramicCamera::ApolloPanoramicCamera(), Isis::CrismCamera::CrismCamera(), Isis::DawnVirCamera::DawnVirCamera(), Isis::HrscCamera::HrscCamera(), and Isis::RosettaVirtisCamera::RosettaVirtisCamera().

◆ SetLineRate()

void Isis::ApolloPanoramicDetectorMap::SetLineRate ( const double lineRate)
inline

Reset the line rate.

Use this method to reset the time between lines. Usually this will not need to be done unless the rate changes between bands.

Parameters
lineRatethe time in seconds between lines
Returns
void

Definition at line 68 of file ApolloPanoramicDetectorMap.h.

References m_lineRate.

◆ SetParent() [1/2]

bool Isis::ApolloPanoramicDetectorMap::SetParent ( const double sample,
const double line )
virtual

This method sets dector sample line coordinates from given cube coordinates.

Parameters
samplecube sample coordinate
linecube line coordinate
Returns
bool Always returns true

Reimplemented from Isis::CameraDetectorMap.

Definition at line 58 of file ApolloPanoramicDetectorMap.cpp.

References m_etMiddle, m_lineRate, Isis::ApolloPanIO::machine2Image(), Isis::CameraDetectorMap::p_camera, Isis::CameraDetectorMap::p_detectorLine, Isis::CameraDetectorMap::p_detectorSample, p_intOri, Isis::CameraDetectorMap::p_parentLine, Isis::CameraDetectorMap::p_parentSample, and Isis::Sensor::setTime().

◆ SetParent() [2/2]

bool Isis::CameraDetectorMap::SetParent ( const double sample,
const double line,
const double deltaT )
virtualinherited

Compute detector position from a parent image coordinate.

This method will compute the detector position from the parent line/sample coordinate and an offset from the currently set time in seconds. If the time has not already been set, the input offset is not applied.

Parameters
sampleSample number in the parent image
lineLine number in the parent image
deltaToption time offset from center of exposure in seconds
Returns
conversion successful

Reimplemented in Isis::LineScanCameraDetectorMap, Isis::PushFrameCameraDetectorMap, Isis::RollingShutterCameraDetectorMap, and Isis::VariableLineScanCameraDetectorMap.

Definition at line 82 of file CameraDetectorMap.cpp.

References Isis::Spice::isTimeSet(), Isis::CameraDetectorMap::p_camera, Isis::CameraDetectorMap::p_detectorLine, Isis::CameraDetectorMap::p_detectorLineSumming, Isis::CameraDetectorMap::p_detectorSample, Isis::CameraDetectorMap::p_detectorSampleSumming, Isis::CameraDetectorMap::p_parentLine, Isis::CameraDetectorMap::p_parentSample, Isis::CameraDetectorMap::p_sl, Isis::CameraDetectorMap::p_ss, Isis::Sensor::setTime(), and Isis::Spice::time().

◆ SetStartingDetectorLine()

void Isis::CameraDetectorMap::SetStartingDetectorLine ( const double line)
inlineinherited

Set the starting detector line.

Use this method to specify the starting detector that represents the first image line in the cube. If not set the default is 1.

Parameters
lineStarting detector line

Definition at line 93 of file CameraDetectorMap.h.

References Isis::CameraDetectorMap::Compute(), and Isis::CameraDetectorMap::p_startingDetectorLine.

◆ SetStartingDetectorSample()

void Isis::CameraDetectorMap::SetStartingDetectorSample ( const double sample)
inlineinherited

Set the starting detector sample.

Use this method to specify the starting detector that represents the first image sample in the cube. If not set the default is 1.

Parameters
sampleStarting detector sample

Definition at line 79 of file CameraDetectorMap.h.

References Isis::CameraDetectorMap::Compute(), and Isis::CameraDetectorMap::p_startingDetectorSample.

Referenced by Isis::ApolloPanoramicCamera::ApolloPanoramicCamera().

◆ stdevResidual()

double Isis::ApolloPanoramicDetectorMap::stdevResidual ( )
inline

Standard deviation of interior orientation residual vector lengths, accesor.

Returns
double Standard deviation of interior orientation residual vector lengths

Definition at line 100 of file ApolloPanoramicDetectorMap.h.

References p_intOri, and Isis::ApolloPanIO::stdevResiduals().

Referenced by Isis::ApolloPanoramicCamera::ApolloPanoramicCamera().

Member Data Documentation

◆ m_etMiddle

double Isis::ApolloPanoramicDetectorMap::m_etMiddle
private

Ephemeris time at the middle line.

Definition at line 104 of file ApolloPanoramicDetectorMap.h.

Referenced by ApolloPanoramicDetectorMap(), SetDetector(), and SetParent().

◆ m_lab

Pvl* Isis::ApolloPanoramicDetectorMap::m_lab
private

Image label used to construct camera object.

Definition at line 106 of file ApolloPanoramicDetectorMap.h.

Referenced by ApolloPanoramicDetectorMap(), and initializeInteriorOrientation().

◆ m_lineRate

double Isis::ApolloPanoramicDetectorMap::m_lineRate
private

line exposure duration

Definition at line 105 of file ApolloPanoramicDetectorMap.h.

Referenced by ApolloPanoramicDetectorMap(), LineRate(), SetDetector(), SetLineRate(), and SetParent().

◆ p_camera

◆ p_detectorLine

◆ p_detectorLineSumming

◆ p_detectorSample

◆ p_detectorSampleSumming

◆ p_intOri

ApolloPanIO Isis::ApolloPanoramicDetectorMap::p_intOri
private

Class to preform transformations from cube coordiantes to image coordinates.

Definition at line 111 of file ApolloPanoramicDetectorMap.h.

Referenced by initializeInteriorOrientation(), maxResidual(), meanResidual(), SetDetector(), SetParent(), and stdevResidual().

◆ p_parentLine

◆ p_parentSample

◆ p_sl

◆ p_ss

◆ p_startingDetectorLine

double Isis::CameraDetectorMap::p_startingDetectorLine
protectedinherited

◆ p_startingDetectorSample

double Isis::CameraDetectorMap::p_startingDetectorSample
protectedinherited

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