r3.in.bin(1grass)

Usage

r3.in.bin

r3.in.bin --help

r3.in.bin [-rdis] input=name output=name bytes=integer [order=string] north=float south=float east=float west=float bottom=float top=float rows=integer cols=integer depths=integer [null=float] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Keywords

raster3d, import, voxel

Overview

r3.in.bin allows a user to create a GRASS 3D raster map from a variety of binary 3D raster data formats.

The top, bottom, north, south, east, and west field values entered are the coordinates of the edges of the geographic region. The depths, rows and cols field values entered describe the dimensions of the matrix of data to follow. If the bytes field is entered incorrectly an error will be generated suggesting a closer bytes value.

Notes

The write order of the rows (north->south to south->north) and the write order of the depths (bottom->top to top->bottom) can be switched.

Have a look at r3.out.ascii to manual page that describes the internal layout of the 3D raster maps and the supported row and depth switch options.

Import of little and big endian byte order as well as signed and unsigned integer data types is supported.

Examples

First we create a specific region and a 3D raster map that we will export with r3.out.bin and import again.

g.region w=0 e=180 s=0 n=90 b=0 t=100 res3=10
r3.mapcalc expr="test_out_bin_float = float(if(row() == 2, null(), row()))"
r3.out.bin input=test_out_bin_float byte=4 null=-9999 \
    output=test_out_bin_float_native_b4.bin order=native
r3.in.bin output=test_in_bin_float byte=4 null=-9999 \
    input=test_out_bin_float_native_b4.bin order=native \
    bottom=0 top=100 west=0 east=180 south=0 north=90 \
    cols=18 rows=9 depths=10

Source code

Available at: r3.in.bin source code (history)

Accessed: Monday Feb 24 17:51:06 2025

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

9
10
11
12
13