pics2isis Documentation

pics2isis - Insert PICS image into a Build 2 ISIS cube
PICS2ISIS inserts a two-dimensional PICS image into a plane of
an ISIS image cube.  This can optionally include creation of
a new cube file to receive the PICS image.  The PICS image can
be inserted into either a selected core plane or a selected
backplane of the output cube file.

The input PICS image can be stored in either 8-bit, 16-bit or
32-bit format.  The number of bits per pixel will always be the
same in the output cube file as it is in the input file.  (If
the PICS image is being inserted into a backplane, then the
8-bit, 16-bit or 32-bit pixel values will always be stored in
32-bit suffix pixel storage elements according to the standard
format for suffix data in cube files.)

If the PICS image is in 8-bit format, then all the input values
are copied to the cube file without modification.  If the PICS
image is in 16-bit format, then any pixels that match the
value specified by the NULL parameter are considered to be Null
pixel values and are converted to the standard ISIS Null value.
If the PICS image is in 32-bit format, then any standard PICS Null
values (all 32 bits turned on) are converted to the standard ISIS
Null value.

The TAE NOTE parameter can be used to specify additional
information in the label of a newly created output cube.  Note
that the value will only be written to the label of the cube
when a new file is created - adding additional bands to an
existing cube will ignore the value of the NOTE parameter.
The value of the NOTE parameter will be written to a keyword
of the same name in the QUBE object in the object-owned keyword
section of the label.

Programmer:  Jim Torson, U.S.G.S., Flagstaff

Input PICS file name
  (default extension is .PIC)

NONE

Output cube file name
  (default extension is .CUB)

NONE

Whether to create new file

YES

Destination core or suffix
  1=core, 2=suffix

1

Where to insert the image

1

Number of bands for new cube

1

Number of backplanes for
new cube

0

Input 16-bit NULL value

0

Cube label informational
note (new output files
only)

" "

STARTING LINE

1

STARTING SAMPLE

1

NUMBER OF LINES

0

NUMBER OF SAMPLES

0

LINE INCREMENT

1.

SAMPLE INCREMENT

1.

ADDITIONAL NOTES:

Parm	Description
FROM	Specifies the name of the input PICS image file.
TO	Specifies the name of the output ISIS cube file in which the PICS image is to be inserted.
NEWFILE	NEWFILE specifies whether to create a new output file.
CORSUF	Specifies whether the destination plane number (given by the BAND parameter) is a core band number (CORSUF=1) or a backplane number (CORSUF=2). Note that backplane numbers start at 1, i.e., the backplane numbers are not an extension of the core band numbers.
BAND	Specifies the band number of the plane in the output cube file that is to be replaced. If CORSUF specifies suffix, then this is the backplane number. Note that backplane numbers start at 1, i.e., the backplane numbers are not an extension of the core band numbers.
NB	Number of bands for the new output cube file when a new file is being created.
NBACK	Number of backplanes for the new output cube file when a new file is being created.
NULL	NULL is used only for 16-bit input PICS image files. This parameter specifies the input file value that is considered to be NULL. Pixels with this value will be converted to the standards ISIS Null value.
NOTE	The user may specify additional information to this TAE parameter that will be written to the label of newly created output cube files. The string will be written to the QUBE object-owned keyword section in a keyword called "NOTE". The value is ignored when adding bands to existing cube files.
SL	Starting line. The default is 1 which will start the processing with the first line or top of the image.
SS	Starting sample. The default is 1 which will start the processing with the first sample or left side of the image.
NL	Number of lines. The default is 0 which will process all lines of the image.
NS	Number of samples. The default is 0 which will process all samples of the image.
LINC	Line increment. The default is 1.0 which will process each line of the image. LINC=2.0 will process every other line and the output image will have half as many lines as the input. LINC=.5 will process each line twice and the output image will have twice as many lines as the input.
SINC	Sample increment. The default is 1.0 which will process each sample of the image. SINC=2.0 will process every other sample and the output image will have half as many samples as the input. SINC=.5 will process each sample twice and the output image will have twice as many samples as the input.