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



NNAAMMEE
       ss..cceellllssttaattss   -	Univariate  statistics	for  a GRASS sites list within
       cells.
       _(_G_R_A_S_S _S_i_t_e_s _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       ss..cceellllssttaattss
       ss..cceellllssttaattss hheellpp
       ss..cceellllssttaattss [--qq]  iinnppuutt==_n_a_m_e  [[oouuttppuutt==_n_a_m_e]]  [[ffiieelldd==_v_a_l_u_e]]  [[mmiinn==_v_a_l_u_e]]
       [[ssttaattss==_s_t_a_t_[_,_s_t_a_t_,_._._._]]]

DDEESSCCRRIIPPTTIIOONN
       _s_._c_e_l_l_s_t_a_t_s  calculates	univariate  statistics of sites lists for each
       cluster of input sites falling within each cell of the current  region.
       This  includes  the  number of sites, mean, standard deviation, coeffi-
       cient of variation, mininum, first quartile,  median,  third  quartile,
       and maximum.  The output is a sites list where the coordinates are cell
       centers, the category is the count of sites falling  within  the  cell,
       and  the  decimal attributes are the statistics.  Sites falling outside
       the current region are discarded.

OOPPTTIIOONNSS
   FFllaaggss::
       --qq     Quiet. Turn off informational messages.


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of an existing sites file.

       oouuttppuutt==_n_a_m_e
	      Name of the output sites file.  If not  specified,  the  program
	      writes to standard output.

       ffiieelldd==_v_a_l_u_e
	      Decimal attribute to use for calculation

	      default: 1

       mmiinn==_v_a_l_u_e
	      Set  a  minimum  sample  size per cell.  If there are fewer than
	      _v_a_l_u_e sites found for a given cell, statistics  are  not	calcu-
	      lated for that cell.

	      default: 1

       ssttaattss==_s_t_a_t_[_,_s_t_a_t_,_._._._]
	      Specify which statistics should be reported.  Statistics will be
	      reported in the order specified, otherwise they  are  output  in
	      the order below.	The statistics are:

	      _m   - mean

	      _s   - standard deviation

	      _c_v  - coefficient of variation

	      _s_k_w - skewness

	      _k_u_r - kurtosis

	      _m_s_e - mean of squares

	      _m_a_v - mean of absolute values

	      _m_i_n - minimum

	      _q_1  - first quartile

	      _m_e_d - median

	      _q_3  - third quartile

	      _m_a_x - maximum

	      _s_u_m - sum

	      _n   - number of sites in the sample



SSEEEE AALLSSOO
       _s_._u_n_i_v_a_r, _s_._w_i_n_d_a_v_g, _s_._n_o_r_m_a_l, _r_._u_n_i_v_a_r

NNOOTTEESS
       Requires  at  least  16	bytes of memory per input site plus some other
       overhead.  Very large input sites files may cause excessive  swap  file
       usage or cause the program to fail with an out of memory error.


       Certain	statistics  are  invalid  when	calculated  for a single site.
       These statistics are the standard deviation, coefficient of  variation,
       skewness  and  kurtosis.   The  _m_i_n parameter may be used to insure the
       sample size is large enough to  approximate  normality.	 Additionally,
       the  cell  size	for the current region may be enlarged to capture more
       sites per cell.	No test for normality is performed on  the  input  and
       some statistics may not be valid if normality is violated.

BBUUGGSS
       None known.


       Please send all bug fixes and comments to the grass development team.

       http://grass.itc.it.

AAUUTTHHOORR
       Eric G. Miller, adapted from s.univar written by James Darrell McCauley
       , when he was at Agricultural Engineering, Purdue University

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_3_/_0_8_/_2_0 _1_3_:_2_9_:_1_4 _$



GRASS 5.0							s.cellstats(1)
