USGS

Isis 3.0 Object Programmers' Reference

 Home
Isis::Lo::LoHighDistortionMap

Isis::Lo::LoHighDistortionMap Class Reference

#include <LoHighDistortionMap.h>

Inheritance diagram for Isis::Lo::LoHighDistortionMap:

Inheritance graph
[legend]
Collaboration diagram for Isis::Lo::LoHighDistortionMap:

Collaboration graph
[legend]
List of all members.

Detailed Description

Distort/undistort focal plane coordinates.

Creates a map for adding/removing optical distortions from the focal plane of the Lunar Orbiter high resolution camera.

See also:
Camera

For internal use only.

History:
2007-06-29 Debbie A. Cook - Original version
History:
2008-02-04 Jeff Anderson - Made change to allow for variable focal length in THEMIS IR
History:
2008-07-25 Steven Lambright - Fixed constructor; CameraDistortionMap is responsible both for setting the p_camera protected member and calling Camera::SetDistortionMap. When the parent called Camera::SetDistortionMap the Camera took ownership of the instance of this object. By calling this twice, and with Camera only supporting having one distortion map, this object was deleted before the constructor was finished.

Definition at line 50 of file LoHighDistortionMap.h.

Public Member Functions

 LoHighDistortionMap (Camera *parent)
 Constructor for LunarOrbiterHighDistortionMap class.
void SetDistortion (const int naifIkCode)
 Load LO High Resolution Camera perspective & distortion coefficients.
virtual bool SetFocalPlane (const double dx, const double dy)
 Compute undistorted focal plane x/y for Lo High Resolution Camera.
virtual bool SetUndistortedFocalPlane (const double ux, const double uy)
 Compute distorted focal plane x/y for Lo High Resolution Camera.
double FocalPlaneX () const
 Return distorted focal plane x.
double FocalPlaneY () const
 Return distorted focal plane y.
double UndistortedFocalPlaneX () const
 Return undistorted focal plane x.
double UndistortedFocalPlaneY () const
 Return undistorted focal plane y.
double UndistortedFocalPlaneZ () const
 Return undistorted focal plane z.

Protected Attributes

Camera * p_camera
double p_focalPlaneX
double p_focalPlaneY
double p_undistortedFocalPlaneX
double p_undistortedFocalPlaneY
double p_zDirection
std::vector< double > p_odk

Private Attributes

double p_xPerspective
double p_yPerspective
double p_x0
double p_y0
std::vector< double > p_coefs
std::vector< double > p_icoefs

Constructor & Destructor Documentation

Isis::Lo::LoHighDistortionMap::LoHighDistortionMap ( Camera *  parent  ) 

Constructor for LunarOrbiterHighDistortionMap class.

Define the distortion model coefficients for a Lunar Orbiter High Resolution camera.

Parameters:
parent A pointer to the parent camera object

For internal use only.

History:
2007-06-29 Debbie A. Cook Original version

Definition at line 19 of file LoHighDistortionMap.cpp.

Member Function Documentation

double Isis::CameraDistortionMap::FocalPlaneX (  )  const [inline, inherited]

Return distorted focal plane x.

Definition at line 62 of file CameraDistortionMap.h.

References Isis::CameraDistortionMap::p_focalPlaneX.

Referenced by Isis::PushFrameCameraGroundMap::FindDistance(), Isis::LineScanCameraGroundMap::FindFocalPlane(), Isis::Camera::RawFocalPlanetoImage(), Isis::Camera::SetRightAscensionDeclination(), and Isis::LineScanCameraSkyMap::SetSky().

double Isis::CameraDistortionMap::FocalPlaneY (  )  const [inline, inherited]

Return distorted focal plane y.

Definition at line 65 of file CameraDistortionMap.h.

References Isis::CameraDistortionMap::p_focalPlaneY.

Referenced by Isis::PushFrameCameraGroundMap::FindDistance(), Isis::LineScanCameraGroundMap::FindFocalPlane(), Isis::Camera::RawFocalPlanetoImage(), Isis::Camera::SetRightAscensionDeclination(), and Isis::LineScanCameraSkyMap::SetSky().

void Isis::Lo::LoHighDistortionMap::SetDistortion ( const int  naifIkCode  ) 

Load LO High Resolution Camera perspective & distortion coefficients.

This method loads the perspective correction factors, distortion centers, and coefficients from the instrument kernel. The perspective correction factors in the NAIF instrument kernel are expected to be in the form of:

 INSxxxxxxx_PERSPECTIVE_FACTORS = ( xpers, ypers)
 
 where xxxxxxx is the instrument code (always a negative number) and
 xpers and ypers are the X and Y perspective correction factors.

These factors will be used to convert from focal plane x,y to perspective-corrected x,y as follows.

