1d.measure(1)                  Grass User's Manual                 d.measure(1)
2
3
4

NAME

6       d.measure   -  Measures  the lengths and areas of features drawn by the
7       user in the active display frame on the graphics monitor.
8

KEYWORDS

10       display
11

SYNOPSIS

13       d.measure
14       d.measure help
15       d.measure [-smk]  [c1=string]   [c2=string]   [--verbose]  [--quiet]
16
17   Flags:
18       -s
19           Suppress clear screen
20
21       -m
22           Output in meters only
23
24       -k
25           Output in kilometers as well
26
27       --verbose
28           Verbose module output
29
30       --quiet
31           Quiet module output
32
33   Parameters:
34       c1=string
35           Line color 1
36           Options:                   red,orange,yellow,green,blue,indigo,vio‐
37           let,white,black,gray,brown,magenta,aqua,grey,cyan,purple
38           Default: white
39
40       c2=string
41           Line color 2
42           Options:                   red,orange,yellow,green,blue,indigo,vio‐
43           let,white,black,gray,brown,magenta,aqua,grey,cyan,purple
44           Default: black
45

DESCRIPTION

47       d.measure provides the user with an  interactive  way  to  measure  the
48       lengths and areas of lines and polygons drawn by the user in the active
49       frame on the graphics monitor.  Lines and polygons are  drawn  using  a
50       pointing  device  (mouse).  Each line segment is drawn in colors c1 and
51       c2.  A mouse button menu indicates that the user can find out the  geo‐
52       graphic  coordinates of the cursor location, draw line segments between
53       user-specified vertices, and quit d.measure.  Lines  and  polygons  are
54       defined  by the series of vertices marked by the user. If more than two
55       successive vertices are drawn, d.measure prints  the  area  encompassed
56       (d.measure  will  assume  the  area  is closed even if the user has not
57       joined the first and last vertices).  Areas can be stated in  hectares,
58       square  miles, square meters and square kilometers.  Lines and polygons
59       drawn using d.measure will overlay  (not  overwrite)  whatever  display
60       currently  appears  in  the  active frame on the graphics monitor.  The
61       user can, for example, run d.rast or d.vect prior to running d.measure,
62       and use raster and/or vector maps as a backdrop.
63

NOTES

65       d.measure  uses all segments drawn by the user when computing area.  If
66       the user draws an area within another area, the combined area  of  both
67       regions will be output.
68

TODO

70       Output  lengths  in  the same units as those of the current LOCATION as
71       found in the PROJ_UNITS file (see g.proj).  Volunteers are welcome  for
72       this task.
73

SEE ALSO

75       d.frame
76       d.graph
77       d.rast
78       d.vect
79       d.where
80       g.proj
81

AUTHORS

83       James Westervelt,
84       Michael Shapiro,
85       U.S. Army Construction Engineering Research Laboratory
86
87       Last changed: $Date: 2006-04-21 04:14:36 +0200 (Fri, 21 Apr 2006) $
88
89       Full index
90
91       © 2003-2008 GRASS Development Team
92
93
94
95GRASS 6.3.0                                                       d.measure(1)