geography/fGIS/man/outtable.1.html

   1 <!-- manual page source format generated by PolyglotMan v3.0.4, -->
   2 <!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
   3
   4 <HTML>
   5 <HEAD>
   6 <TITLE>OUTTABLE(1) manual page</TITLE>
   7 </HEAD>
   8 <BODY>
   9 <A HREF="#toc">Table of Contents</A><P>
  10
  11 <H2><A NAME="sect0" HREF="#toc0">NAME </A></H2>
  12 outtable - computes table of statistics from several epp files.
  13 <H2><A NAME="sect1" HREF="#toc1">SYNOPSIS
  14 </A></H2>
  15 <B>outtable </B> [<I>options</I>]<I></I> [<I>function</I>] file [ [<I>function</I>] file ...]<I></I> <P>
  16
  17 <H2><A NAME="sect2" HREF="#toc2">DESCRIPTION
  18 </A></H2>
  19 <B>outtable </B> takes several  <I>epp</I>-files counts all possible combinations of
  20 classes in them and produces table of them.  <P>
  21 Some files  can be preceded
  22 by  <I>function</I> Such files wouldn't be used to define new combination. Instead,
  23 corresponding column of table would contain value of function, computed
  24 from this file for area, defined by combination of classes of all "function-less"
  25 files. <P>
  26 All files, used to define combination, should be specified before
  27 first file with function. <P>
  28 If no function defined, table would be appended
  29 by column, containing area of each combination. <P>
  30 If all files have function,
  31 table would contain only one row, containing values of the functions for
  32 all area. <P>
  33 If files have different cell size and limits, limits and coordinate
  34 systems of the first file are used, unless overriden by  <B></B> --base option.
  35 <P>
  36 By default, semantic value of classes are considered equial to values
  37 of classes. This can be overridden by specifying parameters of linear mapping
  38 function using  <P>
  39  <B>-z</B> and <B>-Z</B> options. This option can be specified only once
  40 per invocation, becouse usially <B>outtable</B> is used to calculate statistics
  41 for one file in combinations, given by several other files. <P>
  42 By default,
  43 all area-related values are calculated in alternative coordinate units.
  44 It can be overriden using  <B>-c</B> option.
  45 <H2><A NAME="sect3" HREF="#toc3">OPTIONS </A></H2>
  46
  47 <DL>
  48
  49 <DT><B>--help</B>  </DT>
  50 <DD>displays brief usage
  51 information. </DD>
  52
  53 <DT><B>--version</B>  </DT>
  54 <DD>displays version number </DD>
  55
  56 <DT><B>--verbose -%</B>  </DT>
  57 <DD>Displays percentage
  58 of processed lines in file. </DD>
  59
  60 <DT><B>-u --union </B>  </DT>
  61 <DD>Take into account all cells, where
  62 at least one of output files is not offsite. By default, only cells where
  63 all input files are onsite are taken into account. </DD>
  64
  65 <DT><B>-c --cells</B>  </DT>
  66 <DD>Output areas
  67 in cells. By default map units as specified in file header are used to
  68 compute areas. </DD>
  69
  70 <DT><B>-d</B><I>char </I><B>--delimiter=</B><I>char</I><B></B>  </DT>
  71 <DD>sets table column separator to  <I>char.</I>
  72 Defaults to comma. </DD>
  73
  74 <DT><B>-b</B><I> file</I><B>--base</B><I> file</I>  </DT>
  75 <DD>Specifies epp file, used as reference
  76 grid. Cell area and cell size of this file, as well as its coordinate limits
  77 would be used for processing.  Defaults to first file in the command line.
  78 </DD>
  79
  80 <DT><B>-z</B><I> value</I>  </DT>
  81 <DD>Specifies multiplier for calculating semantic value from class
  82 value. </DD>
  83
  84 <DT><B>-Z</B><I> value</I>  </DT>
  85 <DD>Specifies offset of semantic values, i.e. semantic value
  86 of class 0. </DD>
  87 </DL>
  88
  89 <H2><A NAME="sect4" HREF="#toc4">FUNCTIONS </A></H2>
  90
  91 <DL>
  92
  93 <DT><B>-sum</B>  </DT>
  94 <DD>Sum of classes in given file for combination,
  95 multiplied by cell area. </DD>
  96
  97 <DT><B>-cnt</B>  </DT>
  98 <DD>Count of onsite cells of given file. </DD>
  99
 100 <DT><B>-avg</B>
 101 </DT>
 102 <DD>Average cell value </DD>
 103
 104 <DT><B>-min</B>  </DT>
 105 <DD>Minimum cell value </DD>
 106
 107 <DT><B>-nmin</B>  </DT>
 108 <DD>Area of cells with minimum
 109 value </DD>
 110 </DL>
 111 <P>
 112
 113 <DL>
 114
 115 <DT><B>-max</B>  </DT>
 116 <DD>Maximum cell value </DD>
 117
 118 <DT><B>-nmax</B>  </DT>
 119 <DD>Area of cells with maximum value
 120 </DD>
 121
 122 <DT><B>-mode</B>  </DT>
 123 <DD>Modal value (value of most cells) </DD>
 124
 125 <DT><B>-nmode</B>  </DT>
 126 <DD>Area of cells with modal
 127 value </DD>
 128
 129 <DT><B>-fewest</B>  </DT>
 130 <DD>Class with fewest cells </DD>
 131
 132 <DT><B>-nfewest</B>  </DT>
 133 <DD>Area of cells in fewest
 134 class </DD>
 135
 136 <DT><B>-range</B>  </DT>
 137 <DD>Range of classes (maximum-minimum) </DD>
 138
 139 <DT><B>-classes</B>  </DT>
 140 <DD>Number of different
 141 classes </DD>
 142
 143 <DT><B>-or</B>  </DT>
 144 <DD>Bitwise or of all cells (values of  <B>-z</B> and <B>-Z</B> options are not
 145 used) </DD>
 146
 147 <DT><B>-and</B>  </DT>
 148 <DD>Bitwise and of all cells (values of  <B>-z</B> and <B>-Z</B> options are not
 149 used) </DD>
 150
 151 <DT><B>-std</B>  </DT>
 152 <DD>Standard deviation of classes </DD>
 153
 154 <DT><B>-var</B>  </DT>
 155 <DD>Variance of classes </DD>
 156
 157 <DT><B>-corr</B>
 158  </DT>
 159 <DD>Correlation coefficient between two files. Requires two arguments. </DD>
 160 </DL>
 161
 162 <H2><A NAME="sect5" HREF="#toc5">SEE
 163 ALSO </A></H2>
 164 <B><A HREF="intable.1.html">intable</B>(1)</A>
 165 ,<B><A HREF="reclass.1.html">reclass</B>(1)</A>
 166 ,<B><A HREF="evaluate.1.html">evaluate</B>(1)</A>
 167 ,<B><A HREF="resample.1.html">resample</B>(1)</A>
 168 ,<B><A HREF="eheader.1.html">eheader</B>(1)</A>
 169  <P>
 170
 171 <H2><A NAME="sect6" HREF="#toc6">AUTHOR
 172 </A></H2>
 173 <P>
 174  Victor B. Wagner &lt;vitus@agropc.msk.su&gt; <P>
 175
 176 <H2><A NAME="sect7" HREF="#toc7">BUGS </A></H2>
 177 <P>
 178  ??? <P>
 179
 180 <HR><P>
 181 <A NAME="toc"><B>Table of Contents</B></A><P>
 182 <UL>
 183 <LI><A NAME="toc0" HREF="#sect0">NAME</A></LI>
 184 <LI><A NAME="toc1" HREF="#sect1">SYNOPSIS</A></LI>
 185 <LI><A NAME="toc2" HREF="#sect2">DESCRIPTION</A></LI>
 186 <LI><A NAME="toc3" HREF="#sect3">OPTIONS</A></LI>
 187 <LI><A NAME="toc4" HREF="#sect4">FUNCTIONS</A></LI>
 188 <LI><A NAME="toc5" HREF="#sect5">SEE ALSO</A></LI>
 189 <LI><A NAME="toc6" HREF="#sect6">AUTHOR</A></LI>
 190 <LI><A NAME="toc7" HREF="#sect7">BUGS</A></LI>
 191 </UL>
 192 </BODY></HTML>