Help for MARSRANGE

PURPOSE:
MARSRANGE computes a cartesian distance between a reference point and an 
XYZ position of an input image.  The reference point is, by default, the camera
position as defined by the C-point of the CAHV-based camera model, this default
could be overridden by specifying ORIGIN input parameter.  The input for 
marsrange is an output of MARSXYZ program.  It could be either a 3-band single
file of type "REAL" where band #1 contains x-coordinates, band #2 y-coordinates
and band #3 z-coordinates values, or the input could contain three separate 
single band files of type "REAL" representing x,y,z values correspondingly.
The output of marsrange program is a single 1-band file of type REAL.

The input XYZ images may contain holes, nominally defined by MISSING_CONSTANT.
However, it is currently hardcoded that a value of (0,0,0) exactly is missing
data; MISSING_CONSTANT is ignored.  Missing data is reflected in the output
by a value of 0.

EXECUTION:
marsrange inp=xyz_data.img out=range_data.img
marsrange inp=(xyz_data_x.img,xyz_data_y.img,xyz_data_z.img) out=range_data.img
marsrange inp=xyz_data.img out=range_data.img origin=(0.0,0.0,1.0)
where:
xyz_data.img is an input 3-band image of type REAL with the X,Y and Z values
at that pixel in meters.
range_data.img is an output 1-band image of type REAL where each value is 
a distance between reference point(by default camera position) and (x,y,z) 
point.
xyz_data_x.img is an input 1-band image of type REAL
origin is an override for the input reference point.

Any program producing 3D position could be used; marsxyz is simply an example.

METHOD:
Marsrange computes, for each pixel, the distance between given reference point
(Px, Py, Pz) and (x,y,z) input pixel values by using the distance formula: 
D = sqrt( (x-Px)^2 + (y-Py)^2 + (z-Pz)^2)


Input file contents:

INP:  marsxyz(or similar)-generated either three separate one-band files 
(x, y, z), or a single 3-band file.  
Units of XYZ input file(s) are in meters, in the coordinate system specified 
by the COORD and COORD_SYS parameters.


COGNIZANT PROGRAMMER: O. Pariser

HISTORY:
  2002-11-25 O. Pariser and B. Deen - Initial marsrange
  2020-05-15 W. Bunch - replaced sprintfs; removed unused variables

PARAMETERS:

INP

Input images. Must be 1 3-band file or (x,y,z) triplet.

OUT

Output files Mast be 1 single band file.

ORIGIN

3D Point to compute range from.

CONFIG_PATH

Path used to find configuration/calibration files.

POINT_METHOD

Specifies a mission- specific pointing method to use

NOSITE

Disables coordinate system sites.

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

DATA_SET_NAME

Specifies the full name given to a data set or a data product.

DATA_SET_ID

Specifies a unique alphanumeric identifier for a data set or data product.

RELEASE_ID

Specifies the unique identifier associated with the release to the public of all or part of a data set. The release number is associated with the data set, not the mission.

PRODUCT_ID

Specifies a permanent, unique identifier assigned to a data product by its producer.

PRODUCER_ID

Specifies the unique identifier of an entity associated with the production a data set.

PRODUCER_INST

Specifies the full name of the identity of an entity associated with the production of a data set.