<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: r.carve</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.carve</b></em> - Takes vector stream data, transforms it to raster and subtracts depth from the output DEM. <h2>KEYWORDS</h2> raster <h2>SYNOPSIS</h2> <b>r.carve</b><br> <b>r.carve help</b><br> <b>r.carve</b> [-<b>nq</b>] <b>rast</b>=<em>name</em> <b>vect</b>=<em>name</em> <b>output</b>=<em>name</em> [<b>points</b>=<em>name</em>] [<b>width</b>=<em>float</em>] [<b>depth</b>=<em>float</em>] [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>-n</b></DT> <DD>No flat areas allowed in flow direction</DD> <DT><b>-q</b></DT> <DD>Run quietly</DD> <DT><b>--overwrite</b></DT> <DD>Allow output files to overwrite existing files</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>rast</b>=<em>name</em></DT> <DD>Name of input raster elevation map</DD> <DT><b>vect</b>=<em>name</em></DT> <DD>Name of vector input map containing stream(s)</DD> <DT><b>output</b>=<em>name</em></DT> <DD>Name for output raster map</DD> <DT><b>points</b>=<em>name</em></DT> <DD>Name for output vector map for adjusted stream points</DD> <DT><b>width</b>=<em>float</em></DT> <DD>Stream width (in meters). Default is raster cell width</DD> <DT><b>depth</b>=<em>float</em></DT> <DD>Additional stream depth (in meters)</DD> </DL> <H2>DESCRIPTION</H2> <em>r.carve</em> accepts vector stream data as input, transforms them to raster, and subtracts a defaultdepth+additionaldepth from a DEM. If the given width is more than 1 cell, it will carve the stream with the given width. With the -n flag it should eliminate all flat cells within the stream, so when and if the water gets into the stream it will flow. The <em>points</em> option generates x,y,z for points which define the stream with the z-value of the bottom of the carved-in stream. These points can then be combined with contours to interpolate a new DEM with better representation of valleys. <H2>NOTE</H2> <em>r.carve</em> does not create a depressionless DEM because many depressions are in flat areas and not in the streams. <H2>EXAMPLE</H2> <div class="code"><pre> g.region rast=elevation.10m -p r.carve rast=elevation.10m vect=streams out=carve_dem width=20 depth=5 </pre></div> <H2>BUGS</H2> <!-- Is this still the case as of Jan 11, 2008? - EP --> The module does not operate yet in latitude-longitude locations. It has not been thoroughly tested, so not all options may work properly - but this was the intention. <H2>REFERENCES</H2> <a href="http://skagit.meas.ncsu.edu/~helena/gmslab/reports/cerl99/rep99.html">Terrain modeling and Soil Erosion Simulations for Fort Hood and Fort Polk test areas</a>, by Helena Mitasova, Lubos Mitas, William M. Brown, Douglas M. Johnston, GMSL (Report for CERL 1999) <H2>SEE ALSO</H2> <EM><A HREF="r.flow.html">r.flow</A></EM>, <EM><A HREF="r.fill.dir.html">r.fill.dir</A></EM>, <EM><A HREF="r.watershed.html">r.watershed</A></EM> <H2>AUTHOR</H2> Bill Brown (GMSL)<br> GRASS 6 update: Brad Douglas <p><i>Last changed: $Date: 2008-01-13 02:01:00 +0100 (Sun, 13 Jan 2008) $</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>
