s.out.ascii(1)	       Grass User's Manual	   s.out.ascii(1)



NNAAMMEE
       ss..oouutt..aasscciiii   -	Converts  a  GRASS site list file into an
       ASCII listing of site locations and their descriptions.
       _(_G_R_A_S_S _S_i_t_e_s _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       ss..oouutt..aasscciiii
       ss..oouutt..aasscciiii hheellpp
       ss..oouutt..aasscciiii [--aaddii] ssiitteess==_n_a_m_e [ffss==character|space|tab]

DDEESSCCRRIIPPTTIIOONN
       _s_._o_u_t_._a_s_c_i_i  converts   an   existing   site   list   file
       (ssiitteess==_n_a_m_e)  into  an ASCII listing of site locations and
       (optionally) their category labels, in a  format  suitable
       for  input  to  other  programs	(e.g.,	_d_._p_o_i_n_t_s, _m_._u_2_l_l,
       etc.).


       Each line of output consists of the easting, northing, and
       category  label for a site listed in the named ssiitteess file.
       The ffss==_n_a_m_e option (where _n_a_m_e is either  a  character,	a
       space,  or  a tab) can be used to place a particular field
       separator between these three output fields. This is  use-
       ful  when  output  is to be manipulated by other programs,
       like _a_w_k or _s_e_d.


       The GRASS program _s_._i_n_._a_s_c_i_i can be used  to  perform  the
       reverse	function, converting a UNIX file containing east-
       ings, northings, and category labels associated with  site
       locations into GRASS site list file format.

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

       --dd     Include  site descriptions (category labels) in the
	      output.

       --ii     Include site attribute identifiers in the output


   PPaarraammeetteerrss::
       ssiitteess==_n_a_m_e
	      Name of an existing site list file.

       ffss==character|space|tab
	      The field separator to be placed between the  east-
	      ing,  northing,  and (optionally) category label on
	      each line of output.  The field separator can be	a
	      character, a space, or a tab.
	      Default: space

       _s_._o_u_t_._a_s_c_i_i  can be run either non-interactively or inter-
       actively.  The program will be  run  non-interactively  if
       the  user specifies the name of an existing site list file
       and (optionally) a value for ffss, using the form


       ss..oouutt..aasscciiii [--aadd] ssiitteess==_n_a_m_e [ffss==character|space|tab]

       where _n_a_m_e is the name of an existing site list file to be
       converted  to  a  brief ASCII listing, and ffss is the field
       separator to be placed between output fields. The user can
       also  the  --aa and --dd options to use all sites in the named
       ssiitteess file and to include site descriptions in the output.


       Alternately,  the  user can simply type ss..oouutt..aasscciiii on the
       command line, without program arguments. In this case, the
       user will be prompted for parameter values using the stan-
       dard GRASS parser interface.

NNOOTTEESS
       To output GRASS data in x,y,z ASCII style, the s.out.ascii
       may be used:


       ss..oouutt..aasscciiii --dd ssiitteess==sitesmap

       Resulting to:

	    3566393.75 5773293.75 168.3
	    3566818.75 5773293.75 158.8
	    3568843.75 5773293.75 114.3
	    3568981.25 5773293.75 117.5
	    [...]

       To  export  raster maps into this x,y,z format, the raster
       map can be converted to sites format using _r_._t_o_._s_i_t_e_s  and
       _s_._o_u_t_._a_s_c_i_i subsequently as described above.


       The  output  from _s_._o_u_t_._a_s_c_i_i may be placed into a file by
       using the UNIX redirection mechanism; e.g.:


       ss..oouutt..aasscciiii ssiitteess==archsites > out.file

       _s_._o_u_t_._a_s_c_i_i output may also be redirected into other  pro-
       grams; e.g.:


       ss..oouutt..aasscciiii  ssiitteess==archsites  | d.points ccoolloorr==red ssiizzee==10
       ttyyppee==diamond


SSEEEE AALLSSOO
       _d_._p_o_i_n_t_s

       _d_._s_i_t_e_s

       _m_._l_l_2_u

       _m_._u_2_l_l

       _s_._i_n_._a_s_c_i_i

       _r_._t_o_._s_i_t_e_s

       _p_a_r_s_e_r

AAUUTTHHOORR
       Michael	Shapiro,  U.S.	Army   Construction   Engineering
       Research 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.out.ascii(1)
