USGS

Isis 2 Documentation


mask Documentation

MASK - Pixels outside range MIN and MAX are set to null
PROGRAMMER: EELIASON
This program will accept either one or two input files to create a
single output file.  MASK can handle 8-bit, 16-bit, or 32-bit image
files.

MASK moves values of the first input file to the output file if the
corresponding values in the second input file are within the range
specified by MIN and MAX, else the output file is set to null.
If there is only one input file then the limits of MIN and MAX are
tested in the first input file.

ALGORITHM -
For two input files:
        if MIN <= INPUT2(i,j) <= MAX then
           OUTPUT(i,j) = INPUT1(i,j)
        else
           OUTPUT(i,j) = null

For one input file:
        if MIN <= INPUT1(i,j) <= MAX then
           OUTPUT(i,j) = INPUT1(i,j)
        else
           OUTPUT(i,j) = null

ParmDescriptionDefault
FROM
INPUT IMAGE FILE NAMES
(ENTER 1 OR 2 FILES)
NONE
TO
OUTPUT IMAGE FILE NAME
NONE
MIN
MINIMUM VALUE FOR VALID DATA
1
MAX
MAXIMUM VALUE FOR VALID DATA
255
NULL
NULL VALUE, USED ONLY
WHEN BIT TYPE IS 16
0
SL
STARTING LINE
1
SS
STARTING SAMPLE
1
NL
NUMBER OF LINES
0
NS
NUMBER OF SAMPLES
0
LINC
LINE INCREMENT
1.
SINC
SAMPLE INCREMENT
1.

ADDITIONAL NOTES:

ParmDescription
FROM
Mask accepts one or two input files. If only one input file
is provided then the MIN and MAX parameters are compared
with the one file.  If two input files are specified then
the MIN and MAX parameters are compared with the second
input file.
MIN
Values in the tested file less than MIN are set to the
NULL value.
MAX
Values in the tested file greater than MAX are set to
the NULL value.
NULL
The Null parameter is applicable only to 16-bit data.
NULL specifies the value to assign an output pixel
when the corresponding input pixel is outside the
range of MIN and MAX.
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.
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.
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.

Last updated: Jan 31 2005
File: pdfs3.html

Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov

ISIS Documentation Home Page