<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: r.out.ascii</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <link rel="stylesheet" href="grassdocs.css" type="text/css"> </head> <body bgcolor="white"> <img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade> <h2>NAME</h2> <em><b>r.out.ascii</b></em> - Converts a raster map layer into an ASCII text file. <h2>KEYWORDS</h2> raster, export <h2>SYNOPSIS</h2> <b>r.out.ascii</b><br> <b>r.out.ascii help</b><br> <b>r.out.ascii</b> [-<b>hsmi</b>] <b>input</b>=<em>string</em> [<b>output</b>=<em>string</em>] [<b>dp</b>=<em>integer</em>] [<b>width</b>=<em>integer</em>] [<b>null</b>=<em>string</em>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>-h</b></DT> <DD>Suppress printing of header information</DD> <DT><b>-s</b></DT> <DD>Write SURFER (Golden Software) ASCII grid</DD> <DT><b>-m</b></DT> <DD>Write MODFLOW (USGS) ASCII array</DD> <DT><b>-i</b></DT> <DD>Force output of integer values</DD> <DT><b>--verbose</b></DT> <DD>Verbose module output</DD> <DT><b>--quiet</b></DT> <DD>Quiet module output</DD> </DL> <h3>Parameters:</h3> <DL> <DT><b>input</b>=<em>string</em></DT> <DD>Name of an existing raster map</DD> <DT><b>output</b>=<em>string</em></DT> <DD>Name for output ASCII grid map (use out=- for stdout)</DD> <DT><b>dp</b>=<em>integer</em></DT> <DD>Number of significant digits (floating point only)</DD> <DT><b>width</b>=<em>integer</em></DT> <DD>Number of values printed before wrapping a line (only SURFER or MODFLOW format)</DD> <DT><b>null</b>=<em>string</em></DT> <DD>String to represent null cell (GRASS grid only)</DD> <DD>Default: <em>*</em></DD> </DL> <H2>DESCRIPTION</H2> <EM>r.out.ascii</EM> converts a user-specified raster map layer (<B>input=</B><EM>name</EM>) into an ASCII grid in a text file (<B>output=</B><EM>name</EM>) suitable for export to other computer systems. <P> The GRASS program <EM><A HREF="r.in.ascii.html">r.in.ascii</A></EM> can be used to perform the reverse function, converting an ASCII file in suitable format to GRASS raster map format. <P> <!--With <B>-s</B> flag SURFER .grd ASCII GRID instead of GRASS ASCII GRID is written (with reverted row order, different header). <P> With <B>-m</B> flag MODFLOW (USGS) free-format array instead of GRASS ASCII GRID is written.--> <P> To write a SURFER .grd ASCII GRID file (with reverted row order and different header) use the <em>-s</em> flag: <div class="code"><pre> r.out.ascii -s input=inname output=outname.grd [dp=value] </pre></div> NULL data are coded to "1.70141e+038" for SURFER ASCII GRID files (ignoring the <em>null=</em> parameter). <H2>NOTES</H2> The output from <EM>r.out.ascii</EM> may be placed into a file by using the UNIX redirection mechanism; e.g.: <div class="code"><pre> r.out.ascii input=soils output=- > out.file </pre></div> The output file out.file can then be printed or copied onto a CDROM or floppy disk for export purposes. <P> To export the raster values as x,y,z values of cell centers (one per line) use the <em><A HREF="r.out.xyz.html">r.out.xyz</A></em> module. <H2>SEE ALSO</H2> <EM> <A HREF="r.in.ascii.html">r.in.ascii</A>, <A HREF="r.in.arc.html">r.in.arc</A>, <A HREF="r.out.bin.html">r.out.bin</A>, <A HREF="r.out.gdal.html">r.out.gdal</A>, <A HREF="r.out.xyz.html">r.out.xyz</A> </EM> <H2>AUTHOR</H2> Michael Shapiro, U.S. Army Construction Engineering Research Laboratory <p> Surfer support by Markus Neteler <p> <i>Last changed: $Date: 2006-12-13 15:21:43 +0100 (Wed, 13 Dec 2006) $</i> <HR> <P><a href="index.html">Main index</a> - <a href="raster.html">raster index</a> - <a href="full_index.html">Full index</a></P> <P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p> </body> </html>
