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: