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 22:13:36 +0200 (Tue, 13 Sep 2011) $ Full index © 2003-2014 GRASS Development Team