Help for SYSNIMS2

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

  a merged mosaic cube               (NIMSCMM2)
  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, OBSEXT, and 
MOS_NUM as follows:
 filename = "xxDISK::"//"xxDIR:"//OBSNAME//OBSEXT//"_"//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 = E1WNGMOS05
  OBSEXT = A
  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, OBSEXT, MOS_NUM, INITIALS, OBSNOTE, PRODNOTE,
  CALTYPE, RADSCAL, DARKTYPE, PHOTFUNC, PHOTCUT, 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, PCKERNEL, RCKERNEL, SPKERNEL, IKERNEL, DPOINT, DPT_SCLK,
  EPHERR, AACSFILE, SCLK, GOFFSET, INSMODE, NLGP, STOPSLID, MIRROMIT, INS_TEMP,
  INCCUT, EMICUT, 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 NIMSCMM2 will not be run and the file names generated using
  OBSNAME, OBSEXT, 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 NIMSCMM2.

  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

  Note that the mask will always have 6 plots, regardless of what was
  specified for PLOTS;  if fewer than 6 were requested, then the remainder
  will be empty.

  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:

SYSNIMS written by: Jan Yoshimizu, 17 October 1990
SYSNIMS2 adapted from SYSNIMS:  L.W.Kamp,  2 March 1995
Cognizant programmer: Lucas Kamp

Changes:
  19apr95 -lwk- remove ISIS "bad values" using F2 before SIZE step to
		avoid contamination of interpolation algorithm
   8aug96 -lwk- changes for phase 2 actual data
   3feb97 -lwk- changes for phase 2 Sys.processing

PARAMETERS: