v.digit(1)

1v.digit(1)                    Grass User's Manual                   v.digit(1)
2
3
4

NAME

6       v.digit  - Interactive editing and digitization of vector maps.
7

KEYWORDS

9       vector, editing, digitization
10

SYNOPSIS

12       v.digit
13       v.digit help
14       v.digit [-n] map=name  [bgcmd=string]   [--verbose]  [--quiet]
15
16   Flags:
17       -n
18           Create new file if it does not exist.
19
20       --verbose
21           Verbose module output
22
23       --quiet
24           Quiet module output
25
26   Parameters:
27       map=name
28           Name of input vector map
29
30       bgcmd=string
31           Display commands to be used for canvas backdrop (separated by ';')
32           Default:
33

DESCRIPTION

35       v.digit  is  a  vector  map  digitizer  with  graphical user interface.
36       Attribute tables can be directly generated while digitizing (define  in
37       "Settings" first).
38

NOTES

40       The  bgcmd  option  is intended to be used with display (d.*) commands.
41       If several display commands are to be used  to  render  the  background
42       they  should  be separated with the semi-colon ';' character.  When run
43       from the command line, these display commands will generally need to be
44       "quoted" as they will contain spaces (see examples).
45
46       Dead (deleted) lines: If a user deletes a line in v.digit, it is inter‐
47       nally only marked in the geometry file as 'dead' but it  remains  there
48       and occupies space. Any vector module used afterwards on this map which
49       really reads and writes vector geometry (so  not  g.copy)  will  writes
50       only lines which are 'alive'.
51

EXAMPLES

53   Start  a  monitor  and  display  a raster to help setup and zoom to area of
54       interest
55
56       d.mon x0
57       d.rast name_of_raster
58
59
60   Digitizing an area based on a existing raster map; creating  a  new  vector
61       map
62
63       v.digit -n map=name_of_new_vector_map bgcmd="d.rast map=name_of_raster"
64
65
66       The  "-n"  flag  specifies  that your vector map does not yet exist and
67       thus will be created with the name given by "map=". "bgcmd="  specifies
68       a display (d.*) command and is set in "quotes" as it contains a space.
69
70       The  v.digit  GUI  appears  -- after exiting v.digit GUI the vector map
71       "name_of_new_vector_map" is created.
72
73       After leaving v.digit, run:
74       d.erase
75       d.vect "name_of_new_vector_map"
76        The display should be cleared and  the  newly  created  vector  should
77       appear in the monitor.
78
79   Digitizing a second vector, using your first vector and the raster image
80       as background
81
82
83       v.digit -n map=name_of_second_vector \
84       bgcmd="d.rast   map=name_of_your_raster;   d.vect  map=name_of_new_vec‐
85       tor_map"
86
87
88       The v.digit GUI appears and the layers defined with bgcmd are displayed
89       in  the  background.  As the bgcmd commands are executed as a series of
90       commands (separated by a ";"), the last command (d.vect) displays  over
91       the top of the earlier raster image.
92
93   Combining bgcmd with d.save to use the existing
94       display as a backdrop
95
96
97       v.digit map=name bgcmd="`d.save -o | cut -f1 -d'#' | tr '\n' ';'`"
98         d.save  will  list the commands used to draw the current display; cut
99       and tr are UNIX commands which are used to remove  comments  and  trade
100       newlines for semi-colons, respectively.
101

AUTHOR

108       Radim Blazek, ITC-Irst, Trento, Italy
109
110       Last changed: $Date: 2006-07-03 18:38:16 +0200 (Mon, 03 Jul 2006) $
111
112       Full index
113
114       © 2003-2008 GRASS Development Team
115
116
117
118GRASS 6.3.0                                                         v.digit(1)