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 useful 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  func-
       tion,  converting a UNIX file containing eastings, northings, and cate-
       gory 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 lim-
	      iting 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 easting, 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 interactively.  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 standard 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 programs; 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)
