NAME¶
v.digit - Interactive editing and digitization of vector maps.
KEYWORDS¶
vector, editing, digitization
SYNOPSIS¶
v.digit
v.digit help
v.digit [-
n]
map=
name [
bgcmd=
string]
[--
verbose] [--
quiet]
Flags:¶
- -n
-
Create new file if it does not exist.
- --verbose
-
Verbose module output
- --quiet
-
Quiet module output
Parameters:¶
- map=name
-
Name of input vector map
- bgcmd=string
-
Display commands to be used for canvas backdrop (separated by ';')
Default:
DESCRIPTION¶
v.digit is a vector map digitizer with TCL/TK-based graphical user
interface. Attribute tables can be directly generated while digitizing (define
in "Settings" first).
NOTES¶
The
bgcmd 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).
Dead (deleted) lines: If a user deletes a line in
v.digit, 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
g.copy) will writes only lines
which are 'alive'.
If
v.digit crashes for some reason you can repair the vector map which
was left open with the
v.build module.
EXAMPLES¶
Start a monitor and display a raster to help setup and zoom to area of interest¶
d.mon x0
d.rast name_of_raster
Digitizing an area based on a existing raster map; creating a new vector map¶
v.digit -n map=name_of_new_vector_map bgcmd="d.rast
map=name_of_raster"
The
-n flag specifies that your vector map does not yet exist and thus
will be created with the name given by
map. The
bgcmd specifies
a display (d.*) command and is set in "quotes" as it contains a
space.
The
v.digit GUI appears and vector map "name_of_new_vector_map"
is created.
After leaving
v.digit, run:
d.erase
d.vect "name_of_new_vector_map"
The display should be cleared and the newly created vector should appear in the
monitor.
Digitizing a second vector, using your first vector and the raster image¶
as background
v.digit -n map=name_of_second_vector \
bgcmd="d.rast map=name_of_your_raster; d.vect
map=name_of_new_vector_map"
The
v.digit GUI appears and the layers defined with
bgcmd are
displayed in the background. As the
bgcmd 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.
Combining bgcmd with d.save to use the existing¶
display as a backdrop
v.digit map=name bgcmd="`d.save -o | cut -f1 -d'#' | tr '\n' ';'`"
d.save will list the commands used to draw the current display;
cut and
tr are UNIX commands which are used to remove comments
and trade newlines for semi-colons, respectively.
SEE ALSO¶
r.digit, v.clean, v.edit
See also
wxGUI Vector Digitizer.
AUTHOR¶
Radim Blazek, ITC-Irst, Trento, Italy
Last changed: $Date: 2011-02-01 00:58:25 +0100 (Tue, 01 Feb 2011) $
Full index
© 2003-2014 GRASS Development Team