README.md

nLTT

CRAN_Status_Badge

Branch|GitHub Actions Logo|Codecov logo ---|---|--- master|R-CMD-check|codecov.io develop|R-CMD-check|codecov.io

Repository for the R nLTT package

Installing this package

Make sure you have the package devtools installed.

Then, from within R do, for the stable version:

devtools::install_github("thijsjanzen/nLTT")

For the bleeding-edge version:

devtools::install_github("thijsjanzen/nLTT", ref = "develop")

What is the nLTT statistic?

The nLTT statistic is a likelihood free summary statistic to compare the similarity between two phylogenetic trees. It calculates the distance between the lineage through time curves of the two trees, after normalizing the lineage through time curves with respect to the maximum number of lineages obtained in each tree, and with respect to the total time between the root and the tips of the tree (see also the wiki).

A more detailed description, and a detailed analysis of the performance of the nLTT statistic can be found in the following paper:

Janzen, Thijs, Sebastian Höhna, and Rampal S. Etienne. "Approximate Bayesian computation of diversification rates from molecular phylogenies: introducing a new efficient summary statistic, the nLTT." Methods in Ecology and Evolution 6.5 (2015): 566-575. link

What else does the package do?

Apart from providing functions that calculate the nLTT statistic, the nLTT package for R also provides functions to: - plot the normalized Lineages-Through-Time plot for a single, or for multiple, trees - calculate and plot the average Lineages-Through-Time plot for multiple trees - estimate the parameters of a model for which the likelihood is known (for comparison), using MCMC (as used in the paper) - estimate the parameters of a model for which no likelihood is available, using ABC-SMC (as used in the paper)

Papers using the nLTT statistic

Shu Xie, Luis Valente, Rampal S. Etienne. A simple island biodiversity model is robust to trait dependence in diversification and colonization rates (2022) bioRxiv 2022.01.01.474685; doi: https://doi.org/10.1101/2022.01.01.474685

Francisco Richter, Thijs Janzen, Hanno Hildenbrandt, Ernst C. Wit, Rampal S. Etienne. Detecting phylodiversity-dependent diversification with a general phylogenetic inference framework (2021) bioRxiv 2021.07.01.450729; doi: https://doi.org/10.1101/2021.07.01.450729

Thijs Janzen, Folmer Bokma, Rampal S Etienne, Nucleotide Substitutions during Speciation may Explain Substitution Rate Variation, Systematic Biology (2021), syab085, https://doi.org/10.1093/sysbio/syab085

Pedro Santos Neves, Joshua W. Lambert, Luis Valente, Rampal S. Etienne. "The robustness of a simple dynamic model of island biodiversity to geological and eustatic change" bioRxiv (2021) 2021.07.26.453064; doi: https://doi.org/10.1101/2021.07.26.453064

Bilderbeek, RJC, Laudanno, G, Etienne, RS. Quantifying the impact of an inference model in Bayesian phylogenetics. Methods Ecol Evol. (2021); 12: 351– 358. https://doi.org/10.1111/2041-210X.13514

Hagen O, Flück B, Fopp F, Cabral JS, Hartig F, et al. (2021) gen3sis: A general engine for eco-evolutionary simulations of the processes that shape Earth’s biodiversity. PLOS Biology 19(7): e3001340. https://doi.org/10.1371/journal.pbio.3001340

Giardina F, Romero-Severson EO, Albert J, Britton T, Leitner T "Inference of Transmission Network Structure from HIV Phylogenetic Trees". PLOS Computational Biology (2017) 13(1): e1005316. link

Janzen, Thijs, and Rampal Etienne. "Inferring the role of habitat dynamics in driving diversification: evidence for a species pump in Lake Tanganyika cichlids." bioRxiv (2017): 085431. link

Ibeh, Neke, and Stephane Aris-Brosou. "Estimation of sub-epidemic dynamics by means of Sequential Monte Carlo Approximate Bayesian Computation: an application to the Swiss HIV Cohort Study." bioRxiv (2016): 085993. link

McCloskey, Rosemary M., Richard H. Liang, and Art FY Poon. "Reconstructing contact network parameters from viral phylogenies." Virus evolution 2.2 (2016): vew029. link

Janzen, Thijs, Sebastian Höhna, and Rampal S. Etienne. "Approximate Bayesian computation of diversification rates from molecular phylogenies: introducing a new efficient summary statistic, the nLTT." Methods in Ecology and Evolution (2015): 566-575. link

Acknowledgements

I want to contribute!

See CONTRIBUTING.md

Code of Conduct

See code_of_conduct.md



richelbilderbeek/nLTT documentation built on Aug. 23, 2023, 8 a.m.