r.carve(1)

1r.carve(1)                    Grass User's Manual                   r.carve(1)
2
3
4

NAME

6       r.carve   -  Takes vector stream data, transforms it to raster and sub‐
7       tracts depth from the output DEM.
8

KEYWORDS

10       raster
11

SYNOPSIS

13       r.carve
14       r.carve help
15       r.carve   [-nq]   rast=name   vect=name   output=name     [points=name]
16       [width=float]   [depth=float]   [--overwrite]  [--verbose]  [--quiet]
17
18   Flags:
19       -n
20           No flat areas allowed in flow direction
21
22       -q
23           Run quietly
24
25       --overwrite
26           Allow output files to overwrite existing files
27
28       --verbose
29           Verbose module output
30
31       --quiet
32           Quiet module output
33
34   Parameters:
35       rast=name
36           Name of input raster elevation map
37
38       vect=name
39           Name of vector input map containing stream(s)
40
41       output=name
42           Name for output raster map
43
44       points=name
45           Name for output vector map for adjusted stream points
46
47       width=float
48           Stream width (in meters). Default is raster cell width
49
50       depth=float
51           Additional stream depth (in meters)
52

DESCRIPTION

54       r.carve accepts vector stream data as input, transforms them to raster,
55       and subtracts a defaultdepth+additionaldepth from a DEM. If  the  given
56       width  is  more  than  1  cell, it will carve the stream with the given
57       width. With the -n flag it should eliminate all flat cells  within  the
58       stream, so when and if the water gets into the stream it will flow. The
59       points option generates x,y,z for points which define the  stream  with
60       the  z-value  of  the  bottom of the carved-in stream. These points can
61       then be combined with contours to interpolate a  new  DEM  with  better
62       representation of valleys.
63

NOTE

65       r.carve  does  not create a depressionless DEM because many depressions
66       are in flat areas and not in the streams.
67

EXAMPLE

69
70       g.region rast=elevation.10m -p
71       r.carve rast=elevation.10m vect=streams out=carve_dem width=20 depth=5
72
73

BUGS

75       The module does not operate yet in  latitude-longitude  locations.   It
76       has  not been thoroughly tested, so not all options may work properly -
77       but this was the intention.
78

REFERENCES

80       Terrain modeling and Soil Erosion Simulations for Fort  Hood  and  Fort
81       Polk  test  areas,  by  Helena Mitasova, Lubos Mitas, William M. Brown,
82       Douglas M.  Johnston, GMSL (Report for CERL 1999)
83

AUTHOR

88       Bill Brown (GMSL)
89       GRASS 6 update: Brad Douglas
90
91       Last changed: $Date: 2008-01-13 02:01:00 +0100 (Sun, 13 Jan 2008) $
92
93       Full index
94
95       © 2003-2008 GRASS Development Team
96
97
98
99GRASS 6.3.0                                                         r.carve(1)