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: