1g.gui.vdigit(1) GRASS GIS User's Manual g.gui.vdigit(1)
2
3
4
6 g.gui.vdigit - Interactive editing and digitization of vector maps.
7
9 general, GUI, vector, editing, digitizer
10
12 g.gui.vdigit
13 g.gui.vdigit --help
14 g.gui.vdigit [-c] map=name [--help] [--verbose] [--quiet] [--ui]
15
16 Flags:
17 -c
18 Create new vector map if doesn’t exist
19
20 --help
21 Print usage summary
22
23 --verbose
24 Verbose module output
25
26 --quiet
27 Quiet module output
28
29 --ui
30 Force launching GUI dialog
31
32 Parameters:
33 map=name [required]
34 Name of vector map to edit
35 Or data source for direct OGR access
36
38 The vector digitizer is a wxGUI component intended for interactive
39 editing and digitizing vector maps (see v.edit for non-interactive vec‐
40 tor editing GRASS capabilities).
41
42 Note that only vector maps stored or generated in the current mapset
43 can be opened for editing.
44
45 The digitizer allows editing of 2D vector features (points, lines, cen‐
46 troids, boundaries, and areas).
47
48 Vector features can be selected by mouse (bounding box or simply by
49 mouse click, see select threshold in SettingsâGeneralâSelect
50 threshold), or by query (eg. by line length, see SettingsâQuery
51 Tool).
52
53 STARTING THE DIGITIZER
54 The vector digitizer can be launched from Map Display toolbar by
55 selecting "Digitize" from Tools combobox. Vector map is selectable for
56 editing from Digitizer toolbar ("Select vector map" combobox, note that
57 only vector maps from the current layer tree in Layer Manager are
58 listed). The vector digitizer can alternatively be activated from the
59 contextual menu in the Layer Manager by selecting "Start editing" on
60 selected vector map in the layer tree, or directly from the Layer Man‐
61 ager toolbar . The vector digitizer also can also be launched from the
62 command line as a stand-alone application g.gui.vdigit.
63
64 CREATING A NEW VECTOR MAP
65 A new vector map can be easily created from the digitizer toolbar by
66 selecting "New vector map" in "Select vector map" combobox. A new vec‐
67 tor map is created, added to the current layer tree in Layer Manager
68 and opened for editing. "Select vector map" combobox in the digitizer
69 toolbar also allows easily switching between vector maps to be edited.
70
71 EDITING AN EXISTING VECTOR MAP
72 An existing vector map selected in the digitizer toolbar in the "Select
73 vector map" combobox. This map is then opened for editing and added to
74 the current layer tree in the Layer Manager. This "Select vector map"
75 combobox in the digitizer toolbar also allows to easily switch between
76 vector maps to be edited.
77
78 USING A RASTER BACKGROUND MAP
79 In order to digitize from a raster map, simply load the map into the
80 Map Display using the Layer Manager. Then start digitizing, see below
81 for details.
82
83 USING A VECTOR BACKGROUND MAP
84 The vector digitizer allows you to select a "background" vector map.
85 Loading it within the digitizer is different from simply loading it via
86 Layer Manager since direct interaction with single vector features then
87 becomes possible.
88 Vector features may be copied from the background map by "Copy features
89 from (background) vector map" tool from the "Additional tools" of the
90 digitizer toolbar. Newly digitized vector features are snapped in the
91 given threshold to the features from the background map.
92
93 DIGITIZER TOOLBAR
94 Â Digitize new point
95 Add new point to vector map and optionally define its attributes.
96
97 Â Digitize new line
98 Add new line to vector map and optionally define its attributes.
99
100 Â Digitize new boundary
101 Add new boundary to vector map and optionally define its
102 attributes.
103
104 Â Digitize new centroid
105 Add new centroid to vector map and optionally define its
106 attributes.
107
108 Â Digitize new area
109 Add new area (closed boundary and one centroid inside) to vector
110 map and optionally define its attributes.
111
112 Â Move vertex
113 Move selected vertex of linear feature. Thus shape of linear fea‐
114 ture is changed.
115
116 Â Add vertex
117 Add new vertex to selected linear feature (shape not changed).
118
119 Â Remove vertex
120 Remove selected vertex from linear feature. Thus shape of selected
121 feature can be changed.
122
123 Â Edit line/boundary
124 Edit selected linear feature, add new segments or remove existing
125 segments of linear feature.
126
127 Â Move feature(s)
128 Move selected vector features. Selection can be done by mouse or by
129 query.
130
131 Â Delete feature(s)
132 Delete selected vector features (point, line, centroid, or bound‐
133 ary). Selection can be done by mouse or by query.
134
135 Â Delete areas(s)
136 Delete selected vector areas. Selection can be done by mouse or by
137 query.
138
139 Â Display/update categories
140 Display categories of selected vector feature. Category settings
141 can be modified, new layer/category pairs added or already defined
142 pairs removed.
143
144 Â Display/update attributes
145 Display attributes of selected vector feature (based on its cate‐
146 gory settings). Attributes can be also modified. Same functional‐
147 ity is accessible from Main toolbar "Query vector map (editable
148 mode)".
149
150 Â Additional tools
151
152 · Break selected lines/boundaries at intersection
153 Split given vector line or boundary into two lines on given
154 position (based on v.clean, tool=break).
155
156 · Connect two selected lines/boundaries
157 Connect selected lines or boundaries, the first given line is
158 connected to the second one. The second line is broken if nec‐
159 essary on each intersection. The lines are connected only if
160 distance between them is not greater than snapping threshold
161 value.
162
163 · Copy categories
164 Copy category settings of selected vector feature to other vec‐
165 tor features. Layer/category pairs of source vector features
166 are appended to the target feature category settings. Existing
167 layer/category pairs are not removed from category settings of
168 the target features.
169
170 · Copy features from (background) vector map
171 Make identical copy of selected vector features. If a back‐
172 ground vector map has been selected from the Layer Manager,
173 copy features from background vector map, not from the cur‐
174 rently modified vector map.
175
176 · Copy attributes
177 Duplicate attributes settings of selected vector feature to
178 other vector features. New category(ies) is appended to the
179 target feature category settings and attributes duplicated
180 based on category settings of source vector features. Existing
181 layer/category pairs are not removed from category settings of
182 the target features.
183
184 · Feature type conversion
185 Change feature type of selected geometry features. Points are
186 converted to centroids, centroids to points, lines to bound‐
187 aries and boundaries to lines.
188
189 · Flip selected lines/boundaries
190 Flip direction of selected linear features (lines or bound‐
191 aries).
192
193 · Merge selected lines/boundaries
194 Merge (at least two) selected vector lines or boundaries. The
195 geometry of the merged vector lines can be changed. If the sec‐
196 ond line from two selected lines is in opposite direction to
197 the first, it will be flipped. See also module v.build.poly‐
198 lines.
199
200 · Snap selected lines/boundaries (only to nodes)
201 Snap vector features in given threshold. See also module
202 v.clean. Note that this tool supports only snapping to nodes.
203 Snapping to vector features from background vector map is not
204 currently supported.
205
206 · Split line/boundary
207 Split selected line or boundary on given position.
208
209 · Query tool
210 Select vector features by defining a threshold for min/max
211 length value (linear features or dangles).
212
213 · Z-bulk labeling of 3D lines
214 Assign z coordinate values to 3D vector lines in bounding box.
215 This is useful for labeling contour lines.
216
217 Â Undo
218 Undo previous operations.
219
220 Â Redo
221 Redo previous operations.
222
223 Â Settings
224 Digitizer settings.
225
226 Â Quit digitizing tool
227 Changes in vector map can be optionally discarded when digitizing
228 session is quited.
229
231 Mouse button functions:
232
233 Left - select or deselect features
234
235 Control+Left - cancel action or undo vertex when digitizing lines
236
237 Right - confirm action
238
239 Dead (deleted) features are only marked as ’dead’ in the geometry file
240 but remain there and occupy space. Any vector module used afterwards on
241 this vector map which really reads and writes vector geometry (so not
242 g.copy) will write only features which are ’alive’.
243
244 Added or modified vector features are snapped to existing vector fea‐
245 tures (SettingsâGeneralâSnapping). To disable snapping set the
246 snapping threshold to ’0’.
247
248 If the digitizer crashes for some reason, the changes are automatically
249 saved. Broken topology can be repaired by running v.build.
250
251 GRASS GIS uses a topological vector format, meaning that a common
252 boundary of two polygons is only stored once. When digitizing polygons
253 it is thus important to be able to only draw each boundary once. When
254 drawing a polygon adjacent to an existing polygon, one has to first
255 split the existing boundary at the points where the new boundary will
256 be attached. Snapping should be set to ensure that the new boundaries
257 are automatically attached to the chosen points.
258
260 · GRASS Vedit Library
261
262 · Vector Database Management (Wiki page)
263
265 wxGUI
266 wxGUI components
267
268 v.edit, v.category, v.build, wxGUI.rdigit
269
270 See also the WxGUI Vector Digitizer Wiki page including video tutori‐
271 als.
272
274 Martin Landa, FBK-irst (2007-2008), Trento, Italy, and Czech Technical
275 University in Prague, Czech Republic
276
278 Available at: wxGUI Vector Digitizer source code (history)
279
280 Main index | GUI index | Topics index | Keywords index | Graphical
281 index | Full index
282
283 © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
284
285
286
287GRASS 7.8.5 g.gui.vdigit(1)