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

NAME

6       v.build  - Creates topology for vector map.
7       Optionally also checks for topological errors.
8

KEYWORDS

10       vector, topology, geometry
11

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

EXAMPLES

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

SEE ALSO

111        v.build.all, v.build.polylines, v.edit, v.split
112
113       See also wxGUI vector digitizer.
114

AUTHORS

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

SOURCE CODE

121       Available at: v.build source code (history)
122
123       Main  index  | Vector index | Topics index | Keywords index | Graphical
124       index | Full index
125
126       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
127
128
129
130GRASS 7.8.5                                                         v.build(1)
Impressum