imp2prj Documentation

imp2prj - 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

Input cube name
Level 1's only
(default extension is .cub)

NONE

Transformation file
(no default extension)

tfile.dat

2nd transformation file
(no default extension)

tfile2.dat

Truth image to which "from"
cub is registered.

--

Subpixel registration file

--

Split into two t-files or not?

"NO"

Projection name
PLAN=orthographic planimetric
 projection
PAN=panoramic projection
 without vertical stereo
TPAN=panoramic projection
 with vertical stereo

"PAN"

imaginary observer position
horizontal
L=left
C=center
R=right

   or

--

Select toe-in angle

  and

--

Select distance between stereo
cameras (for projection
purposes.)

OBSEVER or (GAMMA & BASELN)

--

imaginary observer position
vertical
S=stowed
D=deployed

   or

--

Select a mast height value

--

Magnification that imp2prj must
use if you already magnified
your input image.

1.

Maximum distance (m)
use 30 for 'PLAN'

3000.

Camera filter
0 through 11

--

Elevation range

--

Azimuth range

--

Image resolution (rad/pix)

--

Target image labels.
(individual parameters may
be overridden by tae inputs.)

--

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)

--

user requested directory
defaults to $ISISIMPDATA
(see CAMFILE)

--

Trim to this maximum LSC
x value

30.

Trim to this minimum LSC
x value

-30.

Trim to this maximum LSC
y value

30.

Trim to this minimum LSC
y value

-30.

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
TFILE	This is the 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.
TFROM	Truth image for subpixel registration
SFILE	Subpixel registration file, a file generated by "coreg2", sub-pixel registration application. The offsets produced by "coreg2" are the linear line offset(1) and sample offset(1). At this time "imp2prj" cannot implement a nonlinear regi- stration using line/sample offsets (2) and (3).
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
PROJ	Projection name. PLAN = planimetric view, PLAN is restricted to elevation < 0. PAN = panorama view. The elevation is used for calculations so there is no vertical stereo. TPAN = panarama view. The tangent of the elevation is used so there IS vertical stereo.
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 perstec- tive and could then be mosaiced with other deployed images. "imp2prj" 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 "imp2prj". Normal images would never need anything but the default setting of 1.0.
DMAX	Specifies maximum distance to be included in the output image. DMAXS greater than or equal to 30000 means no restriction (appropriate for panoramas which are intended to include the horizon). Must be less than or equal to the horizon distance (~30000m) for planimetric projections.
FILTER	The user may input a desired Filter number.
REL	Elevation range (elevation defined as zero=horizontal, -90=down).The default procedure is use the elevation range of the cube.
RAZ	Azimuth range; the default procedure is to use the azimuth range of the cube. See RELS.
RPPXO	Specifies the map resolution in rad/pixels. 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- en 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