Extract the Canonical Basin Table
Value
A data frame with basin/extremum identity, direction (type),
method, retention status, extremum/birth/death levels and persistence,
parent identity, and raw/retained/primary support vertex lists, sizes and
masses. raw.allocated.mass uses raw membership weights. External-ID
companion columns preserve supplied vertex IDs. Unavailable measures are
NA; mass measures require explicitly supplied mass.