The given file text is parsed and a tree object is constructed which
can be used with the functions in the ape package. Annotations
of the kind produced by, for example, MrBayes, are parsed and
preserved in the returned object.
In addition to edge
, edge.length
and tip.label
,
two additional vectors are added. These are node.comment
and
node.distance.comment
. These contain annotations associated
with nodes and their distance values. These arrays are indexed by node
number, not by edge. The reason for this is that this ensures that the
object will remain in a valid state after a call to reorder
which might change the ordering of the edge arrays without being aware
of annotations. If you need to obtain annotations in edge-order,
subset by the second column of the edge
array.