Scroll to navigation

r.out.bin(1grass) Grass User's Manual r.out.bin(1grass)

NAME

r.out.bin - Exports a GRASS raster map 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] [--verbose] [-- quiet]

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
--verbose
 
Verbose module output
--quiet
 
Quiet module output

Parameters:

input=string
 
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

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.

SEE ALSO

r.in.bin, r.in.ascii r.out.ascii r.in.arc, r.out.arc

AUTHOR

This program is derived from r.out.ascii with a few modifications.
 
Author: Bob Covill
Last changed: $Date: 2008-05-16 21:09:06 +0200 (Fri, 16 May 2008) $
Full index
© 2003-2014 GRASS Development Team
GRASS 6.4.4