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
10

SYNOPSIS

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

DESCRIPTION

28       v.digit is a  vector  map  digitizer  with  graphical  user  interface.
29       Attribute  tables can be directly generated while digitizing (define in
30       "Settings" first).
31

NOTES

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

EXAMPLES

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

AUTHOR

101       Radim Blazek, ITC-Irst, Trento, Italy
102
103       Last changed: $Date: 2006/07/03 16:38:16 $
104
105       Full index
106
107
108
109GRASS 6.2.2                                                         v.digit(1)