NAME

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

KEYWORDS

       display, geometry

SYNOPSIS

       d.measure
       d.measure help
       d.measure [-smk]  [c1=string]   [c2=string]   [--verbose]  [--quiet]

   Flags:
       -s
           Suppress clear screen

       -m
           Output in meters only

       -k
           Output in kilometers as well

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       c1=string
           Line color 1
           Options:
           red,orange,yellow,green,blue,indigo,violet,white,black,gray,brown,magenta,aqua,grey,cyan,purple
           Default: white

       c2=string
           Line color 2
           Options:
           red,orange,yellow,green,blue,indigo,violet,white,black,gray,brown,magenta,aqua,grey,cyan,purple
           Default: black

DESCRIPTION

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

NOTES

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

TODO

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

SEE ALSO

       d.frame
       d.graph
       d.rast
       d.vect
       d.where
       g.proj

AUTHORS

       James Westervelt,
       Michael Shapiro,
       U.S. Army Construction Engineering Research Laboratory

       Last changed: $Date: 2011-11-08 03:29:50 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team