Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


noproj

Printer Friendly View | TOC | Home

Removes camera distortions in a raw level 1 cube creating an ideal version of the cube.

Overview Parameters

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:
  • noproj

Related Objects and Documents

Applications


History

Debbie A. Cook2006-11-14 Original version
Debbie A. Cook2007-02-13 Corrected for case where original instrument has negative affine coefficients
Debbie A. Cook2007-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. Cook2007-05-21 Changed category to Cameras
Debbie A. Cook2007-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. Cook2007-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 Lambright2008-05-13 Removed references to CubeInfo
Debbie A. Cook2009-01-26 Completed applying summing mode to ideal camera by applying it to the sample/line translations.
Debbie A. Cook2009-03-25 Fixed setting of et to correspond to first line of parent (Alpha cube)
Debbie A. Cook2012-07-06 Updated Spice members to be more compliant with Isis coding standards. References #972.
Steven Lambright2012-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 Humphrey2017-08-19 No longer propagates AlphaCube group to output cube. Fixes #4907.
Kaitlyn Lee2021-03-31 Refactored app to be callable and converted its tests to GTests.
Kris Becker2021-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 Becker2021-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 Edmundson2023-12-14 Incorporated Kris Becker's 2021-05-06 bug fix above into USGS code base.
Ken Edmundson2024-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
SOURCEDefines how the summing mode in the output noproj'd file is obtained
SUMMINGMODESumming Mode

Options

Name Description
INTERPType of interpolation
SAMPEXP Sample expansion percentage
LINEEXP Line expansion percentage
X

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
Close Window
X

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
Close Window
X

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
Close Window
X

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
Close Window
X

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
FROMMATCHGet from input MATCH cube This option will automatically determine the output summing mode from the cube to match specified using the MATCH parameter

Exclusions

  • SUMMINGMODE
FROMINPUTGet from input FROM cube This option will automatically determine the output summing mode from the cube to match specified using the FROM parameter

Exclusions

  • SUMMINGMODE
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.
Close Window
X

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)
Close Window
X

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
NEARESTNEIGHBORNearest Neighbor Each output pixel will be set to the pixel nearest the calculated input pixel.
BILINEARBi-Linear interpolation Each output pixel will be set to the value calculated by a bi-linear interpolation of the calculated input pixel.
CUBICCONVOLUTIONCubic Convolution interpolation Each output pixel will be set to the value calculated by a cubic convolution interpolation of the calculated input pixel.
Close Window
X

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.

Type double
Default 0.0
Close Window
X

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.

Type double
Default 0.0
Close Window