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 cur-
       rent mapset.  _o_u_t_p_u_t is the name of an ascii file which will be written
       in the current working directory.  If _o_u_t_p_u_t is not specified then ssttdd--
       oouutt 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 followed by cell values in _f_l_o_a_t_i_n_g _p_o_i_n_t	format.   Cell
       values  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 remov-
       ing the header lines "top", "bottom" and "levels".

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)
