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