datelife0.6.8 package

Scientific Data on Time of Lineage Divergence for Your Taxa

get_ott_lineage

Get the Open Tree of Life Taxonomic identifier (OTT id) and name of al...

get_subset_array_dispatch

Figure out which subset function to use.

get_taxon_summary

Get a taxon summary of a datelifeResult object.

build_grove_list

Build grove list

build_grove_matrix

Find the grove for a group of chronograms and build a matrix.

check_conflicting_calibrations

Check for conflicting calibrations.

check_ott_input

Check input for usage in other datelife functions

choose_cluster

Choose an ultrametric phylo object from cluster_patristicmatrix() ob...

classification_paths_from_taxonomy

Gets classification paths for a vector of taxa

clean_ott_chronogram

Clean up some issues with Open Tree of Life chronograms For now it 1) ...

clean_taxon_info_children

Identify, extract and clean taxonomic children names from a `taxonomy_...

clean_tnrs

Eliminates unmatched (NAs) and invalid taxa from a `rotl::tnrs_match_n...

cluster_patristicmatrix

Cluster a patristic matrix into a tree with various methods.

congruify_and_check

Congruify and Check.

congruify_and_mrca_multiPhylo

Congruify nodes of a tree topology to nodes from a source chronogram, ...

congruify_and_mrca_phylo

Congruify nodes of a tree topology to nodes from a source chronogram, ...

date_with_pbdb

Date with Paleobiology Database and paleotree.

datelife_authors_tabulate

Return the relevant authors for a set of studies.

datelife_result_median

Get a median summary chronogram from a datelifeResult object.

datelife_result_median_matrix

Compute a median matrix of a datelifeResult object.

datelife_result_MRCA

Get a numeric vector of MRCAs from a datelifeResult object. Used in ...

datelife_result_sdm_matrix

Go from a datelifeResult object to a Super Distance Matrix (SDM) usi...

datelife_result_sdm_phylo

Reconstruct a supertree from a datelifeResult object using the Super...

datelife_result_study_index

Find the index of relevant studies in a cached chronogram database.

datelife_result_variance_matrix

Compute a variance matrix of a datelifeResult object.

datelife_search

Get scientific, peer-reviewed information on time of lineage divergenc...

datelife_use

Generate one or multiple chronograms for a set of given taxon names.

datelife_use_datelifequery

Generate one or multiple chronograms for a set of taxon names given as...

dot-get_ott_lineage

Get the lineage of a set of taxa. .get_ott_lineage uses `rotl::taxon...

extract_calibrations_dateliferesult

Use congruification to extract secondary calibrations from a `datelife...

extract_calibrations_phylo

Use congruification to extract secondary calibrations from a phylo o...

extract_ott_ids

Extract numeric OTT ids from a character vector that combines taxon na...

filter_for_grove

Filter a datelifeResult object to find the largest grove.

force_ultrametric

