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