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           Ctrl+P.
97
98             Digitize new line
99           Add  new  line  to vector map and optionally define its attributes,
100           Ctrl+L.
101
102             Digitize new boundary
103           Add new boundary to  vector  map  and  optionally  define  its  at‐
104           tributes.
105
106             Digitize new centroid
107           Add  new  centroid  to  vector  map  and  optionally define its at‐
108           tributes.
109
110             Digitize new area
111           Add new area (closed boundary and one centroid  inside)  to  vector
112           map and optionally define its attributes.
113
114             Move vertex
115           Move  selected  vertex of linear feature. Thus shape of linear fea‐
116           ture is changed.
117
118             Add vertex
119           Add new vertex to selected linear feature (shape not changed).
120
121             Remove vertex
122           Remove selected vertex from linear feature. Thus shape of  selected
123           feature can be changed.
124
125             Edit line/boundary
126           Edit  selected  linear feature, add new segments or remove existing
127           segments of linear feature.
128
129             Move feature(s)
130           Move selected vector features. Selection can be done by mouse or by
131           query.
132
133             Delete feature(s)
134           Delete  selected  vector features (point, line, centroid, or bound‐
135           ary). Selection can be done by mouse or by query.
136
137             Delete areas(s)
138           Delete selected vector areas. Selection can be done by mouse or  by
139           query.
140
141             Display/update categories
142           Display  categories  of  selected vector feature. Category settings
143           can be modified, new layer/category pairs added or already  defined
144           pairs removed.
145
146             Display/update attributes
147           Display  attributes  of selected vector feature (based on its cate‐
148           gory settings).  Attributes can be also modified. Same  functional‐
149           ity  is  accessible  from  Main toolbar "Query vector map (editable
150           mode)".
151
152             Additional tools
153
154Break selected lines/boundaries at intersection
155               Split given vector line or boundary into two lines on given po‐
156               sition (based on v.clean, tool=break).
157
158Connect two selected lines/boundaries
159               Connect  selected  lines or boundaries, the first given line is
160               connected to the second one. The second line is broken if  nec‐
161               essary  on  each intersection.  The lines are connected only if
162               distance between them is not greater  than  snapping  threshold
163               value.
164
165Copy categories
166               Copy category settings of selected vector feature to other vec‐
167               tor features. Layer/category pairs of  source  vector  features
168               are  appended to the target feature category settings. Existing
169               layer/category pairs are not removed from category settings  of
170               the target features.
171
172Copy features from (background) vector map
173               Make  identical  copy  of  selected vector features. If a back‐
174               ground vector map has been selected  from  the  Layer  Manager,
175               copy  features  from  background  vector map, not from the cur‐
176               rently modified vector map.
177
178Copy attributes
179               Duplicate attributes settings of  selected  vector  feature  to
180               other  vector  features.  New  category(ies) is appended to the
181               target feature  category  settings  and  attributes  duplicated
182               based  on category settings of source vector features. Existing
183               layer/category pairs are not removed from category settings  of
184               the target features.
185
186Feature type conversion
187               Change  feature  type of selected geometry features. Points are
188               converted to centroids, centroids to points,  lines  to  bound‐
189               aries and boundaries to lines.
190
191Flip selected lines/boundaries
192               Flip  direction  of  selected  linear features (lines or bound‐
193               aries).
194
195Merge selected lines/boundaries
196               Merge (at least two) selected vector lines or  boundaries.  The
197               geometry of the merged vector lines can be changed. If the sec‐
198               ond line from two selected lines is in  opposite  direction  to
199               the  first,  it  will be flipped. See also module v.build.poly‐
200               lines.
201
202Snap selected lines/boundaries (only to nodes)
203               Snap vector  features  in  given  threshold.  See  also  module
204               v.clean.  Note  that this tool supports only snapping to nodes.
205               Snapping to vector features from background vector map  is  not
206               currently supported.
207
208Split line/boundary
209               Split selected line or boundary on given position.
210
211Query tool
212               Select  vector  features  by  defining  a threshold for min/max
213               length value (linear features or dangles).
214
215Z-bulk labeling of 3D lines
216               Assign z coordinate values to 3D vector lines in bounding  box.
217               This is useful for labeling contour lines.
218
219             Undo
220           Undo previous operations.
221
222             Redo
223           Redo previous operations.
224
225             Settings
226           Digitizer settings.
227
228             Quit digitizing tool
229           Changes  in  vector map can be optionally discarded when digitizing
230           session is quited.
231

NOTES

233       Mouse button functions:
234
235       Left   - select or deselect features
236
237       Control+Left - cancel action or undo vertex when digitizing lines
238
239       Right  - confirm action
240
241       Dead (deleted) features are only marked as ’dead’ in the geometry  file
242       but remain there and occupy space. Any vector module used afterwards on
243       this vector map which really reads and writes vector geometry  (so  not
244       g.copy) will write only features which are ’alive’.
245
246       Added  or  modified vector features are snapped to existing vector fea‐
247       tures (Settings→General→Snapping).  To  disable  snapping  set  the
248       snapping threshold to ’0’.
249
250       If the digitizer crashes for some reason, the changes are automatically
251       saved. Broken topology can be repaired by running v.build.
252
253       GRASS GIS uses a topological  vector  format,  meaning  that  a  common
254       boundary  of two polygons is only stored once. When digitizing polygons
255       it is thus important to be able to only draw each boundary  once.  When
256       drawing  a  polygon  adjacent  to an existing polygon, one has to first
257       split the existing boundary at the points where the new  boundary  will
258       be  attached.  Snapping should be set to ensure that the new boundaries
259       are automatically attached to the chosen points.
260

REFERENCES

262           •   GRASS Vedit Library
263
264           •   Vector Database Management (Wiki page)
265

SEE ALSO

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

AUTHOR

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

SOURCE CODE

280       Available at: wxGUI Vector Digitizer source code (history)
281
282       Accessed: Saturday Jan 21 21:17:59 2023
283
284       Main index | GUI index | Topics index | Keywords index | Graphical  in‐
285       dex | Full index
286
287       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
288
289
290
291GRASS 8.2.1                                                    g.gui.vdigit(1)
Impressum