1g.gui.vdigit(1)             GRASS GIS User's Manual            g.gui.vdigit(1)
2
3
4

NAME

6       g.gui.vdigit  - Interactive editing and digitization of vector maps.
7

KEYWORDS

9       general, GUI, vector, editing, digitizer
10

SYNOPSIS

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

DESCRIPTION

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  se‐
55       lecting  "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  at‐
102           tributes.
103
104             Digitize new centroid
105           Add  new  centroid  to  vector  map  and  optionally define its at‐
106           tributes.
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
152Break selected lines/boundaries at intersection
153               Split given vector line or boundary into two lines on given po‐
154               sition (based on v.clean, tool=break).
155
156Connect 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
163Copy 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
170Copy 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
176Copy 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
184Feature 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
189Flip selected lines/boundaries
190               Flip  direction  of  selected  linear features (lines or bound‐
191               aries).
192
193Merge 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
200Snap 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
206Split line/boundary
207               Split selected line or boundary on given position.
208
209Query tool
210               Select  vector  features  by  defining  a threshold for min/max
211               length value (linear features or dangles).
212
213Z-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

NOTES

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

REFERENCES

260           •   GRASS Vedit Library
261
262           •   Vector Database Management (Wiki page)
263

SEE ALSO

265        wxGUI
266       wxGUI components
267
268        v.edit, v.category, v.build, g.gui.rdigit, wxGUI.rdigit
269
270       See also the WxGUI Vector Digitizer Wiki page including  video  tutori‐
271       als.
272

AUTHOR

274       Martin  Landa, FBK-irst (2007-2008), Trento, Italy, and Czech Technical
275       University in Prague, Czech Republic
276

SOURCE CODE

278       Available at: wxGUI Vector Digitizer source code (history)
279
280       Accessed: Mon Jun 20 16:48:30 2022
281
282       Main index | GUI index | Topics index | Keywords index | Graphical  in‐
283       dex | Full index
284
285       © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
286
287
288
289GRASS 8.2.0                                                    g.gui.vdigit(1)
Impressum