/usr/share/doc/grass-doc/html/v.digit.html is in grass-doc 6.4.3-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS manual: v.digit</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>v.digit</b></em> - Interactive editing and digitization of vector maps.
<h2>KEYWORDS</h2>
vector, editing, digitization
<h2>SYNOPSIS</h2>
<b>v.digit</b><br>
<b>v.digit help</b><br>
<b>v.digit</b> [-<b>n</b>] <b>map</b>=<em>name</em> [<b>bgcmd</b>=<em>string</em>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-n</b></DT>
<DD>Create new file if it does not exist.</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>map</b>=<em>name</em></DT>
<DD>Name of input vector map</DD>
<DT><b>bgcmd</b>=<em>string</em></DT>
<DD>Display commands to be used for canvas backdrop (separated by ';')</DD>
<DD>Default: <em></em></DD>
</DL>
<h2>DESCRIPTION</h2>
<em>v.digit</em> is a vector map digitizer with TCL/TK-based graphical
user interface. Attribute tables can be directly generated while
digitizing (define in "Settings" first).
<h2>NOTES</h2>
The <b>bgcmd</b> option is intended to be used with display (d.*) commands.
If several display commands are to be used to render the background
they should be separated with the semi-colon ';' character.
When run from the command line, these display commands will generally
need to be "quoted" as they will contain spaces (see examples).
<p>
<b>Dead (deleted) lines</b>: If a user deletes a line in <em>v.digit</em>,
it is internally only marked in the geometry file as 'dead' but it remains
there and occupies space. Any vector module used afterwards on this map
which really reads and writes vector geometry (so
not <em><a href="g.copy.html">g.copy</a></em>) will writes only lines
which are 'alive'.
<p>
If <em>v.digit</em> crashes for some reason you can repair the vector map
which was left open with the <em>v.build</em> module.
<h2>EXAMPLES</h2>
<h3>Start a monitor and display a raster to help setup and zoom to area of interest</h3>
<div class="code"><pre>
d.mon x0
d.rast name_of_raster
</pre></div>
<h3>Digitizing an area based on a existing raster map; creating a new vector map</h3>
<div class="code"><pre>
v.digit -n map=name_of_new_vector_map bgcmd="d.rast map=name_of_raster"
</pre></div>
<p>
The <b>-n</b> flag specifies that your vector map does not yet exist and
thus will be created with the name given by <b>map</b>. The <b>bgcmd</b>
specifies a display (d.*) command and is set in "quotes" as it contains a space.
<p>
The <em>v.digit</em> GUI appears and vector map "name_of_new_vector_map" is created.
<p>
After leaving <em>v.digit</em>, run:
<div class="code"><pre>
d.erase
d.vect "name_of_new_vector_map"
</pre></div>
The display should be cleared and the newly created vector should appear in
the monitor.
<h3>Digitizing a second vector, using your first vector and the raster image
as background</h3>
<div class="code"><pre>
v.digit -n map=name_of_second_vector \
bgcmd="d.rast map=name_of_your_raster; d.vect map=name_of_new_vector_map"
</pre></div>
The <em>v.digit</em> GUI appears and the layers defined with <b>bgcmd</b>
are displayed in the background. As the <b>bgcmd</b> commands are executed
as a series of commands (separated by a ";"), the last command (d.vect)
displays over the top of the earlier raster image.
<h3>Combining <b>bgcmd</b> with <em>d.save</em> to use the existing
display as a backdrop</h3>
<div class="code"><pre>
v.digit map=name bgcmd="`d.save -o | cut -f1 -d'#' | tr '\n' ';'`"
</pre></div>
<em><a href="d.save.html"><em>d.save</em></a></em> will list the commands used to draw
the current display; <em>cut</em> and <em>tr</em> are UNIX commands which are
used to remove comments and trade newlines for semi-colons, respectively.
<h2>SEE ALSO</h2>
<em>
<a href="r.digit.html">r.digit</a>,
<a href="v.clean.html">v.clean</a>,
<a href="v.edit.html">v.edit</a>
</em>
<p>
See also <em><a href="wxGUI.Vector_Digitizer.html">wxGUI Vector Digitizer</a></em>.
<h2>AUTHOR</h2>
Radim Blazek, ITC-Irst, Trento, Italy
<p>
<i>Last changed: $Date: 2011-01-31 15:58:25 -0800 (Mon, 31 Jan 2011) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="vector.html">vector index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2013 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
|