Geografic-Information-System/scripts/r.out.xyz/r.out.xyz.html

<h2>DESCRIPTION</h2>

The <em>r.out.xyz</em> module exports a raster map as a list of x,y,z
values into an ASCII text file.
<p>
<h2>NOTES</h2>

This module will not export x,y coordinates for raster cells containing
a NULL value. This includes cells masked by a raster MASK.
<p>This module, as all GRASS raster modules, will export cells based on the
current region settings. See the <em>g.region</em> module for details.
<p>The <em>r.out.ascii</em> module should be used to export an array (of
size row x column) containing z values.
<p><em>r.out.xyz</em> is simply a front-end to "<tt>r.stats -1gn</tt>".

<h2>EXAMPLE</h2>

In this example, a LiDAR elevation map in the
North Carolina sample dataset location is exported to CSV format.

<div class="code"><pre>
g.region rast=elev_lid792_1m -p
r.out.xyz input=elev_lid792_1m output=elev_lid792_1m.csv separator=","
</pre></div>

<h2>TODO</h2>

Implement this script as a <em>r.out.ascii</em> option?


<h2>SEE ALSO</h2>

<em>
<a href="g.region.html">g.region</a>,
<a href="r.mask.html">r.mask</a>
<a href="r.out.ascii.html">r.out.ascii</a>,
<a href="r.stats.html">r.stats</a>
</em>

<h2>AUTHOR</h2>

M. Hamish Bowman<br>
<i>Dept. Marine Science<br>
Otago University, New Zealand</i>

<p><i>Last changed: $Date$</i>