GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


NAME

       v.vect.stats  - Count points in areas, calculate statistics.

KEYWORDS

       vector, database, attribute table

SYNOPSIS

       v.vect.stats
       v.vect.stats help
       v.vect.stats  [-p]  points=name  areas=name  [type=string[,string,...]]
       [player=integer]   [alayer=integer]   [method=string]    [pcolumn=name]
       [ccolumn=string]        [scolumn=string]       [fs=character|space|tab]
       [--verbose]  [--quiet]

   Flags:
       -p
           Print output to stdout, do not update attribute table
           First column is always area category

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       points=name
           Name of existing vector map with points

       areas=name
           Name of existing vector map with areas

       type=string[,string,...]
           Feature type
           Feature type
           Options: point,centroid
           Default: point

       player=integer
           Layer number for points map
           A single vector map can be connected to multiple  database  tables.
           This number determines which table to use.
           Default: 1

       alayer=integer
           Layer number for area map
           A  single  vector map can be connected to multiple database tables.
           This number determines which table to use.
           Default: 1

       method=string
           Method for aggregate statistics
           Options:
           sum,average,median,mode,minimum,min_cat,maximum,max_cat,range,stddev,variance,diversity

       pcolumn=name
           Column name of points map to use for statistics
           Column of points map must be numeric

       ccolumn=string
           Column name to upload points count
           Column to hold points count, must  be  of  type  integer,  will  be
           created if not existing

       scolumn=string
           Column name to upload statistics
           Column  to hold statistics, must be of type double, will be created
           if not existing

       fs=character|space|tab
           Field separator
           Output field separator
           Default: |

DESCRIPTION

       v.vect.stats counts the number of points in vector map  points  falling
       into  each  area  in  vector map areas.  Optionally statistics on point
       attributes in points are calculated for  each  area.  The  results  are
       either  uploaded  to  the  attribute  table  of the vector map areas or
       printed to stdout.

   OPTIONS
       Statistical Methods: Using  numeric  attribute  values  of  all  points
       falling  into  a  given area, a new value is detmined with the selected
       method.  v.vect.stats can perform the following operations:

       sum
              The sum of values.

       average
              The average value of all point attributes (sum / count).

       median
              The value found half-way through a list of the attribute values,
              when these are ranged in numerical order.

       mode
              The most frequently occurring value.

       minimum
              The minimum observed value.

       min_cat
              The point category corresponding to the minimum observed value.

       maximum
              The maximum observed value.

       max_cat
              The point category corresponding to the maximum observed value.

       range
              The range of the observed values.

       stddev
              The statistical standard deviation of the attribute values.

       variance
              The statistical variance of the attribute values.

       diversity
              The number of different attribute values.

NOTES

       Points  not  falling  into any area are ignored. Areas without category
       (no centroid attached or centroid without category) are ignored.  If no
       points  are  falling  into  a  given  area, the point count is set to 0
       (zero) and the statistics result to "null".

       The columns count_column and stats_column are created if not  existing.
       If  they do already exist, the count_column must be of type integer and
       the stats_column of type double.

SEE ALSO

        v.distance, r.distance, v.what.vect

AUTHOR

       Markus Metz

       Last changed: $Date: 2008-08-13 21:52:37 +0200 (Wed, 13 Aug 2008) $

       Full index

       © 2003-2013 GRASS Development Team



  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to webmaster@gnu.wiki.
Page load time: 0.118 seconds. Last modified: November 04 2018 12:49:43.