.TH r3.out.ascii 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBr3.out.ascii\fR\fR  - Converts a 3D raster map layer into an ASCII text file.
.SH KEYWORDS
raster3d, voxel, export
.SH SYNOPSIS
\fBr3.out.ascii\fR
.br
\fBr3.out.ascii help\fR
.br
\fBr3.out.ascii\fR [\-\fBhm\fR] \fBinput\fR=\fIstring\fR  [\fBoutput\fR=\fIstring\fR]   [\fBdp\fR=\fIinteger\fR]   [\fBnull\fR=\fIstring\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-h\fR" 4m
.br
Suppress printing of header information
.IP "\fB\-m\fR" 4m
.br
Use 3D raster mask (if exists) with input map
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBinput\fR=\fIstring\fR" 4m
.br
3D raster map to be converted to ASCII
.IP "\fBoutput\fR=\fIstring\fR" 4m
.br
Name for ASCII output file
.IP "\fBdp\fR=\fIinteger\fR" 4m
.br
Number of decimal places for floats
.br
Options: \fI0-20\fR
.br
Default: \fI8\fR
.IP "\fBnull\fR=\fIstring\fR" 4m
.br
Char string to represent no data cell
.br
Default: \fI*\fR
.PP
.SH DESCRIPTION
Outputs 3D raster maps in ASCII format. The \fImap\fR parameter is
a valid 3D raster map in the current mapset search path. The \fIoutput\fR 
parameter is the name of an ASCII file which will be written in the 
current working directory.
.PP
If \fIoutput\fR is not specified then standard output (stdout) is used.
The \fI-h\fR flag may be used to suppress header information. The
module is sensitive to region settings (set with \fIg.region\fR).
.SH NOTES
The default format for the ASCII file is equivalent to that required
by \fIr3.in.ascii\fR. In particular, files output by
\fIr3.out.ascii\fR with header information may be converted back to
3D raster maps with \fIr3.in.ascii\fR.
.PP
The format of the ASCII file is:
\fC
.DS
.br
north:   \fIfloating point\fR
.br
south:   \fIfloating point\fR
.br
east:    \fIfloating point\fR
.br
west:    \fIfloating point\fR
.br
top:     \fIfloating point\fR
.br
bottom:  \fIfloating point\fR
.br
rows:    \fIinteger\fR
.br
cols:    \fIinteger\fR
.br
levels:  \fIinteger\fR
.br
.DE
\fR
The header is followed by cell values in \fIfloating point\fR format.
Cell values are output as a series of horizontal slices in row-major
order.  That is, 
\fC
.DS
.br
  (x, y, z)       (x + 1, y, z)     ...     (x + cols, y, z)
.br
(x, y + 1, z)   (x + 1, y + 1, z)   ...   (x + cols, y + 1, z)
.br
.br
and so on.
.br
.DE
\fR
.PP
One level maps can be imported with \fIr.in.ascii\fR (2D raster) after removing
the header lines "top", "bottom" and "levels".
.SH SEE ALSO
\fI
r3.in.ascii,
g.region
\fR
.SH AUTHORS
Roman Waupotitsch, Michael Shapiro, 
Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka
.PP
\fILast changed: $Date: 2011-09-13 22:13:36 +0200 (Tue, 13 Sep 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team