1v.build(1) Grass User's Manual v.build(1)
2
3
4
6 v.build - Creates topology for vector map.
7 Optionally also checks for topological errors.
8
10 vector, topology, geometry
11
13 v.build
14 v.build --help
15 v.build [-e] map=name [error=name] option=string[,string,...]
16 [--overwrite] [--help] [--verbose] [--quiet] [--ui]
17
18 Flags:
19 -e
20 Extensive checks for topological errors
21 Perform in-depth checks for topological errors when building topol‐
22 ogy
23
24 --overwrite
25 Allow output files to overwrite existing files
26
27 --help
28 Print usage summary
29
30 --verbose
31 Verbose module output
32
33 --quiet
34 Quiet module output
35
36 --ui
37 Force launching GUI dialog
38
39 Parameters:
40 map=name [required]
41 Name of vector map
42
43 error=name
44 Name for output vector map where erroneous vector features are
45 written to
46
47 option=string[,string,...] [required]
48 Build topology or dump topology or indices to standard output
49 Options: build, dump, sdump, cdump, fdump
50 Default: build
51 build: build topology
52 dump: write topology to stdout
53 sdump: write spatial index to stdout
54 cdump: write category index to stdout
55 fdump: write feature index to stdout (OGR simple-feature-based for‐
56 mats only)
57
59 v.build builds support files for GRASS vector maps. These support files
60 supply topology and category information including spatial index that
61 are needed by other GRASS modules.
62
63 GRASS is generating these support files automatically, only in rare
64 cases the user has to (re)build them.
65
66 Refer to vector data processing in GRASS GIS for more information on
67 GRASS vector data model.
68
70 v.build creates support files only for vector maps located in the
71 user’s current mapset. It’s not possible to rebuild support files
72 (option=build) for vector maps from other mapsets.
73
74 In case of errors, the user can optionally generate an error vector map
75 containing the erroneous vectors for later inspection.
76
77 If error vector map is specified, v.build checks:
78
79 · isolated bondaries (which are not forming any areas),
80
81 · centroids outside of area,
82
83 · duplicated centroids.
84
85 Extensive checks for topological errors (flag -e) also includes:
86
87 · lines or boundaries of zero length,
88
89 · intersecting boundaries, ie. overlapping areas,
90
91 · areas without centroids that are not isles.
92
94 Build topology
95 Note that option=build recreates also spatial and category indices, not
96 only topology. For linked OGR layers (see v.external) also feature
97 index is created.
98 v.build map=urbanarea option=build
99 Note that the vector map urbanarea must be located in the current
100 mapset.
101
102 Dump topology or indices
103 Dump options print topology, spatial, category or feature index to
104 standard output. Such information can be printed also for vector maps
105 from other mapsets. A description of the vector topology is available
106 in the GRASS GIS 7 Programmer’s Manual, section "Vector library topol‐
107 ogy management".
108 v.build map=urbanarea option=dump
109
111 v.build.all, v.build.polylines, v.edit, v.split
112
113 See also wxGUI vector digitizer.
114
116 Dave Gerdes, U.S.Army Construction Engineering Research Laboratory,
117 Michael Higgins, U.S.Army Construction Engineering Research Laboratory,
118 Radim Blazek, ITC-irst, Trento, Italy
119
120 Last changed: $Date: 2016-03-08 09:06:33 +0100 (Tue, 08 Mar 2016) $
121
123 Available at: v.build source code (history)
124
125 Main index | Vector index | Topics index | Keywords index | Graphical
126 index | Full index
127
128 © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
129
130
131
132GRASS 7.6.0 v.build(1)