filter_for_grove: Filter a 'datelifeResult' object to find the largest grove.

View source: R/groves.R

filter_for_groveR Documentation

Filter a datelifeResult object to find the largest grove.

Description

Filter a datelifeResult object to find the largest grove.

Usage

filter_for_grove(datelife_result, criterion = "taxa", n = 2)

Arguments

datelife_result

A datelifeResult object. Only needed for criterion = "taxa".

criterion

Defaults to criterion = "taxa". Used for chronogram summarizing, i.e., obtaining a single summary chronogram from a group of input chronograms. For summarizing approaches that return a single summary tree from a group of phylogenetic trees, it is necessary that the latter form a grove, roughly, a sufficiently overlapping set of taxa between trees, see Ané et al. (2009) \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1007/s00026-009-0017-x")}. In rare cases, a group of trees can have multiple groves. This argument indicates whether to get the grove with the most trees (criterion = "trees") or the most taxa (criterion = "taxa").

n

The degree of taxon name overlap among input chronograms. Defaults to n = 2, i.e., at least two overlapping taxon names.

Value

A datelifeResult object filtered to only include one grove of trees.


datelife documentation built on July 10, 2023, 2:02 a.m.