pcx = FocalPlaneX * ( 1. + xpers*FocalPlaneX + ypers*FocalPlaneY); pcy = FocalPlaneY * ( 1. + xpers*FocalPlaneX + ypers*FocalPlaneY);

The distortion center coordinates (in mm) are expected to be in the form of:

 INSxxxxxxx_DISTORTION_CENTER = ( xcenter, ycenter)
 
 where xxxxxxx as is described above for the perspective factors.

The center will be used to calculate the radius of distortion in the equations below.

distX = PersCorrectedX - x0 distY = PersCorrectedY - y0

The distortion coefficients in the NAIF instrument kernel are expected to be in the form of:

 INSxxxxxxx_OD_K = ( coef1, coef2, ..., coefN)
 
 where xxxxxxx is as is described about for the perspective factors.

These coefficient will be used to convert from focal plane x,y to to undistorted x,y as follows (add equation here)

r^2 = DistX^2 + DistY^2 dr/r = k0 + k1*r^2 ux = PersCorrectedX - DistX*dr/r, similarly for uy

Parameters:
naifIkCode Code to search for in instrument kernel

Reimplemented from Isis::CameraDistortionMap.

Definition at line 77 of file LoHighDistortionMap.cpp.

References Isis::CameraDistortionMap::p_camera, p_x0, p_xPerspective, p_y0, p_yPerspective, and Isis::CameraDistortionMap::SetDistortion().

Referenced by Isis::Lo::LoHighCamera::LoHighCamera().

bool Isis::Lo::LoHighDistortionMap::SetFocalPlane ( const double  dx,
const double  dy 
) [virtual]

Compute undistorted focal plane x/y for Lo High Resolution Camera.

Compute undistorted focal plane x/y given a distorted focal plane x/y for the Lunar Orbiter High Resolution Camera. The polynomial used is described in the SetDistortion documentation. After calling this method, the undistorted x/y can be obtained via the UndistortedFocalPlaneX and UndistortedFocalPlaneY methods of the parent class.

Parameters:
dx distorted focal plane x in millimeters
dy distorted focal plane y in millimeters
Returns:
if the conversion was successful
See also:
SetDistortion

Reimplemented from Isis::CameraDistortionMap.

Definition at line 106 of file LoHighDistortionMap.cpp.

References Isis::E(), Isis::CameraDistortionMap::p_focalPlaneX, Isis::CameraDistortionMap::p_focalPlaneY, Isis::CameraDistortionMap::p_odk, Isis::CameraDistortionMap::p_undistortedFocalPlaneX, Isis::CameraDistortionMap::p_undistortedFocalPlaneY, p_x0, p_xPerspective, p_y0, and p_yPerspective.

bool Isis::Lo::LoHighDistortionMap::SetUndistortedFocalPlane ( const double  ux,
const double  uy 
) [virtual]

Compute distorted focal plane x/y for Lo High Resolution Camera.

Compute distorted focal plane x/y given an undistorted focal plane x/y for the Lunar Orbiter High Resolution Camera. This method applies both a perspective error and a distortion error based on a polynomial defined in the SetDistortion method. After calling this method the distorted x/y can be obtained via the FocalPlaneX and FocalPlaneY methods.

Parameters:
ux undistorted focal plane x in millimeters
uy undistorted focal plane y in millimeters
Returns:
if the conversion was successful
See also:
SetDistortion

Reimplemented from Isis::CameraDistortionMap.

Definition at line 152 of file LoHighDistortionMap.cpp.

References Isis::E(), Isis::CameraDistortionMap::p_focalPlaneX, Isis::CameraDistortionMap::p_focalPlaneY, Isis::CameraDistortionMap::p_odk, Isis::CameraDistortionMap::p_undistortedFocalPlaneX, Isis::CameraDistortionMap::p_undistortedFocalPlaneY, p_x0, p_xPerspective, p_y0, p_yPerspective, and Isis::CameraDistortionMap::p_zDirection.

double Isis::CameraDistortionMap::UndistortedFocalPlaneX (  )  const [inline, inherited]

Return undistorted focal plane x.

Definition at line 68 of file CameraDistortionMap.h.

References Isis::CameraDistortionMap::p_undistortedFocalPlaneX.

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

double Isis::CameraDistortionMap::UndistortedFocalPlaneY (  )  const [inline, inherited]

Return undistorted focal plane y.

Definition at line 71 of file CameraDistortionMap.h.

References Isis::CameraDistortionMap::p_undistortedFocalPlaneY.

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

double Isis::CameraDistortionMap::UndistortedFocalPlaneZ (  )  const [inline, inherited]

Return undistorted focal plane z.

Definition at line 74 of file CameraDistortionMap.h.

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

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