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



NNAAMMEE
       _s_._i_n_f_o  -  reports attribute, label, and other information
       about a sites file.

       (_G_R_A_S_S _S_i_t_e_s _P_r_o_g_r_a_m)


SSYYNNOOPPSSIISS
       ss..iinnffoo

       ss..iinnffoo hheellpp

       ss..iinnffoo [[--qqwwQQ]] ssiitteess=name


DDEESSCCRRIIPPTTIIOONN
       _s_._i_n_f_o reads the entire sites file and  reports	header	&
       label  information, type of category, number of attributes
       & dimensions, and min and max values for  each  dimension,
       attribute,  or  category.   For	best results sites should
       conform to the multiple attribute format as  specified  in
       GRASS5.0.



OOPPTTIIOONNSS
       This  program  can  be  run  non-interactively or interac-
       tively. The program will be run non-interactively; if  the
       user  spcifies  program arguments and flag settings on the
       command line using the form

       ss..iinnffoo [[--qqwwQQ]] ssiitteess=name

	Alternately, the user can type simply s.info on the  com-
       mand  line; in this case, the program will prompt the user
       for parameter  values  using  the  standard  GRASS  parser
       interface described in the manual entry for _p_a_r_s_e_r.

	FFllaaggss

	 --qq   Load quietly

       --ww   Only count sites in current window for min/max.

       --QQ   Show quartiles for decimal attributes

       PPaarraammeetteerrss

	ssiitteess _= _n_a_m_e

	Name of sites file.

       EExxaammppllee oouuttppuutt

       SITES FILENAME: r_analys
       --------------

       Header Information:
       ------------------
	       name	     r_analys
	       description   soil data from Germany
	       format	     |||%%%%%%%
	       labels					X|Y|Hori-
       zon|%pH%Kcal%Pcal%Corg%Ccarb%Nt%Trd

       Number of DIMENSIONS:	     3
       --------------------
			- - MIN - -	- - MAX - -
	       dim  1  4457986.000000  4459536.000000  X
	       dim  2  5372514.000000  5374314.000000  Y
	       dim  3	   0.000000	 120.000000    Horizon

       Type of CATEGORY information: NO CATEGORY
       ----------------------------

       Number of DOUBLE attributes:  7
       ---------------------------
			- - MIN - -	- - Q1 - -	- - MED -
       -     - - Q3 - -      - - MAX - -
	       dbl	 1		    0		      5.4
       6	     6.2	     7.7    pH
	       dbl	2		   0		    0.058
       0.1	     0.174	     1.212    Kcal
	       dbl	 3		    0		    0.009
       0.017	       0.044	       0.415	Pcal
	       dbl	4		   0		     0.18
       0.34	       1.09	      13.68    Corg
	       dbl	 5		    0			0
       0	       0	    3.82    Ccarb
	       dbl	6		   0		    0.031
       0.05	      0.117	      0.744    Nt
	       dbl	 7		 0.31		     1.45
       1.55		1.6	       1.89    Trd

       Number of STRING attributes:  0
       ---------------------------

       TOTAL SITES COUNTED: 2343




       SITES FILENAME: US.places
       --------------

       Header Information:
       ------------------
	       name	     US Places
	       description   names of  populated  places  in  the
       United States
	       format	     ||#@@@%%%%%
	       labels				     easting|nor-
       thing|#FIPS@place@state@place_type%population%house-
       holds%land_area%water_area%popu
       lation_density
	       time	     21 Jul 1995

       Number of DIMENSIONS:	     2
       --------------------
			- - MIN - -	- - MAX - -
	       dim  1	-124.610970	 -67.012039    easting
	       dim  2	  24.562840	  48.996136    northing

       Type of CATEGORY information: CELL_TYPE
       ----------------------------
			- - MIN - -	- - MAX - -
			     100124	    5686665    FIPS

       Number of DOUBLE attributes:  5
       ---------------------------
			- - MIN - -	- - Q1 - -	- - MED -
       -     - - Q3 - -      - - MAX - -
	       dbl	1		   0		      437
       1371	       4605	7.32256e+06    population
	       dbl	 2		    0		      190
       583	      1905     2.99217e+06    households
	       dbl	3		   5		     1659
       3973	      10396	1.96495e+06    land_area
	       dbl	 4		    0			0
       0	      76	  781914    water_area
	       dbl	5		   0		 0.191793
       0.393334 	  0.712237	      17.692	  popula-
       tion_density

       Number of STRING attributes:  3
       ---------------------------
			- MIN_LEN -	- MAX_LEN -
	       str  1	     3		    35	       place
	       str  2	     2		     2	       state
	       str  3	     3		     7	       place_type

       TOTAL SITES COUNTED: 22993
       ----------------------------------------------------------







BBUUGGSS
       If the --QQ flag is given, the sites are cached in order  to
       determine  quartile  values;  otherwise the sites are read
       sequentially without caching.  Therefore, use  of  the  --QQ
       option may result in an out-of-memory error for very large
       sites files. The algorithm used to  find  quartile  values
       matches	that  used by _s_._u_n_i_v_a_r, so if the number of sites
       is not evenly divisible by 4, the resulting Q1 and Q3 val-
       ues  may  not  exist in the data, but is an average of the
       two neighboring values. Likewise, if the number	of  sites
       is not evenly divisible by 2, the resulting median will be
       an average of its neighbors.


SSEEEE AALLSSOO
       d.sites, d.siter, d.sites.qual, s.univar


AAUUTTHHOORR
       Bill Brown, UI GMS Laboratory


       _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.info(1)
