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



NNAAMMEE
       rr33..oouutt..aasscciiii - Outputs G3D maps in ASCII format.

       _(_G_R_A_S_S _3_D _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
	rr33..oouutt..aasscciiii  [[--hh]]  ggrriidd33==_n_a_m_e	[[oouuttppuutt==_n_a_m_e]]  [[ddpp==_v_a_l_u_e]]
       [[nnuullll==_n_a_m_e]]

DDEESSCCRRIIPPTTIIOONN
       Outputs _G_3_D maps in _a_s_c_i_i format.  _m_a_p is a valid G3D  map
       in  the	current  mapset.   _o_u_t_p_u_t is the name of an ascii
       file which will be written in the current  working  direc-
       tory.   If  _o_u_t_p_u_t  is  not specified then ssttddoouutt is used.
       The _-_h flag may be used to  suppress  header  information.
       The  module  is	sensitive  to  region  settings (set with
       g3.region).

   FFllaagg::
       --hh     Suppress printing of header information


   PPaarraammeetteerrss::
       ggrriidd33  G3d raster map to be converted to ascii

       oouuttppuutt Name for ascii output file

       ddpp     Number of decimal places for floats (options: 0-20)
	      Default: 8

       nnuullll   Char string to represent no data cell Default: *


NNOOTTEESS
       The  default  format  for  the ascii file is equivalent to
       that required by _r_3_._i_n_._a_s_c_i_i.  In particular, files output
       by  _r_3_._o_u_t_._a_s_c_i_i  with header information may be converted
       back to G3D maps with _r_3_._i_n_._a_s_c_i_i.


       The format for the ascii file is:

       north:  _f_l_o_a_t_i_n_g _p_o_i_n_t  south:	   _f_l_o_a_t_i_n_g  _p_o_i_n_t  east:
       _f_l_o_a_t_i_n_g _p_o_i_n_t west:	 _f_l_o_a_t_i_n_g _p_o_i_n_t top:	   _f_l_o_a_t_-
       _i_n_g _p_o_i_n_t bottom:     _f_l_o_a_t_i_n_g  _p_o_i_n_t  rows:	  _i_n_t_e_g_e_r
       cols:	   _i_n_t_e_g_e_r  levels:    _i_n_t_e_g_e_r The header is fol-
       lowed by cell values in _f_l_o_a_t_i_n_g _p_o_i_n_t format.  Cell  val-
       ues  are  output  as a series of horizontal slices in row-
       major order.  That is, (x, y, z)  (x + 1, y, z)	...  (x +
       cols,  y, z) (x, y + 1, z)  (x + 1, y + 1, z)  ...  and so
       on


       One level maps can be imported with r.in.ascii (Raster 2D)
       after  removing the header lines "top", "bottom" and "lev-
       els".

SSEEEE AALLSSOO
       _r_3_._i_n_._a_s_c_i_i

       _g_3_._r_e_g_i_o_n


AAUUTTHHOORRSS
       Roman Waupotitsch, Michael Shapiro, Helena Mitasova,  Bill
       Brown, Lubos Mitas, Jaro Hofierka

       _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					  r3.out.ascii(1)
