Level 2 Help for MAPCOORD

INP

 THE NAME OF A STANDARD VICAR IMAGE FILE FROM WHOM COORDINATES WILL BE
MEASURED.


COORDTYPE

  SPECIFY IF THE GIVEN COORDIN IS LATLON OR LINESAMP.


COORDIN

(LINE,SAMPLE) VALUES INPUT IN PAIRS. UP TO 80 INPUT PAIRS.
FOR EACH PAIR THE CORRESPONDING LAT,LON WILL BE COMPUTED AND PRINTED.


SEDRSRC

 KEYWORD--OPTIONAL
 SPECIFIES DESIRED SOURCE OF C-MATRIX, ME-MATRIX, AND TARGET-TO-SPACECRAFT
 VECTOR (RS).  VALID VALUES ARE:
	DAVI	--DATA DETERMINED BY MERT DAVIES
	NAV     --DATA DETERMINED BY PROGRAM NAV
	FARE    --DATA DETERMINED BY PROGRAM FARENC
	NAV2    --DATA DETERMINED BY PROGRAM NAV2
	NEAR    --DATA DETERMINED BY PROGRAM NEARENC
 IF THIS KEYWORD IS NOT SPECIFIED, OR IF THE SPECIFIED SOURCE DOES NOT EXIST,
 THE NAVIGATION DATA WILL BE SELECTED FROM THE AVAILABLE SOURCES, IN THE
 FOLLOWING ORDER OF PRIORITY: (1) DAVI, (2) NAV, (3) FARE, (4) NAV2,
 (5) NEAR, (6) PREDICT OR FINAL SEDR.


OUT_LAT

AN OUTPUT NAME PARAMETER THAT RETURNS THE LATITUDES or line value FOR 
EACH INPUT POINT.
If COORDTYPE=LINSAM then OUT_LAT is a latitude.
If COORDTYPE=LATLON then OUT_LAT is a line number.
THE VARIABLE GIVEN FOR OUT_LAT SHOULD BE OF TYPE REAL AND SHOULD HAVE A COUNT
BIG ENOUGH TO HOLD ALL THE COORDINATES.  THE MAXIMUM IS 80 COORDINATES.

NOTE THAT THE INPUT COORDINATES ARE IN A SINGLE PARAMETER, COORDIN, AS PAIRS,
WHILE THE OUTPUT COORDINATES ARE IN TWO SEPARATE PARAMETERS, OUT_LAT AND
OUT_LON, WHICH ARE EACH HALF AS BIG.

OUT_LAT IS OPTIONAL; IF NO VARIABLE IS GIVEN THEN THE VALUES ARE NOT RETURNED.


OUT_LON

AN OUTPUT NAME PARAMETER THAT RETURNS THE LONGITUDES or sample values FOR 
EACH INPUT POINT.
If COORDTYPE=LINSAM then OUT_LON is a longitude.
If COORDTYPE=LATLON then OUT_LON is a sample number.
THE VARIABLE GIVEN FOR OUT_LON SHOULD BE OF TYPE REAL AND SHOULD HAVE A COUNT
BIG ENOUGH TO HOLD ALL THE COORDINATES.  THE MAXIMUM IS 80 COORDINATES.

NOTE THAT THE INPUT COORDINATES ARE IN A SINGLE PARAMETER, COORDIN, AS PAIRS,
WHILE THE OUTPUT COORDINATES ARE IN TWO SEPARATE PARAMETERS, OUT_LAT AND
OUT_LON, WHICH ARE EACH HALF AS BIG.

OUT_LON IS OPTIONAL; IF NO VARIABLE IS GIVEN THEN THE VALUES ARE NOT RETURNED.


TARGET

Ex: TARGET=GANYMEDE specifies that GANYMEDE is the target in the input image.

The TARGET may be a planet, satellite, or asteroid.  If defaulted, the target
name is extracted from the VICAR label or determined by other TBD means.

A complete list of valid target names is located in the ASCII file assigned
the logical name (or environmental variable) BODY_IDS.


SPICEMODE

SPICEMODE=LOCAL specifies that SPICE data is to be retrieved from local
SPICE kernels.  SPICEMODE=REMOTE specifies that SPICE data is to be retrieved
via the SPICE server.  If SPICEMODE is defaulted, the logical name (or
environmental variable) DEFAULTSPICE is used to determine whether LOCAL or
REMOTE is used.  Note that if SPICE data is not found in LOCAL or REMOTE mode,
the other mode is attempted.


CKNAME

CKNAME is a four character string specifying the C-kernel to be used:

  CKNAME	C KERNEL
  --------      -------------
  DAVI		MIPS_DAVI.CK
  NAV		MIPS_NAV.CK
  FARE		MIPS_FARENC.CK
  NAV2		MIPS_NAV2.CK
  NEAR		MIPS_NEAR.CK
  AMOS		MIPS_AMOS.CK
  NAIF		the best NAIF kernel is used

If defaulted, the kernels are searched in the above order.


CKID

CKID is an alternative way to specify the prefered C-kernel (see CKNAME
parameter):

  CKID	  CKNAME	C KERNEL
  ----	  --------      -------------
  M906	  DAVI		MIPS_DAVI.CK
  M905	  NAV		MIPS_NAV.CK
  M904	  FARE		MIPS_FARENC.CK
  M903	  NAV2		MIPS_NAV2.CK
  M902	  NEAR		MIPS_NEAR.CK
  M901	  AMOS		MIPS_AMOS.CK
  varies  NAIF		there are a large number of these files

Ex:  CKID=M901 specifies the four character ID which uniquely identifies the
     C-kernel MIPS_AMOS.CK.

A complete list of the C-kernel IDs is located in the ASCII file assigned the
logical name (or environmental variable) KERNELDB.

If specified, CKID overrides the CKNAME parameter.


USERID

USERID is a three character string which identifies the user who created the
camera pointing.

Ex:  USERID=HBM identifies Helen Mortensen as the creator of the camera
     pointing.


GROUPID

GROUPID is a three character string which identifies the group which created the
camera pointing.

Ex:  GROUPID=040 identifies group 040 as the creator of the camera pointing.


INSTITUTE

INSTITUTE is a four character string identifying the facility which created
the camera pointing.

Ex:  INSTITUTE=MIPS specifies that MIPS created the camera pointing.


PURPOSE

PURPOSE is a four character string identifying the purpose of the observation
or the purpose of processing.  For example,
  PURPOSE=MOSA identifies the image as part of a mosaic sequence
  PURPOSE=COLO identifies the image as part of a color sequence


PROGRAM

PROGRAM is the first six characters of the program creating the camera pointing.

Ex:  PROGRAM=FARENC specifies that FARENC created the camera pointing.


SPKID

SPKID specifies the four character ID which uniquely identifies the
SP kernel used to create the camera pointing.  The SP-kernel IDs are located
in the ASCII file assigned the logical name (or environmental variable)
KERNELDB.

Ex:  SPKID=N015 specifies the SP kernel GLL_LONG_2.BSP


REQNUM

REQUNUM is a four character string identifying the IPL request number for
which the camera pointing was created.

Ex:  REQNUM=3456 identifies (somewhat) request number R123456


CDATE

Date and time the camera pointing was created in the form 'YEARMMDDHHMM'.

Ex:  CDATE=199602291200 specifies that the pointing was created at noon
     on February 29, 1996.