Distort/undistort focal plane coordinates. More...

#include <MocWideAngleDistortionMap.h>

Inheritance diagram for Isis::MocWideAngleDistortionMap:

Collaboration diagram for Isis::MocWideAngleDistortionMap:

Public Member Functions
	MocWideAngleDistortionMap (Camera *parent, bool red)
	Constructor for MocWideAngleDistortionMap class.
virtual bool	SetFocalPlane (const double dx, const double dy)
	Compute undistorted focal plane x/y.
virtual bool	SetUndistortedFocalPlane (const double ux, const double uy)
	Compute distorted focal plane x/y.
void	SetDistortion (int naifIkCode)
	Load distortion coefficients.
std::vector< double >	OpticalDistortionCoefficients () const
	Return optical distortion polynomial coefficients.
double	ZDirection () const
	Return the direction of the focal plane Z-axis.
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
std::vector< double >	p_coefs
std::vector< double >	p_icoefs
double	p_scale
int	p_numCoefs

Detailed Description

Distort/undistort focal plane coordinates.

Creates a map for adding/removing optical distortions from the focal plane of the Moc wide angle camera.

See Also: Camera

Author: 2005-02-01 Jeff Anderson

History:: 2005-02-01 Jeff Anderson - Original version

History:: 2011-05-03 Jeannie Walldren - Removed Mgs namespace wrap.

Definition at line 45 of file MocWideAngleDistortionMap.h.

Constructor & Destructor Documentation

Isis::MocWideAngleDistortionMap::MocWideAngleDistortionMap	(	Camera *	parent,
		bool	red
	)

Constructor for MocWideAngleDistortionMap class.

Define the distortion model coefficients for a Moc Wide Angle camera.

Parameters

parent	A pointer to the parent camera object
red	A flag indicating whether the filter is red or not

History:: 2005-02-01 Jeff Anderson Original version

History:: 2007-02-24 Debbie A. Cook Changed to p_scale value for -1 to 1 to reflect the change to the affine coefficients in the new MocAddendum003.ti file

Definition at line 40 of file MocWideAngleDistortionMap.cpp.

Member Function Documentation

double Isis::CameraDistortionMap::FocalPlaneX ( ) const

inlineinherited

Return distorted focal plane x.

Definition at line 72 of file CameraDistortionMap.h.

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

double Isis::CameraDistortionMap::FocalPlaneY ( ) const

inlineinherited

Return distorted focal plane y.

Definition at line 77 of file CameraDistortionMap.h.

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

std::vector< double > Isis::CameraDistortionMap::OpticalDistortionCoefficients ( ) const

inherited

Return optical distortion polynomial coefficients.

Definition at line 195 of file CameraDistortionMap.cpp.

void Isis::CameraDistortionMap::SetDistortion ( int naifIkCode )

inherited

Load distortion coefficients.

This method loads the distortion coefficients from the instrument kernel. The coefficients in the NAIF instrument kernel are expected to be in the form of:

INSxxxxx_OD_K = ( coef1, coef2, ..., coefN)
where xxxxx is the instrument code (always a negative number)

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

Parameters

naifIkCode Code to search for in instrument kernel

Todo:

Generalize to read variable number of coefficients

Add latex equation to the documentation

Reimplemented in Isis::LoMediumDistortionMap, Isis::LoHighDistortionMap, Isis::LroNarrowAngleDistortionMap, Isis::TaylorCameraDistortionMap, and Isis::KaguyaMiCameraDistortionMap.

Definition at line 65 of file CameraDistortionMap.cpp.

References Isis::toString().

Referenced by Isis::AmicaCamera::AmicaCamera(), Isis::CTXCamera::CTXCamera(), Isis::HiriseCamera::HiriseCamera(), and Isis::LroWideAngleCameraDistortionMap::LroWideAngleCameraDistortionMap().

bool Isis::MocWideAngleDistortionMap::SetFocalPlane	(	const double	dx,
		const double	dy
	)

virtual

Compute undistorted focal plane x/y.

Compute undistorted focal plane x/y given a distorted focal plane x/y. This virtual method can be used to apply various techniques for removing optical distortion in the focal plane of a camera. The default implementation uses a polynomial distortion if the SetDistortion method is invoked. After calling this method, you can obtain the undistorted x/y via the UndistortedFocalPlaneX and UndistortedFocalPlaneY methods

Parameters

dx	distorted focal plane x in millimeters
dy	distorted focal plane y in millimeters

Returns: if the conversion was successful

See Also: SetDistortion

Todo:: Generalize polynomial equation

Reimplemented from Isis::CameraDistortionMap.

Definition at line 77 of file MocWideAngleDistortionMap.cpp.

References Isis::E(), and Isis::Camera::FocalLength().

bool Isis::MocWideAngleDistortionMap::SetUndistortedFocalPlane	(	const double	ux,
		const double	uy
	)

virtual

Compute distorted focal plane x/y.

Compute distorted focal plane x/y given an undistorted focal plane x/y. This virtual method is used to apply various techniques for adding optical distortion in the focal plane of a camera. The default implementation of this virtual method uses a polynomial distortion if the SetDistortion method was invoked. After calling this method, you can obtain the distorted x/y via the FocalPlaneX and FocalPlaneY methods

Parameters