<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: r3.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>r3.out.ascii</b></em> - Converts a 3D raster map layer into an ASCII text file <h2>KEYWORDS</h2> raster3d, voxel, export <h2>SYNOPSIS</h2> <b>r3.out.ascii</b><br> <b>r3.out.ascii help</b><br> <b>r3.out.ascii</b> [-<b>hm</b>] <b>input</b>=<em>string</em> [<b>output</b>=<em>string</em>] [<b>dp</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>-m</b></DT> <DD>Use G3D mask (if exists) with input map</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>3d raster map to be converted to ASCII</DD> <DT><b>output</b>=<em>string</em></DT> <DD>Name for ASCII output file</DD> <DT><b>dp</b>=<em>integer</em></DT> <DD>Number of decimal places for floats</DD> <DD>Options: <em>0-20</em></DD> <DD>Default: <em>8</em></DD> <DT><b>null</b>=<em>string</em></DT> <DD>Char string to represent no data cell</DD> <DD>Default: <em>*</em></DD> </DL> <H2>DESCRIPTION</H2> Outputs <I>G3D</I> maps in <I>ascii</I> format. <I>map</I> is a valid G3D map in the current mapset. <I>output</I> is the name of an ascii file which will be written in the current working directory. If <I>output</I> is not specified then <B>stdout</B> is used. The <I>-h</I> flag may be used to suppress header information. The module is sensitive to region settings (set with g.region). <H2>NOTES</H2> The default format for the ascii file is equivalent to that required by <EM>r3.in.ascii</EM>. In particular, files output by <EM>r3.out.ascii</EM> with header information may be converted back to G3D maps with <EM>r3.in.ascii</EM>. <P> The format for the ascii file is: <pre> north: <i>floating point</i> south: <i>floating point</i> east: <i>floating point</i> west: <i>floating point</i> top: <i>floating point</i> bottom: <i>floating point</i> rows: <i>integer</i> cols: <i>integer</i> levels: <i>integer</i> </pre> The header is followed by cell values in <EM>floating point</EM> format. Cell values are output as a series of horizontal slices in row-major order. That is, <pre> (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 </pre> <P> One level maps can be imported with r.in.ascii (Raster 2D) after removing the header lines "top", "bottom" and "levels". <H2>SEE ALSO</H2> <EM><A HREF="r3.in.ascii.html">r3.in.ascii</A></EM><br> <EM><A HREF="g.region.html">g.region</A></EM><br> <H2>AUTHORS</H2> Roman Waupotitsch, Michael Shapiro, Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka <p><i>Last changed: $Date: 2006-04-20 23:31:24 +0200 (Thu, 20 Apr 2006) $</i> <HR> <P><a href="index.html">Main index</a> - <a href="raster3D.html">raster3D 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>
