Help for MARSPROJ
PURPOSE:
Simple program to accept an XYZ coordinate (expressed in the coordinate
frame specified by COORD), project it through the camera model, and report
the line/sample coordinates of the point in the supplied image.
The coordinates can be output to TAE variables as well via IMAGE_POS
(use v2param to access them).
In some sense, this program is the inverse of marstiexyz. That takes a
tiepoint in a stereo pair and reports the XYZ location; this takes an XYZ
location and reports the image position. A stereo image is not needed for
this process.
TBD: Implement reverse projection: given a line/sample position, report
the view ray origin and vector, and its intersection (if any) with the
surface model. Possibly even its intersection with another view ray a la
marsxyz.
EXECUTION:
marsproj inp=input.img xyz=\(3.4, 2.2, -1.0\) -rover
METHOD:
marsproj takes the given point, projects it through the camera model, and
reports the result. Couldn't be simpler.
HISTORY:
Oct. 07 Initial version: B. Deen
COGNIZANT PROGRAMMER: Bob Deen
PARAMETERS:
INP
Input image.
Must be 1.
NAVTABLE
Corrected navigation
filename.
XYZ
Input XYZ coordinate
IMAGE_POS
Optional output
line/sample coordinate
CONFIG_PATH
Path used to find
configuration/calibration
files.
POINT_METHOD
Specifies a mission-
specific pointing
method to use
MATCH_METHOD
Specifies a method
for pointing corrections.
MATCH_TOL
Tolerance value for
matching pointing params
in pointing corrections file.
NORMAL
Surface normal vector.
GROUND
Surface ground point.
SURF_COORD
Coordinate system used to define
surface parameters.
SURFACE
The type of mars
surface to use
INFINITY, PLANE, SPHERE1, SPHERE2.
RSF
Rover State File(s) to use.
DEBUG_RSF
Turns on debugging of RSF
parameter.
COORD
Coordinate system to use.
COORD_INDEX
Coordinate system index for
some COORD/mission combos.
FIXED_SITE
Which site is FIXED for
rover missions.
SOLUTION_ID
Solution ID to use for
COORD_INDEX
See Examples:
Cognizant Programmer: