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
11

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

EXAMPLE

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

AUTHORS

113       Roman Waupotitsch, Michael Shapiro, Helena Mitasova, Bill Brown,  Lubos
114       Mitas, Jaro Hofierka
115