NAME

       r3.in.ascii  - Converts a 3D ASCII raster text file into a (binary) 3D raster map layer.

KEYWORDS

       raster3d, voxel, import

SYNOPSIS

       r3.in.ascii
       r3.in.ascii help
       r3.in.ascii   input=name  output=name   [nv=string]    [type=string]    [precision=string]
       [compression=string]   [tiledimension=XxYxZ]   [--overwrite]  [--verbose]  [--quiet]

   Flags:
       --overwrite
           Allow output files to overwrite existing files

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       input=name
           ASCII raster map to be imported

       output=name
           Name for output raster3d map

       nv=string
           String representing NULL value data cell (use 'none' if no such value)
           Default: *

       type=string
           Data type used in the output file
           Options: default,double,float
           Default: default

       precision=string
           Precision used in the output file (default, max, or 0 to 52)
           Default: default

       compression=string
           The compression method used in the output file
           Options: default,rle,none
           Default: default

       tiledimension=XxYxZ
           The dimensions of the tiles used in the output file
           Default: default

DESCRIPTION

       r3.in.ascii allows a user to create a (binary) GRASS 3D raster map layer from a  3D  ASCII
       raster input file with (optional) TITLE.

       Note  that for compression the none option only specifies that neither LZW nor RLE is used
       for compression. It does not turn off the compression all together. 3D raster maps do  not
       support non-compressed files.

       The  tiledimension  parameter  defines the dimension of the tiles used in the output file.
       The format is: XxYxZ

       The nv parameter specifies which value to convert to NULL-value.  If the  specified  value
       is none, no conversion is performed.  Default is none.

NOTES

       The format of the 3D ASCII file:
       north: floating point
       south: floating point
       east: floating point
       west: floating point
       top: floating point
       bottom: floating point
       rows: integer
       cols: integer
       levels: integer
         This  header  is  followed by the cell values in floating point format organized in rows
       with constant col and  level  coordinate.   The  rows  are  organized  by  constant  level
       coordinate. Individual cell values are separated by space or CR.

       NOTE: Currently, after the file has been imported, the stored values are compared with the
       original data. This feature is used to find bugs in the library at an early stage and will
       be turned off as soon as confidence has built up.

EXAMPLES

       4x3x2  sample.  Note,  that  lower-left (SW) corner of the bottom level comes first.  This
       array format, where EW is preserved  but  NS  is  flipped,  is  sometimes  known  as  "ij"
       coordinates.   This  is opposite to r.in.ascii's format, which places the SW corner at the
       beginning of the last row of data.
       north: 3.0
       south: 0.0
       east: 4.0
       west: 0.0
       top: 2.0
       bottom: 0.0
       rows: 3
       cols: 4
       levels: 2
       w(x1,y1,z1)  w(x2,y1,z1)  w(x3,y1,z1)  w(x4,y1,z1)
       w(x1,y2,z1)  w(x2,y2,z1)  w(x3,y2,z1)  w(x4,y2,z1)
       w(x1,y3,z1)  w(x2,y3,z1)  w(x3,y3,z1)  w(x4,y3,z1)
       w(x1,y1,z2)  w(x2,y1,z2)  w(x3,y1,z2)  w(x4,y1,z2)
       w(x1,y2,z2)  w(x2,y2,z2)  w(x3,y2,z2)  w(x4,y2,z2)
       w(x1,y3,z2)  w(x2,y3,z2)  w(x3,y3,z2)  w(x4,y3,z2)

       Sample ASCII voxel map with one layer and several rows and columns (Spearfish area):
       north: 4925010.000000
       south: 4924890.000000
       east: 596760.000000
       west: 596610.000000
       top: 1.000000
       bottom: 0.000000
       rows: 4
       cols: 5
       levels: 1
       1204.74 1204.48 1204.19 1203.81 1203.39
       1203.89 1203.67 1203.34 1202.98 1202.43
       1203.05 1202.80 1202.51 1202.11 1201.48
       1202.10 1201.92 1201.62 1201.27 1200.68

AUTHORS

       Roman Waupotitsch, Michael  Shapiro,  Helena  Mitasova,  Bill  Brown,  Lubos  Mitas,  Jaro
       Hofierka

SEE ALSO

        r.in.ascii, r3.out.ascii, v.to.rast3

       Last changed: $Date: 2012-11-15 04:53:59 -0800 (Thu, 15 Nov 2012) $

       Full index

       © 2003-2013 GRASS Development Team