Distort/undistort focal plane coordinates for OSIRIS REx's cameras.
Creates a map for adding/removing optical distortions from the focal plane of a camera.
- See also
- Camera
- Author
- 2017-08-21 Kristin Berry and Jeannie Backer
- History
2017-08-21 Kristin Berry and Jeannie Backer - Original Version
2019-03-15 Kris Becker - Added debug options
Definition at line 33 of file OsirisRexDistortionMap.h.
| Isis::OsirisRexDistortionMap::OsirisRexDistortionMap |
( |
Camera * | parent, |
|
|
double | zDirection = 1.0 ) |
OSIRIS REx Camera distortion map constructor.
Create a camera distortion map for OSIRIS REx's.
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.
- Parameters
-
| parent | the parent camera that will use this distortion map |
| zDirection | the direction of the focal plane Z-axis (either 1 or -1) |
Definition at line 33 of file OsirisRexDistortionMap.cpp.
References Isis::CameraDistortionMap::CameraDistortionMap(), Isis::CameraFocalPlaneMap::DetectorLineOrigin(), Isis::CameraFocalPlaneMap::DetectorSampleOrigin(), Isis::Camera::FocalPlaneMap(), m_debug, m_detectorOriginLine, m_detectorOriginSample, m_pixelPitch, and Isis::CameraDistortionMap::p_camera.
| void Isis::CameraDistortionMap::SetDistortion |
( |
int | naifIkCode | ) |
|
|
virtualinherited |
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::JunoDistortionMap, Isis::KaguyaMiCameraDistortionMap, Isis::LoHighDistortionMap, Isis::LoMediumDistortionMap, Isis::LroNarrowAngleDistortionMap, Isis::OsirisRexOcamsDistortionMap, and Isis::TaylorCameraDistortionMap.
Definition at line 58 of file CameraDistortionMap.cpp.
References p_camera, p_odk, and Isis::toString().
Referenced by Isis::Chandrayaan2OhrcCamera::Chandrayaan2OhrcCamera(), Isis::Chandrayaan2TmcCamera::Chandrayaan2TmcCamera(), Isis::ClipperNacRollingShutterCamera::ClipperNacRollingShutterCamera(), Isis::ClipperPushBroomCamera::ClipperPushBroomCamera(), Isis::ClipperWacFcCamera::ClipperWacFcCamera(), Isis::CTXCamera::CTXCamera(), Isis::HayabusaAmicaCamera::HayabusaAmicaCamera(), Isis::HiriseCamera::HiriseCamera(), Isis::Hyb2OncCamera::Hyb2OncCamera(), Isis::LoHighDistortionMap::SetDistortion(), and Isis::LoMediumDistortionMap::SetDistortion().
| bool Isis::OsirisRexDistortionMap::SetDistortion |
( |
int | naifIkCode, |
|
|
QString | filter = "UNKNOWN" ) |
|
virtual |
Load distortion coefficients and center-of-distortion for OCAMS.
This method loads the distortion coefficients from the instrument kernel. OCAMS's coefficients in the NAIF instrument kernel are expected to be in one of the following forms:
INS-64361_OD_K_FILTER = (2.21E-05, 1.71E-04, 5.96E-05, 0.00E+00, 0.00E+00)
INS-64361_OD_CENTER_FILTER = (486.2, 450.3)
Or if the distortion is not filter-dependent:
INS-64361_OD_K = (2.21E-05, 1.71E-04, 5.96E-05, 0.00E+00, 0.00E+00)
INS-64361_OD_CENTER = (486.2, 450.3)
- Parameters
-
| naifIkCode | Code to search for in instrument kernel |
Definition at line 85 of file OsirisRexDistortionMap.cpp.
References m_debug, m_detectorOriginLine, m_detectorOriginSample, m_distortionOriginLine, m_distortionOriginSample, Isis::CameraDistortionMap::p_camera, Isis::CameraDistortionMap::p_odk, and Isis::toString().
Referenced by Isis::OsirisRexOcamsCamera::OsirisRexOcamsCamera().
| bool Isis::OsirisRexDistortionMap::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. 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
Reimplemented from Isis::CameraDistortionMap.
Definition at line 154 of file OsirisRexDistortionMap.cpp.
References m_debug, m_detectorOriginLine, m_detectorOriginSample, m_distortionOriginLine, m_distortionOriginSample, m_pixelPitch, Isis::CameraDistortionMap::p_focalPlaneX, Isis::CameraDistortionMap::p_focalPlaneY, Isis::CameraDistortionMap::p_odk, Isis::CameraDistortionMap::p_undistortedFocalPlaneX, and Isis::CameraDistortionMap::p_undistortedFocalPlaneY.
| bool Isis::OsirisRexDistortionMap::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.
After calling this method, you can obtain the distorted x/y 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 280 of file OsirisRexDistortionMap.cpp.
References m_debug, m_detectorOriginLine, m_detectorOriginSample, m_distortionOriginLine, m_distortionOriginSample, m_pixelPitch, Isis::CameraDistortionMap::p_focalPlaneX, Isis::CameraDistortionMap::p_focalPlaneY, Isis::CameraDistortionMap::p_odk, Isis::CameraDistortionMap::p_undistortedFocalPlaneX, and Isis::CameraDistortionMap::p_undistortedFocalPlaneY.
| double Isis::CameraDistortionMap::UndistortedFocalPlaneZ |
( |
| ) |
const |
|
inherited |
