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-01-31 15:58:25 -0800 (Mon, 31 Jan 2011) $

       Full index

       © 2003-2013 GRASS Development Team