average Documentation

AVERAGE - Obtain averages of an image sub-area
PROGRAMMER:EELIASON
AVERAGE determines a simple average of the requested subscene
specified by (SL,SS,NL,NS,LINC,SINC).
Program works on 8, 16, and 32-bit data.

INPUT FILE (32, 16, OR 8-BIT)

NONE

DATA FILE TO SAVE STATISTICS
(OPTIONAL)

8 CHARACTER ID CODE WHICH
IDENTIFIES THE AVERAGE VALUE.
(OPTIONAL)

NULL VALUE
(FOR 16-BIT DATA ONLY)

0

STARTING LINE

1

STARTING SAMPLE

1

NUMBER OF LINES

0

NUMBER OF SAMPLES

0

LINE INCREMENT

1.

SAMPLE INCREMENT

1.

ADDITIONAL NOTES:

Parm	Description
TO	Output file to contain result of average, a one line record is appended to this file. This parameter is optional. For fortran programmers, the following write statment is used to write results to this file: WRITE(ID,900) ID,AVG1,AVG2,SL,SS,NL,NS,LINC,SINC 900 FORMAT(A8,2E15.7,4I6,2f6.1) Where: ID = 8 character identification AVG1 = real, average without null values AVG2 = real, average with null values SL = integer, starting line SS = integer, starting sample NL = integer, number of lines NS = integer, number of samples LINC = real, line increment SINC = real, sample increment
ID	This parameter specifies an eight character Identification for the average. The character ID is blank if not specified by the user.
NULL	For 16 bit data - the DN value to be considered NULL. The default of 0 is used in most cases. Whatever is used for the NULL value will not be averaged.
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.