d.measure(1)	       Grass User's Manual	     d.measure(1)



NNAAMMEE
       dd..mmeeaassuurree  -  Measures  the  lengths and areas of features
       drawn by the user in  the  active  display  frame  on  the
       graphics monitor.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..mmeeaassuurree
       dd..mmeeaassuurree hheellpp
       dd..mmeeaassuurree [--sskkmm] [cc11==_n_a_m_e] [cc22==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._m_e_a_s_u_r_e  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 _c_1 and _c_2.
       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_._m_e_a_s_u_r_e. Lines and polygons are defined by the series of
       vertices marked by the user. If more than  two  successive
       vertices  are drawn, _d_._m_e_a_s_u_r_e prints the area encompassed
       (_d_._m_e_a_s_u_r_e will assume the area is closed even if the user
       has not joined the first and last vertices).  Line lengths
       are stated in the same units as those of the current LOCA-
       TION.  In  a  XY-LOCATION,  where  no units are available,
       _d_._m_e_a_s_u_r_e prints  a  warning  and  gives  results  without
       units.  Areas are stated in hectares, square miles, square
       meters and square kilometers.  Lines  and  polygons  drawn
       using _d_._m_e_a_s_u_r_e will overlay (not overwrite) whatever dis-
       play currently appears in the active frame on the graphics
       monitor.   The user can, for example, run _d_._r_a_s_t or _d_._v_e_c_t
       prior to running _d_._m_e_a_s_u_r_e, and use raster  and/or  vector
       maps as a backdrop.

OOPPTTIIOONNSS
       The  user  can  specify	the colors in which line segments
       will be drawn by setting the values of _c_1 and  _c_2  on  the
       command	line.	Default  line  colors (see below) will be
       used if the user does not specify the values of _c_1 and  _c_2
       on the command line.

   FFllaaggss
       --ss     Suppesses  clear	screen	and  writes  messages  to
	      stderr instead of stdout. Usefull for work with the
	      TCLTKGRASS gui.

       --mm     Use metric units (meters, kilometers) only

       --kk     Output  results  (additionally)  in  kilometers and
	      square kilometers


   PPaarraammeetteerrss::
       cc11==_n_a_m_e
	      The first color  in  which  each	line  segment  is
	      drawn, while being positioned.
	      Options:	red, orange, yellow, green, blue, indigo,
	      violet, magenta, brown, gray, white, and black
	      Default: _w_h_i_t_e

       cc22==_n_a_m_e
	      The second color in  which  each	line  segment  is
	      drawn, after its vertices are fixed.  Options: Same
	      as _c_1.
	      Default: _w_h_i_t_e


NNOOTTEESS
       _d_._m_e_a_s_u_r_e uses all segments drawn by the user when comput-
       ing  area.  If the user draws an area within another area,
       the combined area of both regions will be output.

SSEEEE AALLSSOO
       _d_._d_i_s_p_l_a_y

       _d_._f_r_a_m_e

       _d_._g_r_a_p_h

       _d_._m_a_p_g_r_a_p_h

       _d_._r_a_s_t

       _d_._v_e_c_t

       _d_._w_h_e_r_e

AAUUTTHHOORRSS
       James Westervelt,
       Michael Shapiro,

       U.S. Army Construction Engineering Research Laboratory



GRASS 5.0					     d.measure(1)
