r.digit(1)

1r.digit(1)                    Grass User's Manual                   r.digit(1)
2
3
4

NAME

6       r.digit   - Interactive tool used to draw and save vector features on a
7       graphics monitor using a pointing device (mouse) and save to  a  raster
8       map.
9

KEYWORDS

11       raster
12

SYNOPSIS

14       r.digit
15       r.digit help
16       r.digit   output=name    [bgcmd=string]     [--overwrite]   [--verbose]
17       [--quiet]
18
19   Flags:
20       --overwrite
21           Allow output files to overwrite existing files
22
23       --verbose
24           Verbose module output
25
26       --quiet
27           Quiet module output
28
29   Parameters:
30       output=name
31           Name for output raster map
32
33       bgcmd=string
34           Display commands to be used for canvas backdrop (separated by ';')
35

DESCRIPTION

37       The GRASS tool r.digit provides the user with  a  way  to  draw  lines,
38       areas, and circles on a monitor screen, and to save these features in a
39       raster map.  Lines, areas, and circles are to be drawn using a pointing
40       device  (mouse).   A  mouse  button  menu indicates the consequences of
41       pressing each mouse button.  The user is requested to enter  the  cate‐
42       gory  number  associated  with  the  line, area, or circle subsequently
43       drawn by the user.  Lines, areas, and circles are defined by the series
44       of points marked by the user inside the map window.  r.digit will close
45       areas when the user has not.  By drawing a series of such features, the
46       user can repair maps, identify areas of interest, or simply draw graph‐
47       ics for advertisement.  When drawing is completed, a raster  map  based
48       on  the user's instructions is generated.  It is available for use as a
49       mask, in analyses, and for display.
50
51       The bgcmd option is intended to be used with  display  (d.*)  commands.
52       If  several  display  commands  are to be used to render the background
53       they should be separated with the semi-colon ';' character.   When  run
54       from the command line, these display commands will generally need to be
55       "quoted" as they will contain spaces (see examples).
56
57       Digitizing is done in a "polygon" method.  Each area  is  circumscribed
58       completely.   Two or more overlapping areas and/or lines might define a
59       single part of a map.  Each part of the map, however, is assigned  only
60       the LAST area or line which covered it.
61
62   THE PROCESS:
63   Start  a  monitor  and  display  a raster to help setup and zoom to area of
64       interest
65
66       d.mon x0
67
68
69   Digitizing an area based on a existing map; creating a new raster map
70
71       r.digit out=name_of_new_raster_map bgcmd="d.rast map=name_of_raster"
72        Choose to define an area or line, exit, or quit.   If  you  choose  to
73       finish  (exit)  a  new  map  is then created.  If you quit, the session
74       exits with nothing created.  If you choose to make an area or line  you
75       must  identify  the  category  number for that area or line.  Using the
76       mouse trace the line or circumscribe the area; or, finish (go  to  Step
77       1).
78

AUTHOR

84       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
85
86       Last changed: $Date: 2007-02-19 22:44:38 +0100 (Mon, 19 Feb 2007) $
87
88       Full index
89
90       © 2003-2008 GRASS Development Team
91
92
93
94GRASS 6.3.0                                                         r.digit(1)

NAME

KEYWORDS

SYNOPSIS

DESCRIPTION

SEE ALSO

AUTHOR