s.voronoi(1)	       Grass User's Manual	     s.voronoi(1)



NNAAMMEE
       ss..vvoorroonnooii   - Uses a GRASS sites list to produce a Voronoi
       diagram

       _(_G_R_A_S_S _S_i_t_e_s _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       ss..vvoorroonnooii [--aaqq] ssiitteess==_n_a_m_e vveecctt==_n_a_m_e [llaabbeellss==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       s.voronoi uses an existing sites list (sites) to create	a
       Voronoi	diagram  (Thiessen  polygons)  in a binary vector
       file (vect).



OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       ssiitteess==_n_a_m_e
	      Name of existing sites file.

       vveecctt==_n_a_m_e
	      Name of the output file (binary vector file).

       ccaattnnuumm==_n_a_m_e
	      no category numbers, keep from input file, generate
	      as serial number

	      options: no,keep,gen

	      default: keep


       llaabbeellss==_n_a_m_e
	      Field  to  use  to  generate  the  label. (no; cat;
	      str,#; dec,#)

	      default: no


   FFllaaggss::
       --aa     Use all sites found in the named sites file, rather
	      than  limiting  output  to sites falling within the
	      current geographic region.

       --qq     Quiet. Cut out the chatter.


NNOOTTEESS
	s.voronoi can be run either non-interactively or interac-
       tively.	 The program will be run non-interactively if the
       user specifies the name of an existing site list file  and
       a name for a vect file, using the form


	s.voronoi  [-aq]  sites=name1 vect=name2 catnum=optCatnum
       labels=optLabel

       where  name1 is the name of an existing site list file and
       name2  is the name of vector output file. optCatnum can be
       "keep" only if the site file category number  is  integer.
       optLabel  can  be  "no",  no  labels, "cat", use site file
       category number as label, str,num, use the num string type
       field of the site file as label, dec,num, use the num dec-
       imal type field of the site file as label.

	Alternately, the user can simply    type   s.voronoi   on
       the  command   line,   without program arguments.  In this
       case, the user  will  be  prompted  for	parameter  values
       using	 the	standard     GRASS    parser	interface
       described in the manual entry for parser.

EEXXAAMMPPLLEESS
       To create a Voronoi diagram keeping the original  category
       number  and  using  the	first decimal field as the output
       label use:


RREEFFEERREENNCCEESS
       _S_t_e_v_e _J_. _F_o_r_t_u_n_e_,   _(_1_9_8_7_)_.   _A	_S_w_e_e_p_l_i_n_e  _A_l_g_o_r_i_t_h_m  _f_o_r
       _V_o_r_o_n_o_i _D_i_a_g_r_a_m_s_, _A_l_g_o_r_i_t_h_m_i_c_a _2_, _1_5_3_-_1_7_4_.

SSEEEE AALLSSOO
       _v_._a_u_t_o_c_o_r_r_, _v_._s_p_a_g_, _v_._s_u_p_p_o_r_t_, _s_._d_e_l_a_u_n_a_y_, _s_._h_u_l_l_, _s_._s_w_e_e_p

AAUUTTHHOORR
       James Darrell McCauley, Purdue University

       GRASS 5 update, improvements: Andrea Aime, Modena, Italy

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0					     s.voronoi(1)
