|
Isis 3.0 Developer's Reference (API) |
Home |
Distort/undistort focal plane coordinates. More...
#include <CameraDistortionMap.h>
Inherited by Isis::ApolloMetricDistortionMap, Isis::DawnFcDistortionMap, Isis::LoHighDistortionMap, Isis::LoMediumDistortionMap, Isis::LroNarrowAngleDistortionMap, Isis::LroWideAngleCameraDistortionMap, Isis::MarciDistortionMap, Isis::MocWideAngleDistortionMap, Isis::RadarSlantRangeMap, Isis::RadialDistortionMap, Isis::ReseauDistortionMap, Isis::TaylorCameraDistortionMap, Isis::ThemisIrDistortionMap, and Isis::ThemisVisDistortionMap.
Public Member Functions | |
| CameraDistortionMap (Camera *parent, double zDirection=1.0) | |
| Camera distortion map constructor. | |
| void | SetDistortion (int naifIkCode) |
| Load distortion coefficients. | |
| virtual | ~CameraDistortionMap () |
| Destructor. | |
| virtual bool | SetFocalPlane (double dx, double dy) |
| Compute undistorted focal plane x/y. | |
| virtual bool | SetUndistortedFocalPlane (double ux, double uy) |
| Compute distorted focal plane x/y. | |
| 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 |
Distort/undistort focal plane coordinates.
Creates a map for adding/removing optical distortions from the focal plane of a camera.
| Isis::CameraDistortionMap::CameraDistortionMap | ( | Camera * | parent, | |
| double | zDirection = 1.0 | |||
| ) |
Camera distortion map constructor.
Create a camera distortion map. This class maps between distorted and undistorted focal plane x/y's. The default mapping is the identity, that is, the focal plane x/y and undistorted focal plane x/y will be identical.
| parent | the parent camera that will use this distortion map | |
| zDirection | the direction of the focal plane Z-axis (either 1 or -1) |
References p_camera, p_zDirection, and Isis::Camera::SetDistortionMap().
| virtual Isis::CameraDistortionMap::~CameraDistortionMap | ( | ) | [inline, virtual] |
Destructor.
| double Isis::CameraDistortionMap::FocalPlaneX | ( | ) | const [inline] |
Return distorted focal plane x.
References p_focalPlaneX.
Referenced by Isis::ControlPoint::ComputeResiduals(), Isis::Camera::SetRightAscensionDeclination(), and Isis::LineScanCameraSkyMap::SetSky().
| double Isis::CameraDistortionMap::FocalPlaneY | ( | ) | const [inline] |
Return distorted focal plane y.
References p_focalPlaneY.
Referenced by Isis::ControlPoint::ComputeResiduals(), Isis::Camera::SetRightAscensionDeclination(), and Isis::LineScanCameraSkyMap::SetSky().
| std::vector< double > Isis::CameraDistortionMap::OpticalDistortionCoefficients | ( | ) | const |
Return optical distortion polynomial coefficients.
References p_odk.
| void Isis::CameraDistortionMap::SetDistortion | ( | int | naifIkCode | ) |
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)
| naifIkCode | Code to search for in instrument kernel |
Reimplemented in Isis::LoHighDistortionMap, Isis::LoMediumDistortionMap, Isis::LroNarrowAngleDistortionMap, and Isis::TaylorCameraDistortionMap.
References p_camera, p_odk, and Isis::toString().
Referenced by Isis::CTXCamera::CTXCamera(), and Isis::HiriseCamera::HiriseCamera().
| bool Isis::CameraDistortionMap::SetFocalPlane | ( | double | dx, | |
| 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
| dx | distorted focal plane x in millimeters | |
| dy | distorted focal plane y in millimeters |
Reimplemented in Isis::ApolloMetricDistortionMap, Isis::RadarSlantRangeMap, Isis::RadialDistortionMap, Isis::ReseauDistortionMap, Isis::DawnFcDistortionMap, Isis::LoHighDistortionMap, Isis::LoMediumDistortionMap, Isis::LroNarrowAngleDistortionMap, Isis::LroWideAngleCameraDistortionMap, Isis::TaylorCameraDistortionMap, Isis::MocWideAngleDistortionMap, Isis::MarciDistortionMap, Isis::ThemisIrDistortionMap, and Isis::ThemisVisDistortionMap.
References Isis::E(), p_focalPlaneX, p_focalPlaneY, p_odk, p_undistortedFocalPlaneX, p_undistortedFocalPlaneY, and r2.
Referenced by Isis::Camera::SetImage().
| bool Isis::CameraDistortionMap::SetUndistortedFocalPlane | ( | double | ux, | |
| 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
| ux | undistorted focal plane x in millimeters | |
| uy | undistorted focal plane y in millimeters |
Reimplemented in Isis::ApolloMetricDistortionMap, Isis::RadarSlantRangeMap, Isis::RadialDistortionMap, Isis::ReseauDistortionMap, Isis::DawnFcDistortionMap, Isis::LoHighDistortionMap, Isis::LoMediumDistortionMap, Isis::LroNarrowAngleDistortionMap, Isis::LroWideAngleCameraDistortionMap, Isis::TaylorCameraDistortionMap, Isis::MocWideAngleDistortionMap, Isis::MarciDistortionMap, Isis::ThemisIrDistortionMap, and Isis::ThemisVisDistortionMap.
References Isis::E(), p_camera, p_focalPlaneX, p_focalPlaneY, p_odk, p_undistortedFocalPlaneX, p_undistortedFocalPlaneY, and Isis::Camera::PixelPitch().
Referenced by Isis::ControlPoint::ComputeResiduals(), Isis::Camera::SetRightAscensionDeclination(), and Isis::LineScanCameraSkyMap::SetSky().
| double Isis::CameraDistortionMap::UndistortedFocalPlaneX | ( | ) | const [inline] |
Return undistorted focal plane x.
References p_undistortedFocalPlaneX.
Referenced by Isis::ControlPoint::ComputeApriori(), and Isis::Camera::SetImage().
| double Isis::CameraDistortionMap::UndistortedFocalPlaneY | ( | ) | const [inline] |
Return undistorted focal plane y.
References p_undistortedFocalPlaneY.
Referenced by Isis::ControlPoint::ComputeApriori(), and Isis::Camera::SetImage().
| double Isis::CameraDistortionMap::UndistortedFocalPlaneZ | ( | ) | const [inline] |
Return undistorted focal plane z.
References Isis::Camera::FocalLength(), p_camera, and p_zDirection.
Referenced by Isis::CameraGroundMap::GetdXYdOrientation(), Isis::CameraGroundMap::GetdXYdPoint(), Isis::CameraGroundMap::GetdXYdPosition(), Isis::CameraGroundMap::GetXY(), and Isis::Camera::SetImage().
| double Isis::CameraDistortionMap::ZDirection | ( | ) | const |
Return the direction of the focal plane Z-axis.
References p_zDirection.
Camera* Isis::CameraDistortionMap::p_camera [protected] |
Referenced by CameraDistortionMap(), Isis::LroWideAngleCameraDistortionMap::LroWideAngleCameraDistortionMap(), Isis::MarciDistortionMap::MarciDistortionMap(), Isis::TaylorCameraDistortionMap::SetDistortion(), Isis::LroNarrowAngleDistortionMap::SetDistortion(), Isis::LoMediumDistortionMap::SetDistortion(), Isis::LoHighDistortionMap::SetDistortion(), SetDistortion(), Isis::MarciDistortionMap::SetFocalPlane(), Isis::MocWideAngleDistortionMap::SetFocalPlane(), Isis::LoMediumDistortionMap::SetFocalPlane(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::MarciDistortionMap::SetUndistortedFocalPlane(), Isis::MocWideAngleDistortionMap::SetUndistortedFocalPlane(), Isis::LoMediumDistortionMap::SetUndistortedFocalPlane(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), SetUndistortedFocalPlane(), and UndistortedFocalPlaneZ().
double Isis::CameraDistortionMap::p_focalPlaneX [protected] |
Referenced by FocalPlaneX(), Isis::ThemisVisDistortionMap::SetFocalPlane(), Isis::ThemisIrDistortionMap::SetFocalPlane(), Isis::MarciDistortionMap::SetFocalPlane(), Isis::MocWideAngleDistortionMap::SetFocalPlane(), Isis::TaylorCameraDistortionMap::SetFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetFocalPlane(), Isis::LoMediumDistortionMap::SetFocalPlane(), Isis::LoHighDistortionMap::SetFocalPlane(), Isis::DawnFcDistortionMap::SetFocalPlane(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::RadialDistortionMap::SetFocalPlane(), Isis::RadarSlantRangeMap::SetFocalPlane(), SetFocalPlane(), Isis::ApolloMetricDistortionMap::SetFocalPlane(), Isis::ThemisVisDistortionMap::SetUndistortedFocalPlane(), Isis::ThemisIrDistortionMap::SetUndistortedFocalPlane(), Isis::MarciDistortionMap::SetUndistortedFocalPlane(), Isis::MocWideAngleDistortionMap::SetUndistortedFocalPlane(), Isis::TaylorCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetUndistortedFocalPlane(), Isis::LoMediumDistortionMap::SetUndistortedFocalPlane(), Isis::LoHighDistortionMap::SetUndistortedFocalPlane(), Isis::DawnFcDistortionMap::SetUndistortedFocalPlane(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::RadialDistortionMap::SetUndistortedFocalPlane(), Isis::RadarSlantRangeMap::SetUndistortedFocalPlane(), SetUndistortedFocalPlane(), and Isis::ApolloMetricDistortionMap::SetUndistortedFocalPlane().
double Isis::CameraDistortionMap::p_focalPlaneY [protected] |
Referenced by FocalPlaneY(), Isis::ThemisVisDistortionMap::SetFocalPlane(), Isis::ThemisIrDistortionMap::SetFocalPlane(), Isis::MarciDistortionMap::SetFocalPlane(), Isis::MocWideAngleDistortionMap::SetFocalPlane(), Isis::TaylorCameraDistortionMap::SetFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetFocalPlane(), Isis::LoMediumDistortionMap::SetFocalPlane(), Isis::LoHighDistortionMap::SetFocalPlane(), Isis::DawnFcDistortionMap::SetFocalPlane(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::RadialDistortionMap::SetFocalPlane(), Isis::RadarSlantRangeMap::SetFocalPlane(), SetFocalPlane(), Isis::ApolloMetricDistortionMap::SetFocalPlane(), Isis::ThemisVisDistortionMap::SetUndistortedFocalPlane(), Isis::ThemisIrDistortionMap::SetUndistortedFocalPlane(), Isis::MarciDistortionMap::SetUndistortedFocalPlane(), Isis::MocWideAngleDistortionMap::SetUndistortedFocalPlane(), Isis::TaylorCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetUndistortedFocalPlane(), Isis::LoMediumDistortionMap::SetUndistortedFocalPlane(), Isis::LoHighDistortionMap::SetUndistortedFocalPlane(), Isis::DawnFcDistortionMap::SetUndistortedFocalPlane(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::RadialDistortionMap::SetUndistortedFocalPlane(), Isis::RadarSlantRangeMap::SetUndistortedFocalPlane(), SetUndistortedFocalPlane(), and Isis::ApolloMetricDistortionMap::SetUndistortedFocalPlane().
std::vector<double> Isis::CameraDistortionMap::p_odk [protected] |
Referenced by Isis::LroWideAngleCameraDistortionMap::LroWideAngleCameraDistortionMap(), Isis::MarciDistortionMap::MarciDistortionMap(), OpticalDistortionCoefficients(), Isis::LroNarrowAngleDistortionMap::SetDistortion(), SetDistortion(), Isis::MarciDistortionMap::SetFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetFocalPlane(), Isis::LoMediumDistortionMap::SetFocalPlane(), Isis::LoHighDistortionMap::SetFocalPlane(), SetFocalPlane(), Isis::MarciDistortionMap::SetUndistortedFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetUndistortedFocalPlane(), Isis::LoMediumDistortionMap::SetUndistortedFocalPlane(), Isis::LoHighDistortionMap::SetUndistortedFocalPlane(), and SetUndistortedFocalPlane().
double Isis::CameraDistortionMap::p_undistortedFocalPlaneX [protected] |
Referenced by Isis::ThemisVisDistortionMap::SetFocalPlane(), Isis::ThemisIrDistortionMap::SetFocalPlane(), Isis::MarciDistortionMap::SetFocalPlane(), Isis::MocWideAngleDistortionMap::SetFocalPlane(), Isis::TaylorCameraDistortionMap::SetFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetFocalPlane(), Isis::LoMediumDistortionMap::SetFocalPlane(), Isis::LoHighDistortionMap::SetFocalPlane(), Isis::DawnFcDistortionMap::SetFocalPlane(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::RadialDistortionMap::SetFocalPlane(), Isis::RadarSlantRangeMap::SetFocalPlane(), SetFocalPlane(), Isis::ApolloMetricDistortionMap::SetFocalPlane(), Isis::ThemisVisDistortionMap::SetUndistortedFocalPlane(), Isis::ThemisIrDistortionMap::SetUndistortedFocalPlane(), Isis::MarciDistortionMap::SetUndistortedFocalPlane(), Isis::MocWideAngleDistortionMap::SetUndistortedFocalPlane(), Isis::TaylorCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetUndistortedFocalPlane(), Isis::LoMediumDistortionMap::SetUndistortedFocalPlane(), Isis::LoHighDistortionMap::SetUndistortedFocalPlane(), Isis::DawnFcDistortionMap::SetUndistortedFocalPlane(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::RadialDistortionMap::SetUndistortedFocalPlane(), Isis::RadarSlantRangeMap::SetUndistortedFocalPlane(), SetUndistortedFocalPlane(), Isis::ApolloMetricDistortionMap::SetUndistortedFocalPlane(), and UndistortedFocalPlaneX().
double Isis::CameraDistortionMap::p_undistortedFocalPlaneY [protected] |
Referenced by Isis::ThemisVisDistortionMap::SetFocalPlane(), Isis::ThemisIrDistortionMap::SetFocalPlane(), Isis::MarciDistortionMap::SetFocalPlane(), Isis::MocWideAngleDistortionMap::SetFocalPlane(), Isis::TaylorCameraDistortionMap::SetFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetFocalPlane(), Isis::LoMediumDistortionMap::SetFocalPlane(), Isis::LoHighDistortionMap::SetFocalPlane(), Isis::DawnFcDistortionMap::SetFocalPlane(), Isis::ReseauDistortionMap::SetFocalPlane(), Isis::RadialDistortionMap::SetFocalPlane(), Isis::RadarSlantRangeMap::SetFocalPlane(), SetFocalPlane(), Isis::ApolloMetricDistortionMap::SetFocalPlane(), Isis::ThemisVisDistortionMap::SetUndistortedFocalPlane(), Isis::ThemisIrDistortionMap::SetUndistortedFocalPlane(), Isis::MarciDistortionMap::SetUndistortedFocalPlane(), Isis::MocWideAngleDistortionMap::SetUndistortedFocalPlane(), Isis::TaylorCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroWideAngleCameraDistortionMap::SetUndistortedFocalPlane(), Isis::LroNarrowAngleDistortionMap::SetUndistortedFocalPlane(), Isis::LoMediumDistortionMap::SetUndistortedFocalPlane(), Isis::LoHighDistortionMap::SetUndistortedFocalPlane(), Isis::DawnFcDistortionMap::SetUndistortedFocalPlane(), Isis::ReseauDistortionMap::SetUndistortedFocalPlane(), Isis::RadialDistortionMap::SetUndistortedFocalPlane(), Isis::RadarSlantRangeMap::SetUndistortedFocalPlane(), SetUndistortedFocalPlane(), Isis::ApolloMetricDistortionMap::SetUndistortedFocalPlane(), and UndistortedFocalPlaneY().
double Isis::CameraDistortionMap::p_zDirection [protected] |