Scroll to navigation

r3.out.bin(1grass) GRASS GIS User's Manual r3.out.bin(1grass)


r3.out.bin - Exports a GRASS 3D raster map to a binary array.


raster3d, export, voxel


r3.out.bin --help
r3.out.bin [-rdi] input=name output=name [null=float] bytes=integer [order=string] [--overwrite] [--help] [--verbose] [--quiet] [--ui]


Switch the row order in output from north->south to south->north

Switch the depth order in output from bottom->top to top->bottom

Write data as integer

Allow output files to overwrite existing files

Print usage summary

Verbose module output

Quiet module output

Force launching GUI dialog


Name of input 3D raster map

Name for output file

Value to write out for null
Default: 0

Number of bytes per cell in binary file
Options: 1, 2, 4, 8

Output byte order
Options: big, little, native, swap
Default: native


The r3.out.bin program exports a GRASS 3D raster map to a binary array file. Optionally, output can be send to standard output (stdout) for direct input (pipe) into other applications. Data is exported according to the original GRASS 3D raster type (float, double).


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.

The region parameters are printed to stderr when setting the verbose flag. Export of little and big endian byte order is supported.

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


Have a look at the examples in



Sören Gebbert, based on r.out.bin from Bob Covill and Glynn Clements


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

Accessed: Thu May 12 20:53:58 2022

Main index | 3D raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2022 GRASS Development Team, GRASS GIS 8.2.0RC1 Reference Manual

GRASS 8.2.0RC1