1r3.in.bin(1) Grass User's Manual r3.in.bin(1)
2
3
4
6 r3.in.bin - Imports a binary raster file into a GRASS 3D raster map.
7
9 raster3d, import, voxel
10
12 r3.in.bin
13 r3.in.bin --help
14 r3.in.bin [-rdis] input=name output=name bytes=integer [order=string]
15 north=float south=float east=float west=float bottom=float top=float
16 rows=integer cols=integer depths=integer [null=float] [--overwrite]
17 [--help] [--verbose] [--quiet] [--ui]
18
19 Flags:
20 -r
21 Switch the row order in output from north->south to south->north
22
23 -d
24 Switch the depth order in output from bottom->top to top->bottom
25
26 -i
27 Binary data is of type integer
28
29 -s
30 Signed data (two’s complement)
31
32 --overwrite
33 Allow output files to overwrite existing files
34
35 --help
36 Print usage summary
37
38 --verbose
39 Verbose module output
40
41 --quiet
42 Quiet module output
43
44 --ui
45 Force launching GUI dialog
46
47 Parameters:
48 input=name [required]
49 Name of binary 3D raster file to be imported
50
51 output=name [required]
52 Name for output 3D raster map
53
54 bytes=integer [required]
55 Number of bytes per cell in binary file
56 Options: 1, 2, 4, 8
57
58 order=string
59 Byte order in binary file
60 Options: big, little, native, swap
61 Default: native
62
63 north=float [required]
64 Northern limit of geographic region (outer edge)
65
66 south=float [required]
67 Southern limit of geographic region (outer edge)
68
69 east=float [required]
70 Eastern limit of geographic region (outer edge)
71
72 west=float [required]
73 Western limit of geographic region (outer edge)
74
75 bottom=float [required]
76 Bottom limit of geographic region (outer edge)
77
78 top=float [required]
79 Top limit of geographic region (outer edge)
80
81 rows=integer [required]
82 Number of rows
83
84 cols=integer [required]
85 Number of columns
86
87 depths=integer [required]
88 Number of depths
89
90 null=float
91 Set Value to NULL
92
94 r3.in.bin allows a user to create a GRASS 3D raster map from a variety
95 of binary 3D raster data formats.
96
97 The top, bottom, north, south, east, and west field values entered are
98 the coordinates of the edges of the geographic region. The depths,
99 rows and cols field values entered describe the dimensions of the
100 matrix of data to follow. If the bytes field is entered incorrectly an
101 error will be generated suggesting a closer bytes value.
102
104 The write order of the rows (north->south to south->north) and the
105 write order of the depths (bottom->top to top->bottom) can be switched.
106
107 Have a look at r3.out.ascii to manual page that describes the internal
108 layout of the 3D raster maps and the supported row and depth switch
109 options.
110
111 Import of little and big endian byte order as well as signed and
112 unsigned integer data types is supported.
113
115 First we create a specific region and a 3D raster map that we will
116 export with r3.out.bin and import again.
117 g.region w=0 e=180 s=0 n=90 b=0 t=100 res3=10
118 r3.mapcalc expr="test_out_bin_float = float(if(row() == 2, null(), row()))"
119 r3.out.bin input=test_out_bin_float byte=4 null=-9999 \
120 output=test_out_bin_float_native_b4.bin order=native
121 r3.in.bin output=test_in_bin_float byte=4 null=-9999 \
122 input=test_out_bin_float_native_b4.bin order=native \
123 bottom=0 top=100 west=0 east=180 south=0 north=90 \
124 cols=18 rows=9 depths=10
125
127 r3.out.bin, r3.in.ascii, r3.out.ascii
128
130 Soren Gebbert, based on r.in.bin from Jacques Bouchard and Bob Covill
131
132 Last changed: $Date: 2018-06-16 10:49:17 +0200 (Sat, 16 Jun 2018) $
133
135 Available at: r3.in.bin source code (history)
136
137 Main index | 3D raster index | Topics index | Keywords index | Graphi‐
138 cal index | Full index
139
140 © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
141
142
143
144GRASS 7.4.4 r3.in.bin(1)