isis2pics Documentation

isis2pics - Copy spatial-spatial QUBE plane to PICS image
ISIS2PICS copies and optionally converts a spatial-spatial QUBE
plane to a PICS image.  This program works on any valid QUBE file
with any number of dimensions up to 6, the ISIS maximum.

Programmer:  Kris Becker  USGS, Flagstaff, Arizona

Input cube file name

NONE

Output PICS file name

NONE

Qube region of plane
1 - core
2 - suffix (backplane - only
    applies to 3 dimensional
    CUBE)

1

Specifies name of SUFFIX
(backplane in 3-D CUBE)
May be specified instead
of plane number in AXSTRT
for 3rd dimension

--

Specifies starting (and ending
for AXIS > 2) indexes for each
AXIS

1,1,1,1,1,1

Specifies output bit type for
PICS image

0

Specifes pixel scaling

N

Minimum and Maximum output
scaling range

0.0,255.0

Number of lines

0

Number of samples

0

Not supported yet

1

Not supported yet

1

ADDITIONAL NOTES:

Parm	Description
FROM	Enter the disk file name of the input QUBE. The file name convention is standard VAX/VMS syntax.
TO	Specify the disk file name of the PICS output file. The file name convention is standard VAX/VMS syntax.
CORESUF	Specifies where the spatial-spatial plane is in the QUBE file. CORESUF = 1 for all QUBES that do not have 3 dimensions. CORESUF = 2 when the desired plane resides in the backplane of a 3 - dimensional CUBE file.
SUF_NAME	This is an optional suffix specification applicable for 3-dimensional CUBEs only. Its intended to be used when the user does not know the index of the plane but knows the name of the SUFFIX. For this case, the value in AXSTRT(3) should be 0. For any other case this parameter is ignored.
AXSTRT	This array specifies the starting index in each dimension along each axis. AXSTRT(1) cooresponds to the SAMPLE AXIS, AXSTRT(2) cooresponds to the LINE dimension, AXSTRT(3) cooresponds to the BAND dimension, and so on into the other dimensions. One exception is in the 3-dimensional CUBE, AXSTRT(3) will specify the index into the backplane if CORESUF = 2. If the suffix is specified by name (i.e., SUF_NAME is assigned a value), then AXSTRT(3) should be set to 0 (default). For QUBES that contain more than 3 dimensions, AXSTRT(4-6) will specify the starting and ending index in each dimension.
SFLAG	Specifies optional pixel conversion or scaling for the output PICS pixel type. Note that in some cases, this must be done implicitly. For instance, if the OBIT is different than the pixel storage type for the QUBE plane, then pixel scaling must be performed.
OBIT	The output PICS pixel bit type. The user may optionally convert the QUBE plane to a specific bit type by explicitly assigning a value to OBIT. In this case, the MIN and MAX values found in ORANGE are assumed to specify the scaling range for the bit type. If the user wishes the output bit type to be the same as the input bit type, OBIT may be 0.
ORANGE	The MIN and MAX conversion/scaling range. This specifies the range used to compute the output scaling parameters applied to the QUBE data to result in the requested bit type when ANY type of scaliong is performed, either explicitly (SFLAG=Y) or when a bit type conversion needs to be performed.
NL	Number of lines. The default is 0 which will process all lines of the spectral image.
NS	Number of samples. The default is 0 which will process all samples of the spectral image.
LINC	Line increment. Positive integer value which specifies the increment in the line direction. LINC=2 will process every other line and effectively halve the size of the spectral image in the line direction.
SINC	Sample increment. Positive integer value which specifies the increment in the sample direction. SINC=2 will process every other sample and effectively halve the size of the spectral image in the sample direction.