1v.centroids(1)              GRASS GIS User's Manual             v.centroids(1)
2
3
4

NAME

6       v.centroids  - Adds missing centroids to closed boundaries.
7

KEYWORDS

9       vector, centroid, area
10

SYNOPSIS

12       v.centroids
13       v.centroids --help
14       v.centroids  input=name  output=name   [option=string]   [layer=string]
15       [cat=integer]   [step=integer]   [--overwrite]   [--help]   [--verbose]
16       [--quiet]  [--ui]
17
18   Flags:
19       --overwrite
20           Allow output files to overwrite existing files
21
22       --help
23           Print usage summary
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31       --ui
32           Force launching GUI dialog
33
34   Parameters:
35       input=name [required]
36           Name of input vector map
37           Or data source for direct OGR access
38
39       output=name [required]
40           Name for output vector map
41
42       option=string
43           Action to be taken
44           Options: add
45           Default: add
46
47       layer=string
48           Layer number or name
49           Vector  features can have category values in different layers. This
50           number determines which layer to use. When used with direct OGR ac‐
51           cess this is the layer name.
52           Default: 1
53
54       cat=integer
55           Category number starting value
56           Default: 1
57
58       step=integer
59           Category increment
60           Default: 1
61

DESCRIPTION

63       GRASS defines vector areas as composite entities consisting of a set of
64       closed boundaries and a centroid. The attribute information  associated
65       with  that  area is linked to the centroid. The v.centroids module adds
66       centroids to closed boundaries in the input file and assigns a category
67       number to them. The starting value as well as the increment size may be
68       set using optional parameters.
69
70       Multiple attributes may be linked to a  single  vector  entity  through
71       numbered fields referred to as layers. Refer to v.category for more de‐
72       tails, as v.centroids is simply a frontend to that module.
73
74       The boundary itself is often stored without any category  reference  as
75       it can mark the border between two adjacent areas. Thus it would be am‐
76       biguous as to which feature the attribute would belong. In  some  cases
77       it  may,  for example, represent a road between two parcels of land. In
78       this case it is entirely appropriate for the boundary to contain  cate‐
79       gory information.
80

EXAMPLES

82       Create an area from a closed line using North Carolina sample dataset:
83       v.type input=busroute11 output=busroute11_boundary from_type=line to_type=boundary
84       v.centroids input=busroute11_boundary output=busroute11_area
85       Figure: Creating area from closed line
86

SEE ALSO

88        v.category
89

AUTHORS

91       module:  M.  Hamish Bowman, Dept. Marine Science, Otago University, New
92       Zealand
93       help page: Trevor Wiens
94

SOURCE CODE

96       Available at: v.centroids source code (history)
97
98       Accessed: Saturday Jan 21 20:41:02 2023
99
100       Main index | Vector index | Topics index | Keywords index  |  Graphical
101       index | Full index
102
103       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
104
105
106
107GRASS 8.2.1                                                     v.centroids(1)