trusty (1) r3.out.ascii.1grass.gz

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