← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to vector/v.digit/description.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
vector/v.digit/description.html
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>v.digit</em> is a vector map digitizer with TCL/TK-based graphical
4
 
user interface.  Attribute tables can be directly generated while
5
 
digitizing (define in "Settings" first).
6
 
 
7
 
 
8
 
<h2>NOTES</h2>
9
 
 
10
 
The <b>bgcmd</b> option is intended to be used with display (d.*) commands.
11
 
If several display commands are to be used to render the background
12
 
they should be separated with the semi-colon ';' character.
13
 
When run from the command line, these display commands will generally
14
 
need to be "quoted" as they will contain spaces (see examples).
15
 
 
16
 
<p>
17
 
<b>Dead (deleted) lines</b>: If a user deletes a line in <em>v.digit</em>,
18
 
it is internally only marked in the geometry file as 'dead' but it remains
19
 
there and occupies space. Any vector module used afterwards on this map
20
 
which really reads and writes vector geometry (so
21
 
not <em><a href="g.copy.html">g.copy</a></em>) will writes only lines
22
 
which are 'alive'.
23
 
 
24
 
<p>
25
 
If <em>v.digit</em> crashes for some reason you can repair the vector map
26
 
which was left open with the <em>v.build</em> module.
27
 
 
28
 
 
29
 
<h2>EXAMPLES</h2>
30
 
 
31
 
<h3>Start a monitor and display a raster to help setup and zoom to area of interest</h3>
32
 
 
33
 
<div class="code"><pre>
34
 
d.mon x0
35
 
d.rast name_of_raster
36
 
</pre></div>
37
 
 
38
 
<h3>Digitizing an area based on a existing raster map; creating a new vector map</h3>
39
 
 
40
 
<div class="code"><pre>
41
 
v.digit -n map=name_of_new_vector_map bgcmd="d.rast map=name_of_raster"
42
 
</pre></div>
43
 
 
44
 
<p>
45
 
The <b>-n</b> flag specifies that your vector map does not yet exist and
46
 
thus will be created with the name given by <b>map</b>. The <b>bgcmd</b>
47
 
specifies a display (d.*) command and is set in "quotes" as it contains a space.
48
 
 
49
 
<p>
50
 
The <em>v.digit</em> GUI appears and vector map "name_of_new_vector_map" is created.
51
 
 
52
 
<p>
53
 
After leaving <em>v.digit</em>, run:
54
 
 
55
 
<div class="code"><pre>
56
 
d.erase
57
 
d.vect "name_of_new_vector_map" 
58
 
</pre></div>
59
 
 
60
 
The display should be cleared and the newly created vector should appear in 
61
 
the monitor.
62
 
 
63
 
<h3>Digitizing a second vector, using your first vector and the raster image
64
 
as background</h3>
65
 
 
66
 
<div class="code"><pre>
67
 
v.digit -n map=name_of_second_vector \
68
 
bgcmd="d.rast map=name_of_your_raster; d.vect map=name_of_new_vector_map"
69
 
</pre></div>
70
 
 
71
 
The <em>v.digit</em> GUI appears and the layers defined with <b>bgcmd</b>
72
 
are displayed in the background. As the <b>bgcmd</b> commands are executed 
73
 
as a series of commands (separated by a ";"), the last command (d.vect)
74
 
displays over the top of the earlier raster image.
75
 
 
76
 
 
77
 
<h3>Combining <b>bgcmd</b> with <em>d.save</em> to use the existing
78
 
display as a backdrop</h3>
79
 
 
80
 
<div class="code"><pre>
81
 
v.digit map=name bgcmd="`d.save -o | cut -f1 -d'#' | tr '\n' ';'`"
82
 
</pre></div>
83
 
 
84
 
<em><a href="d.save.html"><em>d.save</em></a></em> will list the commands used to draw
85
 
the current display; <em>cut</em> and <em>tr</em> are UNIX commands which are
86
 
used to remove comments and trade newlines for semi-colons, respectively.
87
 
 
88
 
<h2>SEE ALSO</h2>
89
 
 
90
 
<em>
91
 
  <a href="r.digit.html">r.digit</a>,
92
 
  <a href="v.clean.html">v.clean</a>,
93
 
  <a href="v.edit.html">v.edit</a>
94
 
</em>
95
 
 
96
 
<p>
97
 
See also <em><a href="wxGUI.Vector_Digitizer.html">wxGUI Vector Digitizer</a></em>.
98
 
 
99
 
<h2>AUTHOR</h2>
100
 
 
101
 
Radim Blazek, ITC-Irst, Trento, Italy
102
 
 
103
 
<p>
104
 
<i>Last changed: $Date: 2011-02-01 00:58:25 +0100 (Tue, 01 Feb 2011) $</i>