.TH OUTTABLE 1 "Version 1.0" "Environmental planning utilities" "EPU user manual"
.SH NAME
outtable \- computes table of statistics from several epp files.
.SH SYNOPSIS
.B outtable 
.RI [ options ]
.RI [ function "] file [ [" function "] file ...]"

.SH DESCRIPTION
.B outtable 
takes several 
.IR epp -files
counts all possible combinations of classes in them and produces
table of them. 
.PP
Some files  can be preceded by 
.I function
Such files wouldn't be used to define new combination. Instead, corresponding
column of table would contain value of function, computed from this file for
area, defined by combination of classes of all "function-less" files.
.PP
All files, used to define combination, should be specified before first
file with function.
.PP
If no function defined, table would be appended by column, containing area
of each combination.
.PP
If all files have function, table would contain only one row, containing
values of the functions for all area.
.PP
If files have different cell size and limits, limits and coordinate systems
of the first file are used, unless overriden by 
.B
--base
option.
.PP
By default, semantic value of classes are considered equial to values of
classes. This can be overridden by specifying parameters of linear mapping
function using 

.BR -z " and " -Z " options."
This option can be specified only once per invocation, becouse usially
.B outtable
is used to calculate statistics for one file in combinations, given by
several other files.
.PP
By default, all area-related values are calculated in alternative coordinate
units. It can be overriden using 
.B -c
option.
.SH OPTIONS
.TP 8
.B --help
displays brief usage information.
.TP 8
.B --version
displays version number
.TP 8
.B --verbose -%
Displays percentage of processed lines in file.
.TP 8
.B -u --union 
Take into account all cells, where at least one of output files is not offsite.
By default, only cells where all input files are onsite are taken into account.
.TP 8
.B -c --cells
Output areas in cells. By default map units as specified in file header
are used to compute areas.
.TP 8
.BI -d "char " --delimiter= char 
sets table column separator to 
.I char. Defaults to comma.
.TP 8
.BI -b " file" --base " file"
Specifies epp file, used as reference grid. Cell area and cell size of this
file, as well as its coordinate limits would be used for processing. 
Defaults to first file in the command line.
.TP 8
.BI -z " value"
Specifies multiplier for calculating semantic value from class value.
.TP 8
.BI -Z " value"
Specifies offset of semantic values, i.e. semantic value of class 0.
.SH FUNCTIONS
.TP 8
.B -sum
Sum of classes in given file for combination, multiplied by cell area.
.TP 8
.B -cnt
Count of onsite cells of given file.
.TP 8
.B -avg
Average cell value
.TP 8
.B -min
Minimum cell value
.TP 8
.B -nmin
Area of cells with minimum value

.TP 8
.B -max
Maximum cell value
.TP 8
.B -nmax
Area of cells with maximum value
.TP 8
.B -mode
Modal value (value of most cells)
.TP 8
.B -nmode
Area of cells with modal value
.TP 8
.B -fewest
Class with fewest cells
.TP 8
.B -nfewest
Area of cells in fewest class
.TP 8
.B -range
Range of classes (maximum-minimum)
.TP 8
.B -classes
Number of different classes
.TP 8
.B -or
Bitwise or of all cells (values of 
.BR -z " and " -Z
options are not used)
.TP 8
.B -and
Bitwise and of all cells (values of 
.BR -z " and " -Z
options are not used)
.TP 8
.B -std
Standard deviation of classes
.TP 8
.B -var
Variance of classes
.TP 8
.B -corr
Correlation coefficient between two files. Requires two arguments.
.SH SEE ALSO
.BR intable (1), reclass (1), evaluate (1), resample (1), eheader (1)

.SH AUTHOR

Victor B. Wagner <vitus@agropc.msk.su>

.SH BUGS

???