Help for SYSNIMS

PURPOSE
This procedure will perform systematic processing of NIMS data.  Systematic
processing includes creating the following items:

  a merged mosaic cube               (NIMSCMM)
  spectral index images, 10 maximum  (NIMSFLOAT and F2)
  spectral plots, 6 maximum          (SPECPLOT)
  a 2-dimensional histogram          (HIST2D)
  an ISIS cube                       (VISIS2)
  a mask to produce a color hardcopy (NIMSMASK) (optional)


The PDS labelled ISIS cube is the main product created by this procedure.  The
ISIS cube consists of the merged mosaic cube, the geometry co-cube, the
spectral index image cube, the spectral plots (0 to 6), and a 2-D histogram.

The output file names are constructed from the parameters OBSNAME and MOS_NUM
as follows:
   filename = "xxDISK::"//"xxDIR:"//OBSNAME//"_"//INITIALS//seq_no//".ttt"
where "seq_no" is a running 2-digit number (01 to 35) generated from MOS_NUM,
"xx" = "MM" for the VICAR products, and "ISIS" for the ISIS cube, and "ttt" is 
the filetype:
  "ttt" = "CUB" for the VICAR cube (".TUB" if Tube is requested),
  "ttt" = "COC" for the VICAR co-cube (".COT" if Tube),
  "ttt" = "QUB" for the ISIS cube ("VTUB" if Tube), etc.
E.g.:  specifying the following parameters:
  ISISDISK = SCX1:
  ISISDIR = [MIPL]
  OBSNAME = E1WNGMOS05A
  MOS_NUM = 3
will generate the ISIS cube name:  SCX1:[MIPL]E1WNGMOS05A_MSY03.QUB.

If the "xxDISK", "xxDIR" parameteres are not given, the products are placed in 
the directory from which the proc is being run.  

*** NOTE:  Archiving is not part of this procedure.

A color mask is an optional product.

There will be various files (most of them temporary) created by this procedure
and placed in the directory from which this is running.


The following parameters are used to create the merged mosaic cube.

  EDR, PROCESS, OUTTYPE, CALFILE, SOLFILE, DARKFILE, DBMFILE, DSPKFILE,
  TARGET, DELRAD, PHASE, OBSNAME, MOS_NUM, INITIALS, OBSNOTE, PRODNOTE,
  CALTYPE, RADSCAL, DARKTYPE, PHOTFUNC, MINN_EXP, PROJ, TIELAT,TIELON,
  TIELINE, TIESAMP, NORTH, PARALLEL, REFSCLK, REFMP, RADFACT, SCALE,
  OUTSIZ, PRANGE, OLATLON, FILL, FILPAR, BIN, OVERLAP, THRESH, FPNGRID,
  SLEW_TOL, CSOURCE, KERNELS, IKERNEL, DPOINT, SCLK, GOFFSET, INSMODE,
  NLGP, STOPSLID, INS_TEMP, SDGEO, and SDBAND.

  The parameters which can not be defaulted are:

    EDR, CALFILE, TARGET, OBSNAME, OBSNOTE, PROJ, and SCLK, and (unless
    PROJection is POV/PERSPECT) either SCALE or OUTSIZ.

  These parameters must be given even if 'NOMM is given.  'NOMM means that 
  CATNIMS2 and NIMSCMM will not be run and the file names generated using
  OBSNAME and MOS_NUM will be used as the merged mosaic cube and the geometry
  co-cube, which will be used to produce the spectral index image cube,
  spectral plots, 2-D histogram, ISIS cube, and the mask.  'NOMM is used in
  the case where this procedure needs to be restarted after NIMSCMM.

  EDR is not part of the NIMS request form.  The user will have to find the
  edr file names and put them on disk prior to running this procedure


The following parameters are used to create the spectral index images:

  SII_IMGS, FUNC1, BAND1, FUNC2, BAND2, FUNC3, BAND3, FUNC4, BAND4, FUNC5,
  BAND5, FUNC6, BAND6, FUNC7, BAND7, FUNC8, BAND8, FUNC9, BAND9, FUNC10,
  BAND10, EXCLD, and REPLACE

  Whether or not spectral index images are to be created, SII_IMGS must always
  be given, along with the necessary FUNC's and BAND's.

  The Vicar programs NIMSFLOAT and F2 are used to create the spectral index
  images, and INSERT3D is used to create the spectral index image cube.


The following parameters are used to create the spectral plots:

  PLOTS, BREAK_UM, AREA1, AREA2, AREA3, AREA4, AREA5, AREA6, EXCLUDE, PSAT,
  and CALTYPE

  Whether or not spectral plots are to be created, PLOTS must always be given,
  along with the necessary AREA's.

  EXCLUDE is not part of the NIMS request form and will probably never need to
  be given.


The following parameters are used to create the 2-D histogram:

  EXCLUDE and CALTYPE

  EXCLUDE is not part of the NIMS request form and will probably never need to
  be given.  


The following parameters are used to create the ISIS cube:

  REQUESTR, ISISDISK, and ISISDIR

  
The following parameters are used to create the color mask:

  MASK, RED_SIID, GRN_SIID, BLU_SIID, ASTRETCH, RSTRETCH, GSTRETCH,
  BSTRETCH, RFORMULA, GFORMULA, BFORMULA, TCA, PSH, BOXCOLOR, MASKDISK, 
  and MASKDIR (for a Tube, also:  PIX_DN, BODY_DN, OTHR_DN, BODCEN,
  MIRR_FP, LIMBINC, BOREINC, and PST)

  If a color mask is to be produced, the following parameters cannot be
  defaulted:

    RED_SIID, GRN_SIID, BLU_SIID, RFORMULA, GFORMULA, and BFORMULA

  and MASK must be set to MASK (NOMASK is the default)

  Also, either ASTRETCH or RSTRETCH, GSTRETCH, and BSTRETCH and TCA really
  should be given.  PSH and BOXCOLOR are not part of the NIMS request form and
  will probably never need to be given.

