trace.network: Function to trace a stream network.

In coffeemuggler/RCHILD: Functions for flexible use of the landscape evolution model CHILD

Description

This function traces stream network segments with a drainage area above a certain threshold.

Usage

trace.network(dataset, timestep, area_min, width_scale, width_max, 
    plot = FALSE)

Arguments

dataset	(S4-object) CHILD model run output data set.
timestep	(numeric scalar) time step for which the network will be tracved.
area_min	(numeric scalar) Minimum drainage area from which on a stream is defined. If not specified, all nodes will be treated as stream.
width_scale	(character scalar) Type of line width scaling for drainage area. One out of "none" (equal line width), "linear" (linear scaling), "root" (square root scaling), "power" (power two scaling), "log" (logarithmic scaling), default is "none".
width_max	(numeric scalar) Maximum line width, default is 1.
plot	(logical scalar) Optional plotting of a surface map and the stream network overlay, default is FALSE.

Value

A numeric matrix with stream segment information

Author(s)

Michael Dietze

References

CSDMS website. http://csdms.colorado.edu/wiki/Model:CHILD.
Tucker, GE. 2010. CHILD Users Guide for version R9.4.1. http://csdms.colorado.edu/mediawiki/images/Child_users_guide.pdf
Tucker, GE., Lancaster, ST., Gasparini, NM., Bras, RL. 2001. The Channel-Hillslope Integrated Landscape Development (CHILD) Model. In Harmon, RS., Doe, W.W. III (eds). Landscape Erosion and Evolution Modeling. Kluwer Academic/Plenum Publishers, pp. 349-388.

See Also

trace.stream

Examples

# load example data set
data(hillslope1)

# create stream network for...
network <- trace.network(hillslope1,           # model run hillslope1
                         timestep = 5,         # timestep 5
                         area_min = 100,       # streams with > 100 sqm
                         width_scale = "root", # root-scaled line width
                         width_max = 5,        # maximum line width of 5
                         plot = TRUE)          # and plot it

# show the first five rows of the resulting matrix
network[1:5,]

coffeemuggler/RCHILD documentation built on Dec. 31, 2020, 10:05 p.m.