Extract a Canonical Basin Merge Tree
Value
A complete basin.merge.tree object or NULL. The returned object
contains the canonical basin and merge tables together with the graph,
scalar field, memberships, assignments, plateau graph, parameters, and
provenance required for plotting and cutting the tree. Use
object$merge.table when only the merge-event table is needed.