.TH r.out.ascii 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBr.out.ascii\fR\fR  - Converts a raster map layer into an ASCII text file.
.SH KEYWORDS
raster, export
.SH SYNOPSIS
\fBr.out.ascii\fR
.br
\fBr.out.ascii help\fR
.br
\fBr.out.ascii\fR [\-\fBhsmi\fR] \fBinput\fR=\fIstring\fR  [\fBoutput\fR=\fIstring\fR]   [\fBdp\fR=\fIinteger\fR]   [\fBwidth\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\-s\fR" 4m
.br
Write SURFER (Golden Software) ASCII grid
.IP "\fB\-m\fR" 4m
.br
Write MODFLOW (USGS) ASCII array
.IP "\fB\-i\fR" 4m
.br
Force output of integer values
.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
Name of an existing raster map
.IP "\fBoutput\fR=\fIstring\fR" 4m
.br
Name for output ASCII grid map (use out=- for stdout)
.IP "\fBdp\fR=\fIinteger\fR" 4m
.br
Number of significant digits (floating point only)
.IP "\fBwidth\fR=\fIinteger\fR" 4m
.br
Number of values printed before wrapping a line (only SURFER or MODFLOW format)
.IP "\fBnull\fR=\fIstring\fR" 4m
.br
String to represent null cell (GRASS grid only)
.br
Default: \fI*\fR
.PP
.SH DESCRIPTION
\fIr.out.ascii\fR converts a user-specified raster map layer
(\fBinput=\fR\fIname\fR) into an ASCII grid in a text file
(\fBoutput=\fR\fIname\fR) suitable for export to
other computer systems.
.PP
The GRASS program \fIr.in.ascii\fR can be
used to perform the reverse function, converting an ASCII file in suitable
format to GRASS raster map format.
.PP
.PP
To write a SURFER .grd ASCII GRID file (with reverted row order and different
header) use the \fI-s\fR flag:
\fC
.DS
.br
r.out.ascii \-s input=inname output=outname.grd [dp=value]
.br
.DE
\fR
NULL data are coded to "1.70141e+038" for SURFER ASCII GRID files (ignoring
the \fInull=\fR parameter).
.SH NOTES
The output from \fIr.out.ascii\fR may be placed into a file by using the
UNIX redirection mechanism; e.g.:
\fC
.DS
.br
r.out.ascii input=soils output=- > out.file
.br
.DE
\fR
The output file out.file can then be printed or copied onto a CDROM
or floppy disk for export purposes.
.PP
To export the raster values as x,y,z values of cell centers (one per line)
use the \fIr.out.xyz\fR module.
.SH SEE ALSO
\fI
r.in.ascii,
r.in.arc,
r.out.bin,
r.out.gdal,
r.out.xyz
\fR
.SH AUTHOR
Michael Shapiro,
U.S. Army Construction Engineering Research Laboratory
.PP
Surfer support by Markus Neteler
.PP
\fILast changed: $Date: 2008-05-16 21:09:06 +0200 (Fri, 16 May 2008) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team