PROGRAM HISTORY:

Written by: Jan Yoshimizu, 17 October 1990
Cognizant programmer: Lucas Kamp
Revisions: 
22 Oct 1990  JRY  VISIS no longer has parameter USERNOTE
29 Oct 1990  JRY  Changed MINN_EXP to REAL and the valid range for SII_IMGS,
                   added AMALTHEA to target list
30 Jan 1991  JRY  Added parameters NORTH, OVERLAP, SLEW_TOL, KERNELS, and
                   DEBOOM.  Added POLORTH to PROJ.
 3 Apr 1991  JRY  Added parameter DPOINT.  Changed NOMM to PROCESS and added 
                   ALL.
15 Jul 1991  JRY  Added more targets to TARGET.  Deleted IOF from CALTYPE.
                   Added REPLACE to OVERLAP.  Gave KERNELS a default file.
                   Added NLGP nad SDGEO.  Changed the order of VISIS inputs.
                   Changed F2 to output REAL.
13 Dec 1991  JRY  Removed parameter DEBOOM.  Change GEOCUBE to COCUBE.  Added
                   parameters OUTTYPE, SOLFILE, DBMFILE, RADSCAL, REFMP, 
                   THRESH, and IKERNEL.  Modified valid list for PARALLEL.
                   Modified help file.
29 May 1992  LWK  Added code to change input Longitudes to East for Venus;
		   added program ASTRTCHR for case of SII plane in Mask
12 Jun 1992  JFM  ZOOMED parameter of NIMSMASK removed.  NIMSMASK no longer
		   has this parameter, but reads the magnification factor from
		   the image's VICAR label. (FR 76822)
19 Jun 1992  JFM  OVERLAY grid line spacing for summary image of NIMSMASK
		   revised to select nearest ten degrees increment. (FR 76811)
30 Jun 1992  LWK  Added PRANGE param & PERSPECT keyword per NIMSCMM changes
24 Nov 1992  LWK  Changed values of param.PHASE per Mehlman request
11 May 1993  LWK  Removed PRANGE & other PERSPECT parameters that are not to
                   be part of standard systematic processing
 8 Sep 1993  LWK  Restructured for the new filename syntax requested by RM;
		   removed MMCUBE, COCUBE parameters (these must always be 
	           built from OBSNAME/MOS_NUM); added parameter FPNGRID
18 Oct 1993  LWK  Added default DBMFILE
11 Nov 1993  LWK  Fixed COMMENT field in BARNE call
10 Dec 1993  LWK  Changed ZOOM for summary image to be non-integer;  replaced
		   TRAN with NIMSFLOAT for cube bands in summary image and 
		   perform stretch using C/ASTRTCHR rather than in NIMSMASK 
		   (because NIMSMASK cannot handle the halfword radiance 
	           scaling factors); disabled RADSCAL=0, changed default to 
		   RADSCAL=2.
18 Jan 1994  JFM  Removed summary image plane stretches from SYSNIMS and moved
                   stretches back into NIMSMASK, obsoleting changes made by LWK
   		   in the December 10th version of SYSNIMS. SYSNIMS uses 
	 	   ASTRTCHR to move floating point radiance data to halfword 
		   data range of (0,32767) and perform stretches within 
		   NIMSMASK. See failure report (FR) 82901 initiated by 
		   Jan Yoshimizu. (Note: Changes pertain to stream when CALTYPE
		   is RAD.)
 7 Feb 1994  LWK  changed MMDIR parameter to not require user input of brackets
		  ("[" and "]"), conforming to other "DIR" parameter usage
10 Feb 1994  LWK  fixed computation of longitude intervals for OVERLAY to be
		   divisible into 360;  added TASKNAME parameter for NIMSMASK;
		   ensure that CATNIMS is always called (even if 'NOMM)
 3 Mar 1994  LWK  added Help for PSAT param, changed default to NOSATURATE
20 Mar 1994  LWK  changed PSAT default back to SATURATE
12 May 1994  LWK  revised THRESH param & help for THRESH & SCALE
 9 Aug 1994  LWK  added option for 'LINESAMP mode for SPECPLOT, using AREA1(1)
		   as a flag
19 May 1995  LWK  set directory to MMDISK/DIR for scratch files
20 Jun 1995  LWK  added NOHKP/GSTART/DELAY parms for Venus/Asteroid data;
		get subsolar lat/lon from label for terminator in OVERLAY
10 JuL 1995  LWK  added NOTERM for Venus (VPDIN)
   Aug 1995  LWK  fixed to allow SIZE to zoom down as well as up;  removed
		code to change E.Long. to W for Venus, as this is done in 
		SPECPLOT;  added DOISIS parameter.
10SEP95 -lwk- revised to run on Alpha (added Sybase parameters, changed VISIS
	to VISIS2);  remove ISIS "bad values" using F2 before SIZE step to
	avoid contamination of interpolation algorithm
20nov95 -lwk- added PDISP to allow specification of POV projection;  also
	DLON/DLAT for OVERLAY (needed for VJBARS masks)

PARAMETERS: