USGS

Isis 2 Documentation


pan2plan Documentation

pan2plan - Create TFILE for Mars Pathfinder IMP cube map projections
Create the transformation data file(s) for geom (see geom for more
information) to project Mars Pathfinder IMP LEVEL 1 cubes to a
specified map projection. This program does not do the actual
transformation of the cube, geom must be run using the TFILE(s)
created by this program.  If the map resolution is not input,
it is calculated by the program to retain the full resolution of
the LEVEL 1 cube.

PROGRAMMER: K Teal Thompson, USGS, Flagstaff, Az

ParmDescriptionDefault
FROM
Input cube name
(default extension is .cub)
NONE
TFILE
Transformation file
(no default extension)
tfile.dat
TFILE2
2nd transformation file
(no default extension)
tfile2.dat
SPLIT
Split into two t-files or not?
"NO"
OBSERVER
Imaginary observer position
horizontal
L=left
C=center
R=right

   or
--
GAMMA
Select toe-in angle

  and
--
BASELN
Select distance between stereo
cameras (for projection
purposes).

OBSERVER or (GAMMA & BASELN)
--
MAST
Imaginary observer position
vertical
S=stowed
D=deployed

   or
--
GIMBAL
Select a mast height value
--
MAG
Magnification that pan2plan must
use if you already magnified
your input image.
1.
DMAX
Maximum radial trim
or distance (m).  Use
30 or less for 'PLAN'
--
DMIN
Minimum radial trim
or distance (m).
Don't use 0.0
--
FILTER
Camera filter
0 through 11
--
RPPXO
Image resolution (rad/pix)
--
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 the
camfile may be overridden by
the TAE inputs.  All the par-
ameters overridden by a target
input)
--
DIR
User requested directory
defaults to $ISISIMPDATA
(see CAMFILE)
--
XMAX
Trim to this maximum LSC
x value
30.
XMIN
Trim to this minimum LSC
x value
-30.
YMAX
Trim to this maximum LSC
y value
30.
YMIN
Trim to this minimum LSC
y value
-30.

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.
SPLIT
YES = make two tfiles for panoramas near AZ=180 deg
No = make one tfile for panoramas near AZ=180 deg
Ignored in all cases except panoramas near AZ=180
OBSERVER
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 OBSERVER 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 OBSERVER will set an appropriate GAMMA and BASELN
for you to project to a new viewpoint.  Use either OBSERVER
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 OBSERVER will set an appropriate GAMMA and BASELN
for you to project to a new viewpoint.  Use either OBSERVER
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 mosaicked with other deployed images.
"pan2plan" 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 "pan2plan".  Normal images would never need anything but
the default setting of 1.0.
DMAX
Specifies maximum distance to be included in the output
image.   This parameter defaults to the highest elevation
of the imput image.  Selecting a DMAX of 30 meters for
images that approach the horizon will trim out the "smeared"
outer edges of the planimetric projection and reduce the
size of the output image and the time for processing.
DMIN
Specifies minimum distance to be included in the output
image.  This parameter defaults to the lowest elevation
of the imput image.
FILTER
The user may input a desired Filter number.
RPPXO
Specifies the map resolution in rad/pixel.  The default
will find the map resolution equal to that of the input
cube.
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.
XMAX
The planimetric projection will be trimmed within an LSC
(Landing Site Cartographic coordinate system) rectangle
defined by the minimum and maximum x and y values input
by the user.  The min values default to -30 and the max
values default to 30 meters.
XMIN
See XMAX
YMAX
See XMAX
YMIN
See XMAX

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