CM.plotMetrics: Plot changes of the banks (erosion and aggradation)
In AntoniusGolly/cmgo: Derive principle Channel metrics from bank points

Description Usage Arguments Details Value Author(s) Examples

If multiple channel surveys are present (time series analyses) and the reference centerline mode is used, this function allows to plot the shift of the banks (bank erosion and aggradation) along the channel.

1	CM.plotMetrics(cmgo.obj, set = "set1", cl = NULL, d = NULL)

`cmgo.obj`	the global object of type list containing data and parameters created with `CM.ini()`
`set`	the reference data set
`cl`	the range of centerline points to be plotted, if NULL (default) the full channel length will be plotted, if a vector of two elements is provided (e.g. c(200, 500)) this cl range is plotted, if a string is provided (e.g. "cl1"), the range defined in `par$plot.cl.ranges$cl1` will be plotted
`d`	the distance range of the centerline downstream to be plotted, NULL (default) cl defintions are taken, if a single value (e.g. d=500) is given 50 m around this distance is plotted, if a vector with two elements is given (e.g. c(280, 620)) this distance range will be plotted

CM.plotMetrics() allows to plot the position of banks with regard to the centerline in downstream direction. If only one survey is present, the plot will only show the distance of the right and left bank to the centerline over the centerline distance (downstream length of the channel). If multiple surveys of a channel exists (time series analyses) the differences of the channel banks can be calculated if a reference centerline is used (reference centerline mode). The differences (bank ersosion and aggradation) are plotted with this function.

Without passing something to the function, the banks of the whole channel are plotted. To specify a region use the cl and d parameters. See the parameter definition and the example section for details.

desc

Antonius Golly

# open demo
cmgo.obj = CM.ini("demo3")

# example 1: plot the distance of channel banks to centerline
CM.plotMetrics(cmgo.obj)

# example 2: plot the change of the channel banks (aggradation/erosion)
CM.plotMetrics(cmgo.obj, set="set2")

# example 3: plot only a range
CM.plotMetrics(cmgo.obj, set="set2", cl=c(800, 850))
CM.plotPlanView(cmgo.obj,  set="set2", cl=c(800, 850)) # compare with plan view map