1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
<h2>DESCRIPTION</h2>
<em>r3.in.ascii</em> allows a user to create a (binary) GRASS 3D raster map
layer from a 3D ASCII raster input file.
<p>The <em>tiledimension</em> parameter defines the dimension of the tiles
used in the output file. The format is: XxYxZ
<p>The <em>nv</em> parameter specifies which value to convert to NULL-value.
If the specified value is <em>none</em>, no conversion is performed.
Default is <em>none</em>.
<h2>NOTES</h2>
The data is automatically imported into the correct internal coordinate system,
that is visualized in the following picture, independently from the specified
ordering in the ASCII input file:
<center>
<img src="r3_volume_layout.png" border=0><br>
<table border=0 width=700>
<tr><td><center>
<i>The volume coordinate system and tile layout of the imported voxel map</i>
</center></td></tr>
</table>
</center>
<h2>NOTES</h2>
The format of the 3D ASCII file:
<div class="code"><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></div>
The version and order option have been introduced in GRASS 7 in 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 <em>r3.out.ascii</em>
manual page. The order of the data in the input file does not specifiy the
data order in the generated output 3D raster map which is in any case
<em>north -> south, west -> east, bottom -> top</em> order.
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 GRASS 6 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>.
<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.
<!-- TODO: beautify HTML -->
north: 3.0<br>
south: 0.0<br>
east: 4.0<br>
west: 0.0<br>
top: 2.0<br>
bottom: 0.0<br>
rows: 3<br>
cols: 4<br>
levels: 2<br>
w<sub>111</sub>x1,y1,z1 w<sub>211</sub>x2,y1,z1 w<sub>311</sub>x3,y1,z1 w<sub>411</sub>x4,y1,z1<br>
w<sub>121</sub>x1,y2,z1 w<sub>221</sub>x2,y2,z1 w<sub>321</sub>x3,y2,z1 w<sub>421</sub>x4,y2,z1<br>
w<sub>131</sub>x1,y3,z1 w<sub>231</sub>x2,y3,z1 w<sub>331</sub>x3,y3,z1 w<sub>431</sub>x4,y3,z1<br>
w<sub>112</sub>x1,y1,z2 w<sub>212</sub>x2,y1,z2 w<sub>312</sub>x3,y1,z2 w<sub>412</sub>x4,y1,z2<br>
w<sub>122</sub>x1,y2,z2 w<sub>222</sub>x2,y2,z2 w<sub>322</sub>x3,y2,z2 w<sub>422</sub>x4,y2,z2<br>
w<sub>132</sub>x1,y3,z2 w<sub>232</sub>x2,y3,z2 w<sub>332</sub>x3,y3,z2 w<sub>432</sub>x4,y3,z2<br>
<p>
Note that unit tests for <em>r3.in.ascii</em> are implemented in the
<em>test.r3.out.ascii.sh</em> script located in the
<em>r3.out.ascii</em> directory.
<h2>EXAMPLES</h2>
Please refer to the detailed examples in
<a href="r3.out.ascii.html">r3.out.ascii</a>.
<h2>AUTHORS</h2>
Roman Waupotitsch, Michael Shapiro,
Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka, Sören 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>,
<a href="g.region.html">g.region</a>
</em>
<p><i>Last changed: $Date: 2013-09-22 00:45:09 +0200 (Sun, 22 Sep 2013) $</i>
|