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]
16
17   Flags:
18       -s  Suppress clear screen
19
20       -m  Output in meters only
21
22       -k  Output in kilometers as well
23
24   Parameters:
25       c1=string
26           Line  color  1  Options:   red,orange,yellow,green,blue,indigo,vio‐
27           let,white,black,gray,brown,magenta,aqua,grey,cyan,purple   Default:
28           white
29
30       c2=string
31           Line  color  2  Options:   red,orange,yellow,green,blue,indigo,vio‐
32           let,white,black,gray,brown,magenta,aqua,grey,cyan,purple   Default:
33           black
34

DESCRIPTION

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

NOTES

54       d.measure  uses all segments drawn by the user when computing area.  If
55       the user draws an area within another area, the combined area  of  both
56       regions will be output.
57

TODO

59       Output  lengths  in  the same units as those of the current LOCATION as
60       found in the PROJ_UNITS file (see g.proj).  Volunteers are welcome  for
61       this task.
62

SEE ALSO

64       d.frame
65       d.graph
66       d.rast
67       d.vect
68       d.where
69       g.proj
70

AUTHORS

72       James Westervelt,
73       Michael Shapiro,
74       U.S. Army Construction Engineering Research Laboratory
75
76       Last changed: $Date: 2006/04/21 02:14:36 $
77
78       Full index
79
80
81
82GRASS 6.2.2                                                       d.measure(1)