Force a non-ultrametric phylo object to be ultrametric with `phytool...

get_all_calibrations

Get secondary calibrations from a chronogram database for a set of giv...

get_all_descendant_species

Quickly get all species belonging to a taxon from the Open Tree of Lif...

get_best_grove

Get grove from a datelifeResult object that can be converted to phyl...

get_biggest_multiphylo

Get the tree with the most tips from a multiPhylo object: the biggest ...

get_bold_data

Get genetic data from the Barcode of Life Database (BOLD) for a set of...

get_calibrations_datelifequery

Search and extract available secondary calibrations for taxon names in...

get_calibrations_vector

Search and extract secondary calibrations for a given character vector...

get_dated_otol_induced_subtree

Get a dated OpenTree induced synthetic subtree from a set of given tax...

get_datelife_result

Get a patristic matrix of time of lineage divergence data for a given ...

get_datelife_result_datelifequery

Get a list of patristic matrices from a given datelifeQuery object

get_fossil_range

Get the ages for a taxon from PBDB

get_goodmatrices

Get indices of good matrices to apply Super Distance Matrix (SDM) meth...

get_mrbayes_node_constraints

Makes a block of node constraints and node calibrations for a MrBayes ...

get_opentree_chronograms

Get all chronograms from Open Tree of Life database

get_opentree_species

Get all species belonging to a taxon from the Open Tree of Life Taxono...

get_otol_synthetic_tree

Get an Open Tree of Life synthetic subtree of a set of given taxon nam...

get_ott_children

Use this instead of rotl::tol_subtree() when taxa are not in synthes...

get_ott_clade

Get the Open Tree of Life Taxonomic identifiers (OTT ids) and name of ...

get_tnrs_names

Process a character vector of taxon names with TNRS

get_valid_children

Extract valid children from given taxonomic name(s) or Open Tree of Li...

input_process

Process a phylo object or a character string to determine if it's corr...

is_datelife_query

Check if input is a datelifeQuery object

is_datelife_result_empty

Check if we obtained an empty search with the given taxon name(s).

is_good_chronogram

Check if a tree is a valid chronogram.

is_n_overlap

Function for computing n-overlap for two vectors of names (ie., phy1$t...

make_all_associations

Find all authors and where they have deposited their trees

make_bladj_tree

Use the BLADJ algorithm to get a chronogram from a tree topology for w...

make_bold_otol_tree

Use genetic data from the Barcode of Life Database (BOLD) to reconstru...

make_contributor_cache

Create a cache from Open Tree of Life

make_datelife_query

Go from taxon names to a datelifeQuery object

make_datelife_query2

Go from taxon names to a datelifeQuery object

make_mrbayes_runfile

Make a mrBayes run block file with a constraint topology and a set of ...

make_mrbayes_tree

Take a constraint tree and use mrBayes to get node ages and branch len...

make_otol_associations

Associate Open Tree of Life authors with studies

make_overlap_table

Create an overlap table

make_sdm

Make a Super Distance Matrix (SDM) from a list of good matrices obtain...

make_treebase_associations

Associate TreeBase authors with studies

make_treebase_cache

Create a cache from TreeBase

map_nodes_ott

Add Open Tree of Life Taxonomy to tree nodes.

match_all_calibrations

Match calibrations to nodes of a given tree

matrices_to_table

Go from a list of patristic distance matrix to a table of node ages

matrix_to_table

Go from a patristic distance matrix to a node ages table

message_multiphylo

Message for a multiPhylo input

missing_taxa_check

Checks that missing_taxa argument is ok to be used by make_mrbayes_run...

mrca_calibrations

Identify nodes of a tree topology that are most recent common ancestor...

patristic_matrix_array_congruify

patristic_matrix_array_congruify is used for patristic_matrix_array_...

patristic_matrix_array_phylo_congruify

Congruify a patristic matrix array from a given phylo object.

patristic_matrix_array_split

Split a patristic matrix array Used inside: patristic_matrix_array_con...

patristic_matrix_array_subset

Subset a patristic matrix array

patristic_matrix_array_subset_both

Are all desired taxa in the patristic matrix array?

patristic_matrix_list_to_array

Convert list of patristic matrices to a 3D array.

patristic_matrix_MRCA

Get time of MRCA from patristic matrix. Used in `datelife_result_MRCA(...

patristic_matrix_name_order_test

Test the name order of a patristic matrix so that row and column label...

patristic_matrix_name_reorder

Reorder a matrix so that row and column labels are in alphabetical ord...

patristic_matrix_pad

Fill in empty cells in a patristic matrix for missing taxa.

patristic_matrix_taxa_all_matching

Are all desired taxa in the patristic matrix?

patristic_matrix_to_newick

Convert patristic matrix to a newick string. Used inside: summarize_da...

patristic_matrix_to_phylo

Convert a patristic matrix to a phylo object.

patristic_matrix_unpad

Function to remove missing taxa from a datelifeResult object.

phylo_check

Checks if phy is a phylo object and/or a chronogram.

phylo_congruify

Congruify a reference tree and a target tree given as phylo objects.

phylo_generate_uncertainty

Generate uncertainty in branch lengths using a lognormal.

phylo_get_node_numbers

Gets node numbers from any phylogeny

phylo_get_subset_array

Get a subset array from a phylo object

phylo_get_subset_array_congruify

Get a congruified subset array from a phylo object

phylo_has_brlen

Check if a tree has branch lengths

phylo_prune_missing_taxa

Prune missing taxa from a phylo object Used inside phylo_get_subset_...

phylo_subset_both

Subset a reference and a target tree given as phylo objects.

phylo_tiplabel_space_to_underscore

Convert spaces to underscores in trees.

phylo_tiplabel_underscore_to_space

Convert underscores to spaces in trees.

phylo_to_patristic_matrix

Get a patristic matrix from a phylo object.

pick_grove

Pick a grove in the case of multiple groves in a set of trees.

recover_mrcaott

Get an mrcaott tag from an OpenTree induced synthetic tree and get its...

relevant_curators_tabulate

Return the relevant curators for a set of studies.

results_list_process

Take results_list and process it.

run

Core function to generate results

run_mrbayes

Runs MrBayes from R

sample_trees

Sample trees from a file containing multiple trees. Usually from a bay...

summarize_congruifiedCalibrations

Get summary statistics of ages in a congruifiedCalibrations object.

summarize_datelife_result

Summarize a datelifeResult object.

summarize_fossil_range

Summarize taxon age from PBDB to just a single min and max age

summarize_summary_matrix

Gets all ages per taxon pair from a distance matrix Internal function ...

summary.datelifeResult

Summarize a datelifeResult object.

summary.matchedCalibrations

Summarize a matchedCalibrations object summary.matchedCalibrations...

summary_matrix_to_phylo

Go from a summary matrix to an ultrametric phylo object.

summary_matrix_to_phylo_all

Get minimum, median, mean, midpoint, and maximum summary chronograms f...

summary_patristic_matrix_array

Summarize patristic matrix array (by default, median). Used inside: su...

tnrs_match

Taxon name resolution service (tnrs) applied to a vector of names by b...

tree_add_dates

Add missing taxa to a dated tree and fabricate node ages for these mis...

tree_add_nodelabels

Adds labels to nodes with no assigned label

tree_add_outgroup

Function to add an outgroup to any phylogeny, in phylo or newick forma...

tree_check

Checks if a tree is a phylo class object otherwise it uses input_proce...

tree_fix_brlen

Take a tree with branch lengths and fix negative or zero length branch...

tree_from_taxonomy

Gets a taxonomic tree from a vector of taxa

tree_get_node_data

Get node numbers, node names, descendant tip numbers and labels of nod...

tree_get_singleton_outgroup

Identify the presence of a single lineage outgroup in a phylogeny

tree_node_tips

To get tip numbers descending from any given node of a tree

update_all_cached

Update all data files as data objects for the package

update_datelife_cache

Create an updated OpenTree chronograms database object

use_all_calibrations

Date a given tree topology using a given set of congruified calibratio...

use_calibrations

Date a given tree topology using a combined set of given calibrations

use_calibrations_bladj.matchedCalibrations

Use calibrations to date a topology with the BLADJ algorithm.

use_calibrations_bladj

Use calibrations to date a topology with the BLADJ algorithm.

use_calibrations_each

Date a given tree topology by using a given list of calibrations indep...

use_calibrations_pathd8

Date a tree with secondary calibrations using PATHd8

use_calibrations_treePL

Date a tree with initial branch lengths with treePL.

Methods and workflows to get chronograms (i.e., phylogenetic trees with branch lengths proportional to time), using open, peer-reviewed, state-of-the-art scientific data on time of lineage divergence. This package constitutes the main underlying code of the DateLife web service at <https://www.datelife.org>. To obtain a single summary chronogram from a group of relevant chronograms, we implement the Super Distance Matrix (SDM) method described in Criscuolo et al. (2006) <doi:10.1080/10635150600969872>. To find the grove of chronograms with a sufficiently overlapping set of taxa for summarizing, we implement theorem 1.1. from Ané et al. (2009) <doi:10.1007/s00026-009-0017-x>. A given phylogenetic tree can be dated using time of lineage divergence data as secondary calibrations (with caution, see Schenk (2016) <doi:10.1371/journal.pone.0148228>). To obtain and apply secondary calibrations, the package implements the congruification method described in Eastman et al. (2013) <doi:10.1111/2041-210X.12051>. Tree dating can be performed with different methods including BLADJ (Webb et al. (2008) <doi:10.1093/bioinformatics/btn358>), PATHd8 (Britton et al. (2007) <doi:10.1080/10635150701613783>), mrBayes (Huelsenbeck and Ronquist (2001) <doi:10.1093/bioinformatics/17.8.754>), and treePL (Smith and O'Meara (2012) <doi:10.1093/bioinformatics/bts492>).

  • Maintainer: Luna L. Sanchez Reyes
  • License: GPL (>= 2)
  • Last published: 2023-06-19