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

<H2>DESCRIPTION</H2>
Convert a 3D ASCII raster text file into a (binary) 3D raster map layer. 

<H3>Parameters:</H3>
<DL>
<DT><B>type</B>
<DD>Data type used in the output file
<DD>Options: default, double, float

<DT><B>precision</B>
<DD>Precision used in the output file
<DD>Options: default, max, 0-52

<DT><B>compression</B>
<DD>Note that the <EM>none</EM> option only specifies 
that neither LZW nor RLE is used for compression.  It 
does not turn off the compression all together.  G3D does
not support non-compressed files.
<DD>Options: default, rle, none

<DT><B>tiledimension</B>
<DD>The dimension of the tiles used in the output file.  The format is: XxYxZ

<DT><B>nv</B>
<DD>Specifies which value to convert to NULL-value.  If the specified value is 
<em>none</em>, no conversion is performed.  Default is <em>*</em>.

<DT><B>input</B>
<DD>Path and name of ASCII file to be imported

<DT><B>output</B>
<DD>Name of the G3D output map
</DL>

<H2>NOTES</H2>
The format for the ascii file is:
<pre>
version: <i>"grass7"</i>
order:   <i>"nsbt" or "nstb" or "snbt" or "sntb"</i>
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 version and order option are introduced in grass7 June 2011. The version option 
is self explaining. The order option specifies the row and depth order of the data in the input file.
The supported row/depth ordering is documented in the <A HREF="r3.out.ascii.html">r3.out.ascii</A> 
manpage. The order of the data in the input file does not specifiy the data order in the 
generated output raster3d map which is in any case <em>north -> south, west -> east, bottom -> top</em> ordering. 
So dependent on the order information the data is automatically imported into the correct internal coordinate system.
<P>
The version and order options are not mandatory. In case no version and order option is specified, 
the default grass6 ascii format is assumed.
<P>
This header is followed by the cell values in <EM>floating point</EM> format 
organized in rows with constant <EM>col</EM> and <EM>level</EM> coordinate.
The rows are organized by constant <EM>level</EM> coordinate. Individual cell
values are separated by <EM>space</EM> or <EM>CR</EM>.
<P>

<H2>EXAMPLES</H2>

4x3x2 sample. Note in case no specific ordering is specified in the input file the
upper-left (NW) corner of the bottom level comes first. The according order option is: nsbt for
north -> south, bottom -> top ordering. This is identical with <em>r.in.ascii</em>
for single level data. So the y coordinate is 0 at the northern edge.

<div class="code"><pre>
north: 3.0
south: 0.0
east: 4.0
west: 0.0
top: 2.0
bottom: 0.0
rows: 3
cols: 4
levels: 2
x1,y1,z1  x2,y1,z1  x3,y1,z1  x4,y1,z1
x1,y2,z1  x2,y2,z1  x3,y2,z1  x4,y2,z1
x1,y3,z1  x2,y3,z1  x3,y3,z1  x4,y3,z1
x1,y1,z2  x2,y1,z2  x3,y1,z2  x4,y1,z2
x1,y2,z2  x2,y2,z2  x3,y2,z2  x4,y2,z2
x1,y3,z2  x2,y3,z2  x3,y3,z2  x4,y3,z2
</pre></div>

Note that unit tests for r3.in.ascii are implemented in the <em>test.r3.out.ascii.sh</em> script located in 
the r3.out.ascii directory.

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

<H2>SEE ALSO</H2>
<EM>
<A HREF="r.in.ascii.html">r.in.ascii</A>,
<A HREF="r3.out.ascii.html">r3.out.ascii</A>,
<A HREF="v.to.rast3.html">v.to.rast3</A>
</EM>

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