r3.out.ascii(1)

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

KEYWORDS
raster3d, voxel

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

  Flags:

-h  Suppress printing of header information

-m  Use G3D mask (if exists) with input map

  Parameters:

input=string
    3dcell 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 G3D maps in ascii format. map is a valid G3D map in the current mapset. output is the name of an ascii file which will be written in the current working directory. If output is not specified then 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 G3D maps with r3.in.ascii.

The format for 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 (Raster 2D) 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: 2006/04/20 21:31:24 $

Full index