GRASS GIS manual: r.out.bin

Note: A new GRASS GIS stable version has been released: GRASS GIS 7.6, available here.
Updated manual page: here

NAME

r.out.bin - Exports a GRASS raster to a binary array.

KEYWORDS

raster, export

SYNOPSIS

r.out.bin

r.out.bin --help

r.out.bin [-ifhbs] input=string [output=string] [null=float] [bytes=integer] [order=string] [--help] [--verbose] [--quiet] [--ui]

Flags:

-i: Generate integer output
-f: Generate floating-point output
-h: Export array with GMT compatible header
-b: Generate BIL world and header files
-s: Byte swap output
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

input=string [required]: Name of input raster map
output=string: Name for output binary map (use output=- for stdout)
null=float: Value to write out for null; Default: 0
bytes=integer: Number of bytes per cell; Options: 1, 2, 4, 8
order=string: Output byte order; Options: big, little, native, swap; Default: native

DESCRIPTION
NOTES
SEE ALSO
AUTHOR

DESCRIPTION

The r.out.bin program exports a GRASS raster map to a binary array file. Optionally, output can be sent to standard output (stdout) for direct input (pipe) into other applications. Data is exported according to the original GRASS raster type (e.g. float). If the "-i" flag is specified, an integer array is output. The region parameters are printed to stderr.

NOTES

With the -h flag, data can be directly used by GMT as Grid Format 1 (float) or 2 (short). For example:

r.out.bin -h input=grass.raster output=new.grd
grdinfo new.grd=1 (if float)

Exported data can be piped directly into the GMT program xyz2grd.

r.out.bin input=grass.raster output=- | xyz2grd -R....  -ZTLf -

The example uses the GMT program xyz2grd with the -ZTLf flag indicating that a float array was output.

AUTHOR

This program is derived from r.out.ascii with a few modifications.
Author: Bob Covill

Last changed: $Date: 2014-11-01 12:57:37 -0700 (Sat, 01 Nov 2014) $

SOURCE CODE

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