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 dia-
       gram (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 limit-
	      ing 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 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=optLa-
       bel

       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 deci-
       mal type field of the site file as label.

	Alternately,  the  user  can  simply	type   s.voronoi  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_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0							  s.voronoi(1)
