r3.in.ascii(1)

1r3.in.ascii(1)                Grass User's Manual               r3.in.ascii(1)
2
3
4

NAME

6       r3.in.ascii   -  Convert a 3D ASCII raster text file into a (binary) 3D
7       raster map layer
8

KEYWORDS

10       raster3d, voxel, import
11

SYNOPSIS

13       r3.in.ascii
14       r3.in.ascii help
15       r3.in.ascii input=name output=name  [nv=string]   [type=string]   [pre‐
16       cision=string]        [compression=string]        [tiledimension=XxYxZ]
17       [--overwrite]  [--verbose]  [--quiet]
18
19   Flags:
20       --overwrite
21           Allow output files to overwrite existing files
22
23       --verbose
24           Verbose module output
25
26       --quiet
27           Quiet module output
28
29   Parameters:
30       input=name
31           Ascii raster map to be imported
32
33       output=name
34           Name for output raster3d map
35
36       nv=string
37           String representing NULL value data cell (use  'none'  if  no  such
38           value)
39           Default: none
40
41       type=string
42           Data type used in the output file
43           Options: default,double,float
44           Default: default
45
46       precision=string
47           Precision used in the output file (default, max, or 0 to 52)
48           Default: default
49
50       compression=string
51           The compression method used in the output file
52           Options: default,rle,none
53           Default: default
54
55       tiledimension=XxYxZ
56           The dimensions of the tiles used in the output file
57           Default: default
58

DESCRIPTION

60       Convert  a  3D  ASCII  raster  text  file into a (binary) 3D raster map
61       layer.
62
63   Parameters:
64       type
65              Data type used in the output file
66              Options: default, double, float
67
68       precision
69              Precision used in the output file
70              Options: default, max, 0-52
71
72       compression
73              Note that the none option only specifies that  neither  LZW  nor
74              RLE  is used for compression.  It does not turn off the compres‐
75              sion all together.  G3D does not support non-compressed files.
76              Options: default, rle, none
77
78       tiledimension
79              The dimension of the tiles used in the output file.  The  format
80              is: XxYxZ
81
82       nv
83              Specifies  which  value to convert to NULL-value.  If the speci‐
84              fied value is none, no  conversion  is  performed.   Default  is
85              none.
86
87       input
88              Path and name of ASCII file to be imported
89
90       output
91              Name of the G3D output map
92

NOTES

94       The format for the ASCII file:
95       north: floating point
96       south: floating point
97       east: floating point
98       west: floating point
99       top: floating point
100       bottom: floating point
101       rows: integer
102       cols: integer
103       levels: integer
104         This  header  is followed by the cell values in floating point format
105       organized in rows with constant col and level coordinate.  The rows are
106       organized by constant level coordinate. Individual cell values are sep‐
107       arated by space or CR.
108
109       NOTE: Currently, after the file has been imported,  the  stored  values
110       are  compared with the original data. This feature is used to find bugs
111       in the library at an early stage and will be turned off as soon as con‐
112       fidence has built up.
113

EXAMPLES

115       4x3x2  sample.  Note  lower-left  (SW) corner of the bottom level comes
116       first!  This array format, where EW is preserved but NS is flipped,  is
117       sometimes  known as "ij" coordinates.  This is opposite to r.in.ascii's
118       format, which places the SW corner at the beginning of the last row  of
119       data.
120       north: 3.0
121       south: 0.0
122       east: 4.0
123       west: 0.0
124       top: 2.0
125       bottom: 0.0
126       rows: 3
127       cols: 4
128       levels: 2
129       x1,y1,z1  x2,y1,z1  x3,y1,z1  x4,y1,z1
130       x1,y2,z1  x2,y2,z1  x3,y2,z1  x4,y2,z1
131       x1,y3,z1  x2,y3,z1  x3,y3,z1  x4,y3,z1
132       x1,y1,z2  x2,y1,z2  x3,y1,z2  x4,y1,z2
133       x1,y2,z2  x2,y2,z2  x3,y2,z2  x4,y2,z2
134       x1,y3,z2  x2,y3,z2  x3,y3,z2  x4,y3,z2
135
136
137       Sample  ASCII  voxel  map  with  one layer and several rows and columns
138       (Spearfish area):
139       north: 4925010.000000
140       south: 4924890.000000
141       east: 596760.000000
142       west: 596610.000000
143       top: 1.000000
144       bottom: 0.000000
145       rows: 4
146       cols: 5
147       levels: 1
148       1204.74 1204.48 1204.19 1203.81 1203.39
149       1203.89 1203.67 1203.34 1202.98 1202.43
150       1203.05 1202.80 1202.51 1202.11 1201.48
151       1202.10 1201.92 1201.62 1201.27 1200.68
152
153

AUTHORS

155       Roman Waupotitsch, Michael Shapiro, Helena Mitasova, Bill Brown,  Lubos
156       Mitas, Jaro Hofierka
157