USGS

Isis 2 Documentation


pt2pt Documentation

pt2pt - Create TFILE for IMP cube point-to-point conversion.
Create the transformation data file(s) for geom (see geom for more in-
formation) to convert Mars Pathfinder IMP LEVEL1 cubes to a different
LEVEL1 point perspective.  This program does not do the actual trans-
formation of the cube.  Geom must be run using the TFILE(s) created by
this program.  The new point perspective is produced by inputting cam-
era parameters different from the input cube.  The source of the new
parameters can be from:

TAE parameters
Target file labels
Camera lookup table file:
  User input or
  Default (imp_camera.sav)
Over all default:
  Camera & mast default to the
    input image.
  Filter defaults to red (5).
  Scale defaults to .001
    radians per pixel.
  The rest are found in
    imp_camera.sav.

PROGRAMMER: K. Teal Thompson, USGS, Flagstaff, Az

ParmDescriptionDefault
FROM
Input cube name
Level 1's only
(default extension is .cub)
NONE
TFILE
Transformation file
(no default extension)
tfile.dat
TFILE2
2nd transformation file
(no default extension)
tfile2.dat
OBSERVR
Imaginary observer position.
(LEFT,CENTER,RIGHT)
Use:
OBSERVR or (GAMMA & BASELN)
--
GAMMA
Select toe-in angle
Use this with BASELN.
Don't use with OBSERVR.
--
BASELN
Select distance between stereo
cameras (for projection pur-
poses).  Use this with GAMMA.
Don't use with OBSERVR.
--
MAST
Select a set imaginary
mast height (for projection
purposes).
(STOWED,DEPLOYED)
use MAST or GIMBAL
--
GIMBAL
Select a mast height value
(for projection purposes).
use MAST or GIMBAL
--
MAG
Magnification that pt2pt must
use if you already magnified
your input image.
1.
COMAZ
Command Azimuth
--
COMEL
Command Elevation
--
TWIST
Effective twist
--
QUATER
Quaternion
--
FILTER
Camera filter
0 through 11
--
RLINE
Line range
--
RSAMP
Sample range
--
TARGET
Target image labels
(Individual parameters may
be overridden by TAE inputs.)
--
CAMFILE
User requested camera
parameter lookup file.
Defaults to imp_camera.sav.
(Individual parameters in
CAMFILE may be overridden by
the TAE inputs.  All the par-
ameters overridden by a target
file input.)
--
DIR
User requested directory.
Defaults to $ISISIMPDATA.
(see CAMFILE)
--

ADDITIONAL NOTES:

ParmDescription
FROM
Input cube file name.  If the file extension is omitted,
then ".cub" will be assumed.
TFILE
Name given to a data file needed by geom.  After
this program has finished, geom must be run to actually
transform the cube.
TFILE2
See TFILE help, in addition, this 2nd transformation
file is used when az range includes 180.
In this case two tfiles are generated,
TFILE covering azimuth in [a,190] where a>0 & a<180; and
TFILE2 covering azimuth in [-190,b] where b<0 & b>-180;
note that the two images have overlap in the region within
10 degrees of 180.
OBSERVR
Allows the user to reproject the image to an imaginary ob-
server's perspective other than the original.  For example,
a left image could be reprojected to a right image.  Center
is for non-stereo.  Use either OBSERVR or GAMMA and BASELN.
GAMMA
Allows the user to reproject the image to an imaginary ob-
server's perspective other than the original by actually
inputting a value for the angle that the camera "toes in".
This parameter should not be used without BASELN, the dis-
tance between the stereo cameras, being selected also.  The
parameter OBSERVR will set an appropriate GAMMA and BASELN
for you to project to a new viewpoint.  Use either OBSERVR
or GAMMA and BASELN.
BASELN
Allows the user to reproject the image to an imaginary ob-
server's perspective other than the original by actually
inputting a value for the distance between the stereo camer-
as.  This parameter should not be used without GAMMA,the an-
gle that the camera "toes in", being selected also.  The
parameter OBSERVR will set an appropriate GAMMA and BASELN
for you to project to a new viewpoint.  Use either OBSERVR
or GAMMA and BASELN.
MAST
Allows the user to reproject the image to an imaginary ob-
server's perspective other than the original.  For example,
a stowed image could be reprojected to the deployed perspec-
tive and could then be mosaiced with other deployed images.
"pt2pt" will set the GIMBAL (MAST height) for you.  Use
MAST or GIMBAL but not both.
GIMBAL
Allows the user to reproject the image to an imaginary ob-
server's perspective other than the original by actually in-
putting a value for the height of the GIMBAL (MAST).  Use
MAST or GIMBAL but not both.
MAG
Allows a user to magnify input images and still be able to
use "pt2pt".  Normal images would never need anything but
the default setting of 1.0.
COMAZ
The user may input a desired command azimuth.
COMEL
The user may input a desired command elevation.
TWIST
The user may input a desired twist for the frame.
QUATER
The user may input a desired Lander Surface Quaternion.
FILTER
The user may input a desired Filter number.
RLINE
Line range.  The default procedure uses the line range
of the input cube adjusted for the new perspective.
RSAMP
Sample range.  The default procedure uses the sample
range of the input cube adjusted for the new perspective.
TARGET
If a parameter needed to describe an IMP image is not over-
ridden in TAE, then the program comes here and gets the
parameters off of the target image.  If there's not a TAR-
GET, then "pt2pt" goes to the CAMFILE input by the user or
the default camera file, imp_camera.sav, to get the camera
parameters.
CAMFILE
Alternate camera lookup table so the user can define differ-
ent camera parameters.  If nothing is input, the CAMFILE de-
faults to imp_camera.sav.  Use a format like imp_camera.sav
in $ISISIMPDATA
DIR
Directory for "CAMFILE" alternate camera lookup table.  If
nothing is input, the directory defaults to $ISISIMPDATA.
The program can take an environment variable for a directory
as long as it starts with ISIS.  Don't put a "$" sign in
front.  Also, a regular directory such as:
  "." or
  "/work1/mmouse/imp"
can be used.

Last updated: Jan 31 2005
File: pdfs2.html

Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov

ISIS Documentation Home Page