NAME

       r3.in.bin  - Imports a binary raster file into a GRASS 3D raster map.

KEYWORDS

       raster3d, import, voxel

SYNOPSIS

       r3.in.bin
       r3.in.bin --help
       r3.in.bin   [-rdis]  input=name  output=name  bytes=integer   [order=string]   north=float
       south=float  east=float  west=float  bottom=float  top=float   rows=integer   cols=integer
       depths=integer  [null=float]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

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

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

       -i
           Binary data is of type integer

       -s
           Signed data (two’s complement)

       --overwrite
           Allow output files to overwrite existing files

       --help
           Print usage summary

       --verbose
           Verbose module output

       --quiet
           Quiet module output

       --ui
           Force launching GUI dialog

   Parameters:
       input=name [required]
           Name of binary 3D raster file to be imported

       output=name [required]
           Name for output 3D raster map

       bytes=integer [required]
           Number of bytes per cell in binary file
           Options: 1, 2, 4, 8

       order=string
           Byte order in binary file
           Options: big, little, native, swap
           Default: native

       north=float [required]
           Northern limit of geographic region (outer edge)

       south=float [required]
           Southern limit of geographic region (outer edge)

       east=float [required]
           Eastern limit of geographic region (outer edge)

       west=float [required]
           Western limit of geographic region (outer edge)

       bottom=float [required]
           Bottom limit of geographic region (outer edge)

       top=float [required]
           Top limit of geographic region (outer edge)

       rows=integer [required]
           Number of rows

       cols=integer [required]
           Number of columns

       depths=integer [required]
           Number of depths

       null=float
           Set Value to NULL

DESCRIPTION

       r3.in.bin allows a user to create a GRASS 3D raster map from a variety of binary 3D raster
       data formats.

       The top, bottom, north, south, east, and west field values entered are the coordinates  of
       the  edges  of  the  geographic  region.   The  depths, rows and cols field values entered
       describe the dimensions of the matrix of data to follow.  If the bytes  field  is  entered
       incorrectly an error will be generated suggesting a closer bytes value.

NOTES

       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.

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

       Import  of  little  and  big endian byte order as well as signed and unsigned integer data
       types is supported.

Example

       First we create a specific region and a 3D raster map that we will export with  r3.out.bin
       and import again.
       g.region w=0 e=180 s=0 n=90 b=0 t=100 res3=10
       r3.mapcalc expr="test_out_bin_float = float(if(row() == 2, null(), row()))"
       r3.out.bin input=test_out_bin_float byte=4 null=-9999 \
           output=test_out_bin_float_native_b4.bin order=native
       r3.in.bin output=test_in_bin_float byte=4 null=-9999 \
           input=test_out_bin_float_native_b4.bin order=native \
           bottom=0 top=100 west=0 east=180 south=0 north=90 \
           cols=18 rows=9 depths=10

SEE ALSO

        r3.out.bin, r3.in.ascii, r3.out.ascii

AUTHORS

       Soren Gebbert, based on r.in.bin from Jacques Bouchard and Bob Covill

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

       © 2003-2016 GRASS Development Team, GRASS GIS 7.0.3 Reference Manual