1r3.in.ascii(1) Grass User's Manual r3.in.ascii(1)
2
3
4
6 r3.in.ascii - Convert a 3D ASCII raster text file into a (binary) 3D
7 raster map layer
8
10 raster3d, voxel
11
13 r3.in.ascii
14 r3.in.ascii help
15 r3.in.ascii input=string output=string [nv=string] [type=string]
16 [precision=string] [compression=string] [tiledimension=string]
17
18 Parameters:
19 input=string
20 Ascii raster file to be imported
21
22 output=string
23 Name for G3d raster map
24
25 nv=string
26 String representing NULL value data cell (use 'none' if no such
27 value) Default: none
28
29 type=string
30 Data type used in the output file Options: default,double,float
31 Default: default
32
33 precision=string
34 Precision used in the output file (default, max, or 0 to 52)
35 Default: default
36
37 compression=string
38 The compression method used in the output file Options:
39 default,rle,none Default: default
40
41 tiledimension=string
42 The dimension of the tiles used in the output file Default: default
43
45 Convert a 3D ASCII raster text file into a (binary) 3D raster map
46 layer.
47
48 Parameters:
49 type Data type used in the output file Options: default, double,
50 float
51
52 precision
53 Precision used in the output file Options: default, max, 0-52
54
55 compression
56 Note that the none option only specifies that neither LZW nor
57 RLE is used for compression. It does not turn off the compres‐
58 sion all together. G3D does not support non-compressed files.
59 Options: default, rle, none
60
61 tiledimension
62 The dimension of the tiles used in the output file. The format
63 is: XxYxZ
64
65 nv Specifies which value to convert to NULL-value. If the speci‐
66 fied value is none, no conversion is performed. Default is
67 none.
68
69 input Path and name of ASCII file to be imported
70
71 output Name of the G3D output map
72
74 The format for the ASCII file:
75 north: floating point
76 south: floating point
77 east: floating point
78 west: floating point
79 top: floating point
80 bottom: floating point
81 rows: integer
82 cols: integer
83 levels: integer
84 This header is followed by the cell values in floating point format
85 organized in rows with constant col and level coordinate. The rows are
86 organized by constant level coordinate. Individual cell values are sep‐
87 arated by space or CR.
88
89 NOTE: Currently, after the file has been imported, the stored values
90 are compared with the original data. This feature is used to find bugs
91 in the library at an early stage and will be turned off as soon as con‐
92 fidence has built up.
93
95 Sample ASCII voxel map with one layer and several rows and columns
96 (Spearfish area):
97 north: 4925010.000000
98 south: 4924890.000000
99 east: 596760.000000
100 west: 596610.000000
101 top: 1.000000
102 bottom: 0.000000
103 rows: 4
104 cols: 5
105 levels: 1
106 1204.74 1204.48 1204.19 1203.81 1203.39
107 1203.89 1203.67 1203.34 1202.98 1202.43
108 1203.05 1202.80 1202.51 1202.11 1201.48
109 1202.10 1201.92 1201.62 1201.27 1200.68
110
111
113 Roman Waupotitsch, Michael Shapiro, Helena Mitasova, Bill Brown, Lubos
114 Mitas, Jaro Hofierka
115
117 r3.out.ascii, v.to.rast3
118
119 Last changed: $Date: 2006/10/04 07:54:03 $
120
121 Full index
122
123
124
125GRASS 6.2.2 r3.in.ascii(1)