.TH v.centroids 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBv.centroids\fR\fR  - Adds missing centroids to closed boundaries.
.SH KEYWORDS
vector, centroid, area
.SH SYNOPSIS
\fBv.centroids\fR
.br
\fBv.centroids help\fR
.br
\fBv.centroids input\fR=\fIname\fR \fBoutput\fR=\fIname\fR  [\fBoption\fR=\fIstring\fR]   [\fBlayer\fR=\fIinteger\fR]   [\fBcat\fR=\fIinteger\fR]   [\fBstep\fR=\fIinteger\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBinput\fR=\fIname\fR" 4m
.br
Name of input vector map
.IP "\fBoutput\fR=\fIname\fR" 4m
.br
Name for output vector map
.IP "\fBoption\fR=\fIstring\fR" 4m
.br
Action to be taken
.br
Options: \fIadd\fR
.br
Default: \fIadd\fR
.IP "\fBlayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
Default: \fI1\fR
.IP "\fBcat\fR=\fIinteger\fR" 4m
.br
Category number starting value
.br
Default: \fI1\fR
.IP "\fBstep\fR=\fIinteger\fR" 4m
.br
Category increment
.br
Default: \fI1\fR
.PP
.SH DESCRIPTION
GRASS defines vector areas as composite entities consisting of a set of
closed boundaries and a centroid. The attribute information associated
with that area is linked to the centroid. The \fIv.centroids\fR module
adds centroids to closed boundaries in the \fBinput\fR file and assigns a
category number to them. The starting value as well as the increment size
may be set using optional parameters. 
.PP
Multiple attributes may be linked to a single vector entity through
numbered fields referred to as layers. Refer to \fIv.category\fR
for more details, as \fIv.centroids\fR is simply a frontend to that
module.
.PP
The boundary itself is often stored without any category reference as it
can mark the border between two adjacent areas. Thus it would be ambiguous
as to which feature the attribute would belong. In some cases it may, for
example, represent a road between two parcels of land. In this case it
is entirely appropriate for the boundary to contain category information.
.SH SEE ALSO
\fI
v.category
\fR
.SH AUTHORS
module: M. Hamish Bowman, Dept. Marine Science, Otago University, New Zealand
.br
help page: Trevor Wiens
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team