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: