Level 2 Help for GLLMASK

INP

Examples:
   INP=PIC               (for B/W playback)
   INP=(RED,GRN,BLU)     (for color playback)
      where RED,GRN,BLU are input images representing a red-green-blue color
      triplet.
The input images (PIC,RED,GRN,BLU) must be Galileo SSI images.  They may be
in byte or halfword data format and of arbitrary size.  However, see
restrictions for systematic processing (SYS parameter).


OUT

Examples:
   OUT=MSK		(B/W mask output)
   OUT=CMSK		(color mask output)

The masked images (MSK and CMSK) will be in byte data format and may be
submitted for film recorder playback via input to program BARNE.  CMSK will
be a 3-dimensional VICAR file containing the three (RGB) color planes in
band-sequential (BSQ) format.


UDR

Specifies UDR file(s) corresponding to the input image.  The histograms for
the raw version(s) are extracted from these files and displayed on the mask.
  Examples:
        UDR=udr				(for B/W mask)
        UDR=(udr1,udr2,udr3,...)        (for color mask)


EDR

Specifies the EDR (Experiment Data Record) corresponding to the input image.
The histogram of the raw image is extracted from the binary header of the EDR.
  Examples:
	EDR=edr				(for B/W mask)
	EDR=(edr1,edr1,edr3,...)	(for color mask)


EHIST

Specifies the histogram of the radiometric correction version of the image.
The histogram may be generated via program HICCUP.


PHIST

Specifies the histogram of the processed version of the image.
The histogram may be generated via program HICCUP.


SHIST

Specifies the histogram of the stretched version of the image.
The histogram may be generated via program HICCUP.


TITLE

24 character frame title.  The title is displayed at the top of the masked
image.


RTITLE

Annotation to be included below the processed version histogram and associated
with the RED input.


GTITLE

Annotation to be included below the processed version histogram and associated
with the GREEN input.


BTITLE

Annotation to be included below the processed version histogram and associated
with the BLUE input.


STRETCH

Specifies that a linear stretch is to be applied to the input image.
Ex:  STRETCH=(n1,n2)
where n1 and n2 are the low and high stretch limits.  A linear transformation
is applied to the input DN values such that n1 is mapped to 0 DN and n2 is
mapped to 255 DN.


RSTRETCH

  Ex:  RSTRE=(5,150) causes the input red image to be linearly stretched to
       saturate all DNs lower than 6 and higher than 149 prior to display.
Low and high stretch limits for red image


GSTRETCH

  Ex:  GSTRE=(5,150) causes the input green image to be linearly stretched to
       saturate all DNs lower than 6 and higher than 149 prior to display.


BSTRETCH

  Ex:  BSTRE=(5,150) causes the input blue image to be linearly stretched to
       saturate all DNs lower than 6 and higher than 149 prior to display.


ASTRETCH

Specifies that a linear stretch is to be applied to the input image.
Ex:  ASTRE=r1
The low and high stretch limits are automatically computed such that r1 percent
of the data is saturated at 0 DN and 255 DN in the output image.  Note that for
red, green, blue inputs, the same percent saturation is applied to all three
images.  See also parameter STRETCH.


IOF

Keyword 'IOF specifies that the histogram for the RADIOMETRIC CORRECTION
version of the image shall be scaled to units of reflectance.  The default
scale is the scale output by GALSOS.


RADIANCE

Keyword 'RADIANCE specifies that the histogram for the RADIOMETRIC CORRECTION
version shall be scaled to units of nanowatts/cm**2/steradian/nanometer.


PRO

Specifies that input image is processed version


SYS

If the keyword 'SYS is specified, GLLMASK will restrict the output mask
format as follows:
  1) If the input image is exactly 400x400 (summation-mode) or 800x800
     (full-frame), the output mask will be 1133x1533.
  2) All other images will be magnified by an integral factor so that the
     output image fits within a 1700x2300 output mask.
The input image may be no larger than 1367x1567.  If the image is larger,
the error message: "***Input image too large for systematic processing"
is printed and the task aborted.


CDEDR

CDROM volume-id on which the EDR corresponding to the input image(s) are
archived.  The volume-id is recorded in the label display on the right margin
of the mask.  If the image is associated with an REDR, use parameter CDREDR
instead.  E.g. GO_0002 (max of 16 characters).


CDREDR

CDROM volume-id on which the REDR corresponding to the input image(s) are
archived.  The volume-id is recorded in the label display on the right margin
of the mask.  If the image is associated with an EDR, use parameter CDEDR
instead.  E.g. GO_0002 (max of 16 characters).


COMMENT

Optional text (up to 64 characters) to be inserted at the bottom of the mask.


INSTANCE

To allow more than one HISTOGRAM in a single IBIS file, this
parameter allows the definition of an INSTANCE name, by which
each set may be referenced.


SCALEBAR

Keyword to control the display of scalebar. Default is to display the scale bar.


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.


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.


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.


SCALE

Use this parameter if you would like to override the scale value determined by the
subroutine picscale to draw the scalebar.  The value should be in Meters/pixel and 
the parameters LINE and SAMP should also be specified.  SCALE can be used when a 
mosaic or map projected image is supplied for masking instead of a single raw or
galsosed image.  This option will cancel the display of the Orientation Box.


LINE

Use this parameter if you use the SCALE parameter to override the scale value 
determined by the subroutine picscale to draw the scalebar.  The value should be 
the location at which the scale is calculated.  SCALE and SAMP should also be 
specified.  SCALE, LINE and SAMP can be used when a mosaic or map projected 
image is supplied for masking instead of a single raw or galsosed image.
This option will cancel the display of the Orientation Box.


SAMP

Use this parameter if you use the SCALE parameter to override the scale value 
determined by the subroutine picscale to draw the scalebar.  The value should be 
the location at which the scale is calculated.  SCALE and LINE should also be 
specified.  SCALE, LINE and SAMP can be used when a mosaic or map projected 
image is supplied for masking instead of a single raw or galsosed image.
This option will cancel the display of the Orientation Box.