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	  [ccaattnnuumm==_n_o_|_k_e_e_p_|_g_e_n]
       [llaabbeellss==_n_o_|_c_a_t_|_s_t_r_,_#_|_d_e_c_,_#]

DDEESSCCRRIIPPTTIIOONN
       _s_._v_o_r_o_n_o_i uses an existing sites list (ssiitteess) to create a Voronoi  dia-
       gram (Thiessen polygons) in a binary vector file (vveecctt).



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_o_|_k_e_e_p_|_g_e_n
	      What  to use as category numbers for the vector output: _n_o cate-
	      gory numbers, _k_e_e_p from input file, or _g_e_nerate as  serial  num-
	      ber.

	      options: _n_o, _k_e_e_p, or _g_e_n

	      default: _k_e_e_p

       llaabbeellss==_n_o_|_c_a_t_|_s_t_r_,_#_|_d_e_c_,_#
	      Site file field to use for generating the label. "_#" is the _n-th
	      string or decimal field associated with the site record.

	      options: _n_o; _c_a_t; _s_t_r_,_#; or _d_e_c_,_#

	      default: _n_o


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

       --qq     Quiet. Cut out the chatter.


NNOOTTEESS
	_s_._v_o_r_o_n_o_i can be run either non-interactively or  interactively.   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,_n_u_m,  use  the  _n_u_m
       string  type  field  of the site file as label; or dec,_n_u_m, use the _n_u_m
       decimal type field of the site file as label.

	Alternately, the  user	can  simply  type   ss..vvoorroonnooii	on   the  com-
       mand   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_3_/_0_8_/_2_0 _0_8_:_1_0_:_1_3 _$



GRASS 5.0							  s.voronoi(1)
