Help for LAVE
PURPOSE:
LAVE calculates the average DN values or the standard deviation values for each
line (HORIZONTAL mode) or each column (VERTICAL mode) of samples within a
picture. The output is either a single line of the average (or standard
deviation) DN values (default) or an image the same size as the input picture,
but with each pixel replaced by its average (or standard deviation) value
(IMAGE mode). LAVE determines the data format from the VICAR label of the
image. LAVE works on byte, halfword, fullword, and real*4 data.
EXECUTION:
LAVE A OUT=C FILTER=7 Find the averages of rows (default), perform
a box filter with window size 7, and send the
output to image file C.
LAVE A MODE=VERT Find column averages. Print the results only.
LAVE A OUT=C MODE=IMAGE Find averages of rows, and write image same
size as original image (with each pixel
replaced by its average value) out to C.
LAVE A EXCLUDE=1 Ignore all samples with value of 1.
LAVE A FILTER=3 'HIGH Do filter with window size 3, and highpass
output.
LAVE A OUT=C SIZE=(50,20,100,200) 'IMAGE 'VERT
has the same effect as LAVE A B SIZE=(50,20,100,200) MODE=VERT
SIZE B C SIZE=(1,1,100,200)
LAVE A C FILTER=7
has the same effect as LAVE A B
BOXFLT2 B C NLW=1 NSW=7
OPERATION:
The input picture is read and the average DN values are computed, excluding
any pixels of the DN specified by the EXCLUDE keyword. If there remain no
pixels to be averaged, the output pixel is assigned 0 DN. All the average
values are then printed. If a filter has been requested, the average values
are filtered and those values are also printed. Unless the keyword IMAGE
was specified, a single line of average values is output. Note that in the
HORIZONTAL mode, the number of samples output is the number of LINES input.
If the keyword IMAGE was used, a full-size image is produced by either
repeating the line of average values, once for each line (VERTICAL mode), or
repeating each average value once for each sample, with each average value
on its original line (HORIZONTAL mode).
If STDEV is specified, standard deviation values are used instead of averages.
WRITTEN BY: R.M. Ruiz, 25 February 1971
COGNIZANT PROGRAMMER: Ron Alley
REVISION: 8 February 2001
PARAMETERS:
INP
Input image file
OUT
Output image file, if any.
SIZE
Standard VICAR size field
SL
Starting line
SS
Starting sample
NS
Number of lines
NL
Number of samples
MODE
VERTICAL or HORIZONT
HIGHPASS
Perform highpass filter?
PLOT
print a plot of results?
PRINT
print the averages?
IMAGE
Repeat output line or
column to make output file the
size of input file.
STDEV
Specifies standard deviation
will be computed as the output
instead of averages.
EXCLUDE
Value to exclude
FILTER
Filter width
AIS
Print output values
in block(s) of 32 by 32 values.
TITLE
Title for AIS print-out
See Examples:
Cognizant Programmer: