NAME

       r3.out.ascii  - Converts a 3D raster map layer into an ASCII text file.

KEYWORDS

       raster3d, voxel, export

SYNOPSIS

       r3.out.ascii
       r3.out.ascii help
       r3.out.ascii    [-hm]   input=string    [output=string]     [dp=integer]     [null=string]
       [--verbose]  [--quiet]

   Flags:
       -h
           Suppress printing of header information

       -m
           Use 3D raster mask (if exists) with input map

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       input=string
           3D raster map to be converted to ASCII

       output=string
           Name for ASCII output file

       dp=integer
           Number of decimal places for floats
           Options: 0-20
           Default: 8

       null=string
           Char string to represent no data cell
           Default: *

DESCRIPTION

       Outputs 3D raster maps in ASCII format. The map parameter is a valid 3D raster map in  the
       current  mapset  search path. The output parameter is the name of an ASCII file which will
       be written in the current working directory.

       If output is not specified then standard output (stdout) is used.  The -h flag may be used
       to  suppress  header  information.  The  module  is sensitive to region settings (set with
       g.region).

NOTES

       The default format for the ASCII file is equivalent to that required  by  r3.in.ascii.  In
       particular,  files output by r3.out.ascii with header information may be converted back to
       3D raster maps with r3.in.ascii.

       The format of the ASCII file is:
       north:   floating point
       south:   floating point
       east:    floating point
       west:    floating point
       top:     floating point
       bottom:  floating point
       rows:    integer
       cols:    integer
       levels:  integer
        The header is followed by cell values in floating point format.  Cell values  are  output
       as a series of horizontal slices in row-major order.  That is,
         (x, y, z)       (x + 1, y, z)     ...     (x + cols, y, z)
       (x, y + 1, z)   (x + 1, y + 1, z)   ...   (x + cols, y + 1, z)
       and so on.

       One level maps can be imported with r.in.ascii (2D raster) after removing the header lines
       "top", "bottom" and "levels".

SEE ALSO

        r3.in.ascii, g.region

AUTHORS

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

       Last changed: $Date: 2011-09-13 13:13:36 -0700 (Tue, 13 Sep 2011) $

       Full index

       © 2003-2013 GRASS Development Team