Level 2 Help for GALSOS

INP

   INP=IN
 where IN is an image to be radiometrically corrected (byte or halfword).


OUT

 OUT is the radiometrically corrected output image (16-bit data).


DIR

 DIR specifies the default disk and directory location of all calibration files.
 DIR may be specified as a VMS DISK:[DIR] or Unix pathname.
	DIR=WMS_GLL:[SSI.RAD]
     or DIR=/project/gll/ssi/rad/
 DIR may be overridden for specific files via parameters DIRCAL, DIRDC, DIRBLM,
 and DIROFF (see below).


DIRCAL

	DIRCAL=WMS_GLL:[SSI.RAD]	(VMS)
     or DIRCAL=/project/gll/ssi/rad/	(Unix)
 DIRCAL specifies the directory location of the radiometric (slope) file.
 When specified, DIRCAL overrides the default directory (see DIR parameter) for
 the radiometric file only.


DIRDC

	DIRDC=WMS_GLL:[SSI.RAD]	(VMS)
     or DIRDC=/project/gll/ssi/rad/	(Unix)
 DIRDC specifies the directory location of the dark-current file.
 When specified, DIRDC overrides the default directory (see DIR parameter) for
 the dark-current file only.


DIRBLM

	DIRBLM=WMS_GLL:[SSI.RAD]	(VMS)
     or DIRBLM=/project/gll/ssi/rad/	(Unix)
 DIRBLM specifies the directory location of the blemish file.
 When specified, DIRBLM overrides the default directory (see DIR parameter) for
 the blemish file only.


DIROFF

	DIROFF=WMS_GLL:[SSI.RAD]	(VMS)
     or DIROFF=/project/gll/ssi/rad/	(Unix)
 DIROFF specifies the directory location of the shutter-offset file.
 When specified, DIROFF overrides the default directory (see DIR parameter) for
 the shutter-offset file only.


CAL

 STRING
 Input Radiometric File, as generated by program GALGEN.  The Radiometric
 File's filter position must match the filter position of the input image.
 The filename should NOT include the directory of the file; refer to the 
 DIR and DIRCAL parameters for specifying the directory.


DC

 STRING
 Input dark current file, in byte or halfword format.  Dark current files
 may be (1) zero exposure frames, (2) a sum of zero exposure frames (see
 PICSUM), or (3) as computed by program GALGEN.

 The dark current file must match the input image in gain state and frame rate.
 Also, extended-exposure mode frames require extended-exposure dark currents.
 The filename should NOT include the directory of the file; refer to the DIR
 and DIRDC parameters for specifying the directory.


BLEM

 STRING
 Input Blemish File, as generated by program BLEMGEN.  The filename should NOT
 include the directory of the file; refer to the DIR and DIRBLM parameters for 
 specifying the directory.


OFFSETS

 STRING
 Input Shutter-Offset File, as generated by program CCDRECIP.  The
 Shutter-Offset File is independent of all camera modes, and a single file
 may be used (for a fixed temperature).  The filename should NOT include the
 directory of the file; refer to the DIR and DIROFF parameters for specifying
 the directory.


IOF

	IOF=r
where r specifies the output DN scale in number of 'I over F' units per DN.
10,000 'I over F' units would be produced by normal incidence of sunlight
on a Lambert disk at Jupiter's distance from the sun (5.2 A.U.).
The default is IOF=1.0.


CONV

	CONV=r
where r specifies the output DN scale in number of nanowatts per cm**2 per
steradian per nanometer wavelength per DN.
If not specified, the output is in units of IOF.


BITWT

Keyword 'UBWC specifies uneven-bit-weight correction (default is 'NOUBWC).


ENTROPY

Keyword 'NOCALC suppresses calculation of image entropy (default is 'CALC).


SOLRANGE

	SOLRANGE=r
where r specifies the solar range (distance for target to sun) in km.

If not specified the following actions are taken:
  (1) If the input image is in Phase1 format, the following constants are
      used: Venus=0.723331 AU, Earth=1.0 AU, Gaspra=2.2016 AU, Ida=2.9485 AU,
      Jupiter=5.2 AU.
  (2) For Phase 2, SOLRANGE is extracted from the VICAR label.
  (3) For ground calibration images, SOLRANGE=5.2 AU.


NOCHECK

Keyword 'NOCHECK specifies that processing should continue even though the
specified calibration files do not match the input files parameters: gain,
frame-rate, filter & FIBE (where applicable).  Warning messages identifying
the suspected files are displayed along with a continuation with error
message.  The default is to terminate processing if mismatches are detected.


PENTROPY

Keyword 'PRINT causes printing of the results of the entropy calculations for
the entire image and for every 50th line (default is 'NOPRINT).  Note that
this keyword can be used to force the entropy to be calculated, even if it
has been previously calculated by BADLABELS.


FILTER

INTEGER--OPTIONAL (ground calibration data only)
Filter position (0-7)
	FILTER=0  for Clear
	      =1  for Green
	      =2  for Red
	      =3  for Violet
	      =4  for 7560
	      =5  for 9680
	      =6  for 7270
	      =7  for 8890


GAIN

INTEGER--OPTIONAL (ground calibration data only)
Specifies camera gain state for input image.
	GAIN=1  for 400K (lowest gain state)
	    =2  for 100K
	    =3  for 40K
	    =4  for 10K  (highest gain state)
The default gain-state is 4 for 800x800 images, and 1 for 400x400
(summation-mode) images.


EXPOSURE

INTEGER--OPTIONAL (ground calibration data only)
Specifies the exposure time of the input image (msec).


CFILTER

INTEGER--OPTIONAL (ground calibration data only)
Filter position for
calibration file (0-7)


CGAIN

INTEGER--OPTIONAL (ground calibration data only)
Specifies camera gain state for calibration file.
       CGAIN=1  for 400K (lowest gain state)
	    =2  for 100K
	    =3  for 40K
	    =4  for 10K  (highest gain state)
The default gain-state is 2 for 800x800 images, and 1 for 400x400
(summation-mode) images.


DCGAIN

INTEGER--OPTIONAL (ground calibration data only)
Specifies gain state for the Dark-Current File.
      DCGAIN=1  for 400K (lowest gain state)
	    =2  for 100K
	    =3  for 40K
	    =4  for 10K  (highest gain state)
The default gain-state is 2 for 800x800 images, and 1 for 400x400
(summation-mode) images.


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.


DEBUG

'DEBUG causes diagnostic messages to be printed (for debugging the program).