Isis 2 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
Parm | Description | Default |
---|---|---|
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 |
ADDITIONAL NOTES:
Parm | Description |
---|---|
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 |
Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov