Help for MAPCOORD

PURPOSE:

MAPCOORD converts from (line,sample) to (latitude,longitude) coordinates, or
vice-versa, for a given VICAR image.

EXECUTION:

    MAPCOORD INP=A COORDTYPE=LINSAM COORDIN=(1,1,45,700,600,600)
    MAPCOORD INP=A COORDTYPE=LATLON COORDIN=(22.7,33.5,90.,0.)
where
    INP is a VICAR image.  INP may be a map-projected or raw (image or object
        space) image.
    COORDTYPE specifies whether the input coordinates are line-sample or
        latitude-longitude.

OPERATION:

If the input image has a map-projection label (created by MAP3 or PERSLAB),
then this label is used to determine the image geometry.

If not, the image is assumed to be an unprojected image (either image-space or
object-space). The program searches the label history for GEOM or FARENC to
determine whether it is image or object space.  If the image is image-space,
nominal geometric distortion parameters are generated.  An attempt is made to
retrieve the SPICE data for the image.  Only if all this is successful will the
program continue with the line-sample to lat-lon calculations.

PARAMETERS FOR RETRIEVING CAMERA POINTING FROM SPICE:

The following parameters permit the user to retrieve a specific instance of
camera pointing from the SPICE kernels:

SPICEMODE specifies whether SPICE data is retrieved from LOCAL kernels or
or via the REMOTE SPICE server.  If defaulted, SPICEMODE is set to the value
of the environmental variable DEFAULTSPICE.

CKNAME and CKID are alternative ways to specify the C kernel to be used.  For
example, CKNAME=FARE or CKID=M904 specifies that MIPS_FARENC.CK is to be used.
When specified, the CKID parameter overrides the CKNAME parameter.  If the
camera pointing data is not found in the requested C kernel, the other C kernels
are searched.

Within a given C kernel, there may be a number of different versions of camera
pointing for a given image.  The segment identifier for each version contains
provenance information identifying the creator of the pointing data.  One or
more of the following parameters may be used to retrieve a specific instance of
camera pointing based upon this provenance information:

CDATE specifies the date and time the camera pointing was created.
REQNUM identifies the request number associated with the camera pointing.
PURPOSE identifies the purpose for creating the camera pointing.
PROGRAM identifies the program which created the camera pointing.
SPKID identifies the SP-kernel used to create the camera pointing.
USERID identifies the user who created the camera pointing.
GROUPID identifies the group which created the camera pointing.
INSTITUTE identifies the facility which created the camera pointing.

A complete list of CK and SPK IDs are located in the ASCII file assigned the
logical name (or environmental variable) KERNELDB.

The above parameters are optional, and if defaulted (or if no data is found for
the requested version), the program will attempt to locate the "best" data
available for the given image.  See the level 2 help (via the TAE tutor mode)
for further details.

Examples:  'LOCAL CKNAME=NAIF specifies that SPICE data be retrieved from
          local kernels using camera pointing from predicts or AACS telemetry.

           'REMOTE CKNAME=FARE INSTITUTE=MIPS SPKID=N015 USERID=ADC retrieves
          the camera pointing created by Amy Culver at MIPS using the SP kernel
          GLL_LONG_2.BSP from file MIPS_FARENC.CK via the SPICE server.  (whew!)

It takes longer to search for SPICE data on the basis of provenance
information.  If all provenance parameters are specified, for example, the
program first searches through all the C kernels for an exact match.  If no
match is found, the search is relaxed by removing the CDATE criteria.  If no
match is found, the REQNUM criteria is removed.  Etc.

HISTORY:

WRITTEN BY      : JEAN LORRE	07/01/93
PORTED TO VICAR : RRP          04/21/97
REVISIONS:

21 MAY 98  GMY  Replace call to GETSPICE with call to GETSPICE4.