Geografic-Information-System/raster3d/r3.out.ascii/r3.out.ascii.html

<H2>DESCRIPTION</H2>

Outputs <I>G3D</I> maps in <I>ascii</I> format.  <I>map</I> is
a valid G3D map in the current mapset.  <I>output</I> is the name of
an ascii file which will be written in the current working directory.
If <I>output</I> is not specified then <B>stdout</B> is used.  The
<I>-h</I> flag may be used to suppress header information. The module is
sensitive to region settings (set with g.region).


<H2>NOTES</H2>
The default format for the ascii file is equivalent to that required
by <EM>r3.in.ascii</EM>.  In particular, files output by
<EM>r3.out.ascii</EM> with header information may be converted back to
G3D maps with <EM>r3.in.ascii</EM>.

<P>
The format for the ascii file is:
<pre>
north:   <i>floating point</i>
south:   <i>floating point</i>
east:    <i>floating point</i>
west:    <i>floating point</i>
top:     <i>floating point</i>
bottom:  <i>floating point</i>
rows:    <i>integer</i>
cols:    <i>integer</i>
levels:  <i>integer</i>
</pre>

The header is followed by cell values in <EM>floating point</EM> format.
Cell values are output as a series of horizontal slices in row-major
order.  That is, 

<pre>
  (x, y, z)       (x + 1, y, z)     ...     (x + cols, y, z)
(x, y + 1, z)   (x + 1, y + 1, z)   ...   (x + cols, y + 1, z)

  and so on

</pre>


<P>
One level maps can be imported with r.in.ascii (Raster 2D) after removing
the header lines "top", "bottom" and "levels".

<H2>SEE ALSO</H2>
<EM><A HREF="r3.in.ascii.html">r3.in.ascii</A></EM><br>
<EM><A HREF="g.region.html">g.region</A></EM><br>

<H2>AUTHORS</H2>
Roman Waupotitsch, Michael Shapiro, 
Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka

<p><i>Last changed: $Date$</i>