Help for MARSXYZSURF

PURPOSE:
Simple program to compute a "fake" xyz product by projecting the
camera model to a surface. 

The program supports the same procedural surface models as marsfakedisp
including planes, spheres, and mesh files. 

The output format is similar to the product made by marsxyz.

marsxyzsurf will generate either three separate one-band files (x, y, z), or
a single 3-band file, depending on the number of filenames given. The output
files are in the coordinates of the input image. This means there
is a 1:1 correspondence between output pixels and the input file.

Units of XYZ are in meters, in the coordinate system specified by the
COORD and COORD_SYS parameters.

EXECUTION:
marsxyzsurf inp=input.img out=xyz.img SURF_MESH=input.obj SURFACE=MESH 
SURF_COORD=Rover

where:
input.img is the input image
xyz.img is a 3-band file with the X, Y, and Z values at that pixel in meters.
input.obj is the input mesh (.obj) file

This example uses an .obj mesh file as the surface to use to generate the xyz 
product.

METHOD:

marsxyzsurf intersects the ray through each pixel of the output image 
against the requested surface model to records the x, y, z values


COGNIZANT PROGRAMMER:  Bob Deen

HISTORY: 
Jan. 2021 Initial Version: Bob Crocco


PARAMETERS:


INP

Input image. Must be 1.

OUT

Output files (x,y,z) triplet or 1 3-band file.

NAVTABLE

Corrected navigation filename.

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, MESH.

SURF_MESH

Mesh file for surface model

SURF_CSFILE

File containing CS for surface model

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

WRITE_CM

Writes the camera model to the file.

See Examples:


Cognizant Programmer: