Provided by: grass-doc_6.4.3-3_all

**NAME**

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

**KEYWORDS**

vector, database, attribute table

**SYNOPSIS**

v.vect.statsv.vect.statshelpv.vect.stats[-p]points=nameareas=name[type=string[,string,...]] [player=integer] [alayer=integer] [method=string] [pcolumn=name] [ccolumn=string] [scolumn=string] [fs=character|space|tab] [--verbose] [--quiet]Flags:-pPrint output to stdout, do not update attribute table First column is always area category--verboseVerbose module output--quietQuiet module outputParameters:points=nameName of existing vector map with pointsareas=nameName of existing vector map with areastype=string[,string,...] Feature type Feature type Options:point,centroidDefault:pointplayer=integerLayer number for points map A single vector map can be connected to multiple database tables. This number determines which table to use. Default:1alayer=integerLayer number for area map A single vector map can be connected to multiple database tables. This number determines which table to use. Default:1method=stringMethod for aggregate statistics Options:sum,average,median,mode,minimum,min_cat,maximum,max_cat,range,stddev,variance,diversitypcolumn=nameColumn name of points map to use for statistics Column of points map must be numericccolumn=stringColumn name to upload points count Column to hold points count, must be of type integer, will be created if not existingscolumn=stringColumn name to upload statistics Column to hold statistics, must be of type double, will be created if not existingfs=character|space|tabField separator Output field separator Default:|

**DESCRIPTION**

v.vect.statscounts the number of points in vector mappointsfalling into each area in vector mapareas. Optionally statistics on point attributes inpointsare calculated for each area. The results are either uploaded to the attribute table of the vector mapareasor printed to stdout.OPTIONSStatisticalMethods:Using numeric attribute values of all points falling into a given area, a new value is detmined with the selected method.v.vect.statscan perform the following operations:sumThe sum of values.averageThe average value of all point attributes (sum / count).medianThe value found half-way through a list of the attribute values, when these are ranged in numerical order.modeThe most frequently occurring value.minimumThe minimum observed value.min_catThe point category corresponding to the minimum observed value.maximumThe maximum observed value.max_catThe point category corresponding to the maximum observed value.rangeThe range of the observed values.stddevThe statistical standard deviation of the attribute values.varianceThe statistical variance of the attribute values.diversityThe 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 columnscount_columnandstats_columnare created if not existing. If they do already exist, thecount_columnmust be of type integer and thestats_columnof type double.

**SEE** **ALSO**

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

**AUTHOR**

Markus MetzLastchanged:$Date:2008-08-1321:52:37+0200(Wed,13Aug2008)$Full index © 2003-2013 GRASS Development Team