Help for RVISIS2

VICAR program VISIS2 converts Galileo NIMS cubes (generated by program
NIMSCMM2) between VICAR and ISIS format.  Its calling sequence is
somewhat complex, reflecting the fact that a single ISIS cube becomes
multiple VICAR files, one for each object in the ISIS cube.  Therefore,
this procedure is provided in order to cover most cases with a simple
command line.

NOTE:  during Galileo Systematic Processing on MIPS, the functionality 
of RVISIS2 was implemented in procedure SYSNIMS2, which also included
the option of generating a NIMS Mask product.  The latter option is
not supported by RVISIS2, although the capability of processing an ISIS
cube containing the spectral plots of a Mask was retained.  Note that
SYSNIMS2 ran in forward mode only, and ran only under VMS.  Cubes made
by MIPS Systematic processing had names ending in the string "MSYnn".
Calling sequence:

> RVISIS2 name [optional parameters]

where "name" is the cube filename, without directory (which may be 
specified by a separate parameter) or suffix.  Note that the cube 
suffix (filetype) cannot be specified freely, so the user is restricted 
to the following combinations for the two primary VICAR files, the
cube and the co-cube:

   VICAR  <->  ISIS        description
  CUB,COC     QUB	default case: radiance (projected) G-cube
  CIOF,COC    IOF	IOF G-cube
  TUB,COT     VTUB	radiance unprojected tube
  XTUB,XCOT   VXTUB	tube with co-added mirror positions (point source)
  TIOF,COT    VIOF	IOF tube

E.g., the ISIS cube 33JNGLOBAL01A_MSY01.QUB corresponds to the VICAR
cube and co-cube files 33JNGLOBAL01A_MSY01.CUB and 33JNGLOBAL01A_MSY01.COC.

Anything else must be done by running VISIS2 by hand.

The ISIS cube also always contains a 2-D Histogram object, which is
stored in a third VICAR file, which this proc always names 2DHIST.

In inverse mode, the History object will be stored in a VICAR file 
with the filetype LAB.  In forward mode, if task=VISIS2, then the
presence of this file is required.

In inverse mode, the following additional files may be created if
the corresponding objects are present in the ISIS cube (in which
case, this *must* be indicated by the parameters SII and/or PLOTS):

SII = spectral-index image (if this is present, then PLOTS may only
 be 0 or 6, to keep the procedure from being excessively complicated);

SP1 ... SP6 = one to six spectrum plot files

The maximum number of objects in the ISIS cube is 11:  cube, co-cube,
2D-histogram, spectral-index image, six spectrum plots, and history.
(The cube also has a label object, but this does not have a separate
VICAR file, but is instead converted to the VICAR cube label.)
History:

xx-xxx-1996 -lwk- original version (VMS only)
01-sep-2002 -lwk- revised for unix port


PARAMETERS:


NAME

Cube filename, without directory or filetype.

TYPE

Specifies file type(s)

MODE

Forward: vicar -> isis or Inverse: isis -> vicar (Renamed FROMVIC and TOVIC for clarity.)

PLOTS

# of spectral plots in ISIS cube (Inverse mode only)

BREAK_UM

Break wavelength between Radiance and IOF (Forward mode only)

TO_ORI

Fix for missing TO_ORIGIN label item

SII

Flags presence of Spectral Index Image(s) in ISIS cube (Inverse mode only)

DIR

Directory (including any separator)

TASK

VICAR program that generated the cube. (Forward mode only)

See Examples:


Cognizant Programmer: