ISIS Application Documentation
Removes camera distortions in a raw level 1 cube creating an ideal version of the cube.
Description
This program will modify the cube labels for the Ideal camera.
The original Instrument group is renamed OriginalInstrument and a new
instrument group is created for the Ideal Camera. The cube data
is modified when this program runs cam2cam, creating the noproj'd
output cube with camera distortions removed.
Note that noproj will not propagate AlphaCube groups from the match cube into the output
cube since noproj is resampling the image.
Categories
Related Applications to Previous Versions of ISIS
This program replaces the following
application
existing in previous versions of ISIS:
Applications
History
| Debbie A. Cook | 2006-11-14 |
Original version
|
| Debbie A. Cook | 2007-02-13 |
Corrected for case where original instrument has negative affine coefficients
|
| Debbie A. Cook | 2007-04-24 |
Added INTERP option, fixed SPECS parameter to allow user to override the default and enter a file, and updated the documentation
|
| Debbie A. Cook | 2007-05-21 |
Changed category to Cameras
|
| Debbie A. Cook | 2007-06-12 |
Corrected order of SetInputCube calls to set the MATCH cube first if is entered so that the labels on the cube to match are propagated from it and not the from cube
|
| Debbie A. Cook | 2007-08-31 |
Turned off propagation of the polygon blobs because the file name contains "/" from
the serial number and unix does not allow "/". Also added a remove of the match file
OriginalInstrument group written by cam2cam before writing the input OriginalInstrument.
hijitreg reads the input CcdId from this group.
|
| Steven Lambright | 2008-05-13 |
Removed references to CubeInfo
|
| Debbie A. Cook | 2009-01-26 |
Completed applying summing mode to ideal camera by applying it to the sample/line translations.
|
| Debbie A. Cook | 2009-03-25 |
Fixed setting of et to correspond to first line of parent (Alpha cube)
|
| Debbie A. Cook | 2012-07-06 |
Updated Spice members to be more compliant with Isis coding standards. References #972.
|
| Steven Lambright | 2012-09-10 |
This program will now modify the NaifKeywords object, if it exists, instead of the instrument
group with the following keywords: TransX (becomes IDEAL_TRANSX),
TransY (becomes IDEAL_TRANSY), TransS0 (becomes IDEAL_TRANSS), TransL0 (becomes IDEAL_TRANSL),
PixelPitch (becomes IDEAL_PIXEL_PITCH), and FocalLength (becomes IDEAL_FOCAL_LENGTH).
Fixes #1094.
|
| Ian Humphrey | 2017-08-19 |
No longer propagates AlphaCube group to output cube. Fixes #4907.
|
| Kaitlyn Lee | 2021-03-31 |
Refactored app to be callable and converted its tests to GTests.
|
| Kris Becker | 2021-05-06 |
Added checks for ray tracing options in UofA OSIRIS-REx ISIS code base.
The keywords needed for Bullet to operate properly are RayTraceEngine,
BulletParts, and Tolerance. These parameters must be included in the
output label in order for cam2cam to run and subsequent use is consistent.
|
| Kris Becker | 2021-09-22 |
Rework how temporary external files are identified in UofA OSIRIS-REx
ISIS code base after use by cam2cam and ensure they are all deleted. Fixes
#4813.
|
| Ken Edmundson | 2023-12-14 |
Incorporated Kris Becker's 2021-05-06 bug fix above into USGS code base.
|
| Ken Edmundson | 2024-01-09 |
Incorporated Kris Becker's 2021-09-22 bug fix above into USGS code base.
|
|
Parameter Groups
Files
|
Name
|
Description
|
| FROM |
Input cube
|
| MATCH |
Instrument cube to match
|
| SPECS |
Ideal camera specifications file
|
| TO |
Output cube
|
Output Summing Mode
|
Name
|
Description
|
| SOURCE | Defines how the summing mode in the output noproj'd file is obtained |
| SUMMINGMODE | Summing Mode |
Options
|
Name
|
Description
|
| INTERP | Type of interpolation |
| SAMPEXP | Sample expansion percentage |
| LINEEXP | Line expansion percentage |
|
Files:
FROM
Description
This cube will have the camera distortions removed based on the correction for the MATCH file and output to the TO file.
|
Type
| cube |
|
File Mode
| input |
|
Filter
|
*.cub
|
Files:
MATCH
Description
This is the level 1 cube whose labels will be converted to the Ideal instrument and used as the cube to match. It must have only one band so use the input attributes to select the band to match. For example,
themis.cub+5
|
Type
| cube |
|
File Mode
| input |
|
Internal Default
|
Match cube
|
|
Filter
|
*.cub
|
Files:
SPECS
Description
This file contains the specifications for the "ideal" camera based on the original instrument. If no value is entered, the default
specs file will be read from "$ISISROOT/appdata/templates/noproj/noprojInstruments.pvl"
|
Type
| filename |
|
File Mode
| input |
|
Default Path
|
$ISISROOT/appdata/templates/noproj/
|
|
Internal Default
|
SystemDefault
|
|
Filter
|
*.pvl
|
Files:
TO
Description
This file will be a copy of the input cube with the labels modified for the Ideal Camera
cubes.
|
Type
| cube |
|
File Mode
| output |
Output Summing Mode:
SOURCE
Description
This parameter is used to specify how the summing mode is obtained for the output
noproj'd cube. The pixel pitch of the output file will be set to the summing mode times the pixel
pitch of the input file. The output pixel pitch is written to the labels of the noproj'd cube.
Note:: The user can override the default using the USER parameter.
|
Type
| string |
|
Default
| FROMMATCH |
|
Option List:
|
|
Option |
Brief |
Description |
| FROMMATCH | Get from input MATCH cube |
This option will automatically determine the output summing mode from the cube to match specified using
the MATCH parameter
Exclusions
|
| FROMINPUT | Get from input FROM cube |
This option will automatically determine the output summing mode from the cube to match specified using
the FROM parameter
Exclusions
|
| FROMUSER | Get summing mode from user |
This option allows the user to specify the summing mode to be applied to the input file pixel pitch (mm/pix)
to determine the output pixel pitch.
|
|
Output Summing Mode:
SUMMINGMODE
Description
Specifies the summing mode to multiply times the input file (FROM) camera pixel pitch (mm/pix) to determine the
output noproj'd file pixel pitch (pixel size in mm). This value is written to the output file labels
|
Type
| double |
|
Minimum
| 1.0
(inclusive)
|
Options:
INTERP
Description
This is the type of interpolation to be performed on the input in cam2cam.
|
Type
| string |
|
Default
|
CUBICCONVOLUTION
|
|
Option List:
|
|
Option |
Brief |
Description |
| NEARESTNEIGHBOR | Nearest Neighbor |
Each output pixel will be set to the pixel nearest the calculated input pixel.
|
| BILINEAR | Bi-Linear interpolation |
Each output pixel will be set to the value calculated by a bi-linear interpolation of the calculated input pixel.
|
| CUBICCONVOLUTION | Cubic Convolution interpolation |
Each output pixel will be set to the value calculated by a cubic convolution interpolation of the calculated input pixel.
|
|
Options:
SAMPEXP
Description
This parameter expands the size of the output file in samples beyond the default size to prevent cropping of the
undistorted image. The undistorted image may be larger than the raw distorted image.
Options:
LINEEXP
Description
This parameter expands the size of the output file in lines beyond the default size to prevent cropping of the
undistorted image. The undistorted image may be larger than the raw distorted image.