descend_template_phylogeny_dendropy

descend_template_phylogeny_dendropy(tree: ~dendropy.datamodel.treemodel._tree.Tree, seed_column: ~hstrat.genome_instrumentation.HereditaryStratigraphicColumn, extant_nodes: ~typing.Iterable[~dendropy.datamodel.treemodel._node.Node] | None = None, progress_wrap: ~typing.Callable = <function <lambda>>) → List[HereditaryStratigraphicColumn]

Generate a population of hereditary stratigraphic columns that could have resulted from the template phylogeny.

Parameters

treedendropy.Tree

Phylogeny record as a dendropy Tree.

seed_columnHereditaryStratigraphicColumn

Hereditary stratigraphic column to seed at root node of phylogeny.

Returned hereditary stratigraphic column population will be generated as if repeatedly calling CloneDescendant() on seed_column. As such, specifies configuration (i.e., differentia bit width and stratum retention policy) for returned columns. May already have strata deposited, which will be incorporated into generated extant population.

extant_nodesoptional list of dendropy.Node

Which organisms should hereditary stratigraphic columns be created for?

Designates content and order of returned list of hereditary stratigraphic column.

If None, hereditary stratigraphic columns will be created for all phylogenetic leaves (organisms without offspring) in order of appearance in tree.leaf_node_iter().

progress_wrapCallable, default identity function

Wrapper applied around generation iterator and row generator for final phylogeny compilation process.

Pass tqdm or equivalent to display progress bars.

Returns

list of HereditaryStratigraphicColumn

Population of hereditary stratigraphic columns for extant lineage members (i.e., phylogeny leaf nodes).

Columns ordered in order of appearance of corresponding extant organism id.