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 12:09:06 -0700 (Fri, 16 May 2008) $

       Full index

       © 2003-2013 GRASS Development Team