← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to raster3d/r3.in.ascii/description.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
raster3d/r3.in.ascii/description.html
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>r3.in.ascii</em> allows a user to create a (binary) GRASS 3D raster map
4
 
layer from a 3D ASCII raster input file with (optional) TITLE.
5
 
 
6
 
<p>
7
 
Note that for compression the <em>none</em> option only specifies 
8
 
that neither LZW nor RLE is used for compression. It 
9
 
does not turn off the compression all together. 3D raster maps do
10
 
not support non-compressed files.
11
 
 
12
 
<p>
13
 
The <em>tiledimension</em> parameter defines the dimension of the tiles 
14
 
used in the output file. The format is: XxYxZ
15
 
 
16
 
<p>
17
 
The <em>nv</em> parameter specifies which value to convert to NULL-value.
18
 
If the specified value is <em>none</em>, no conversion is performed.
19
 
Default is <em>none</em>.
20
 
 
21
 
<h2>NOTES</h2>
22
 
 
23
 
The format of the 3D ASCII file:
24
 
<div class="code"><pre>
25
 
north: <em>floating point</em>
26
 
south: <em>floating point</em>
27
 
east: <em>floating point</em>
28
 
west: <em>floating point</em>
29
 
top: <em>floating point</em>
30
 
bottom: <em>floating point</em>
31
 
rows: <em>integer</em>
32
 
cols: <em>integer</em>
33
 
levels: <em>integer</em>
34
 
</pre></div>
35
 
This header is followed by the cell values in <em>floating point</em> format 
36
 
organized in rows with constant <em>col</em> and <em>level</em> coordinate.
37
 
The rows are organized by constant <em>level</em> coordinate. Individual cell
38
 
values are separated by <em>space</em> or <em>CR</em>.
39
 
<p>
40
 
NOTE: Currently, after the file has been imported, the stored values are 
41
 
compared with the original data. This feature is used to find bugs in the
42
 
library at an early stage and will be turned off as soon as confidence has
43
 
built up.
44
 
 
45
 
<h2>EXAMPLES</h2>
46
 
 
47
 
4x3x2 sample. Note, that lower-left (SW) corner of the bottom level comes first.
48
 
This array format, where EW is preserved but NS is flipped, is sometimes
49
 
known as "ij" coordinates.
50
 
This is opposite to <em>r.in.ascii</em>'s format, which places the SW corner
51
 
at the beginning of the last row of data.
52
 
 
53
 
<div class="code"><pre>
54
 
north: 3.0
55
 
south: 0.0
56
 
east: 4.0
57
 
west: 0.0
58
 
top: 2.0
59
 
bottom: 0.0
60
 
rows: 3
61
 
cols: 4
62
 
levels: 2
63
 
w(x1,y1,z1)  w(x2,y1,z1)  w(x3,y1,z1)  w(x4,y1,z1)
64
 
w(x1,y2,z1)  w(x2,y2,z1)  w(x3,y2,z1)  w(x4,y2,z1)
65
 
w(x1,y3,z1)  w(x2,y3,z1)  w(x3,y3,z1)  w(x4,y3,z1)
66
 
w(x1,y1,z2)  w(x2,y1,z2)  w(x3,y1,z2)  w(x4,y1,z2)
67
 
w(x1,y2,z2)  w(x2,y2,z2)  w(x3,y2,z2)  w(x4,y2,z2)
68
 
w(x1,y3,z2)  w(x2,y3,z2)  w(x3,y3,z2)  w(x4,y3,z2)
69
 
</pre></div>
70
 
 
71
 
<p>
72
 
Sample ASCII voxel map with one layer and several rows and columns (Spearfish area):
73
 
 
74
 
<div class="code"><pre>
75
 
north: 4925010.000000
76
 
south: 4924890.000000
77
 
east: 596760.000000
78
 
west: 596610.000000
79
 
top: 1.000000
80
 
bottom: 0.000000
81
 
rows: 4
82
 
cols: 5
83
 
levels: 1
84
 
1204.74 1204.48 1204.19 1203.81 1203.39
85
 
1203.89 1203.67 1203.34 1202.98 1202.43
86
 
1203.05 1202.80 1202.51 1202.11 1201.48
87
 
1202.10 1201.92 1201.62 1201.27 1200.68
88
 
</pre></div>
89
 
 
90
 
 
91
 
<h2>AUTHORS</h2>
92
 
Roman Waupotitsch, Michael Shapiro, 
93
 
Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka
94
 
 
95
 
<h2>SEE ALSO</h2>
96
 
 
97
 
<em>
98
 
<a href="r.in.ascii.html">r.in.ascii</a>,
99
 
<a href="r3.out.ascii.html">r3.out.ascii</a>,
100
 
<a href="v.to.rast3.html">v.to.rast3</a>
101
 
</em>
102
 
 
103
 
<p>
104
 
<i>Last changed: $Date: 2012-11-15 13:53:59 +0100 (Thu, 15 Nov 2012) $</i>