1r3.in.bin(1) GRASS GIS User's Manual r3.in.bin(1)
2
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 Flags:
20 -r
21 Switch the row order in output from north->south to south->north
22 -d
24 Switch the depth order in output from bottom->top to top->bottom
25 -i
27 Binary data is of type integer
28 -s
30 Signed data (two’s complement)
31 --overwrite
33 Allow output files to overwrite existing files
34 --help
36 Print usage summary
37 --verbose
39 Verbose module output
40 --quiet
42 Quiet module output
43 --ui
45 Force launching GUI dialog
46 Parameters:
48 input=name [required]
49 Name of binary 3D raster file to be imported
50 output=name [required]
52 Name for output 3D raster map
53 bytes=integer [required]
55 Number of bytes per cell in binary file
56 Options: 1, 2, 4, 8
57 order=string
59 Byte order in binary file
60 Options: big, little, native, swap
61 Default: native
62 north=float [required]
64 Northern limit of geographic region (outer edge)
65 south=float [required]
67 Southern limit of geographic region (outer edge)
68 east=float [required]
70 Eastern limit of geographic region (outer edge)
71 west=float [required]
73 Western limit of geographic region (outer edge)
74 bottom=float [required]
76 Bottom limit of geographic region (outer edge)
77 top=float [required]
79 Top limit of geographic region (outer edge)
80 rows=integer [required]
82 Number of rows
83 cols=integer [required]
85 Number of columns
86 depths=integer [required]
88 Number of depths
89 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 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 ma‐
100 trix 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 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 op‐
109 tions.
110 Import of little and big endian byte order as well as signed and un‐
112 signed integer data types is supported.
113
115 First we create a specific region and a 3D raster map that we will ex‐
116 port 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
133 Available at: r3.in.bin source code (history)
134 Accessed: Mon Jun 20 16:46:48 2022
136 Main index | 3D raster index | Topics index | Keywords index | Graphi‐
138 cal index | Full index
139 © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
141GRASS 8.2.0 r3.in.bin(1)