Abstract
Evolutionary processes happen gradually over time and are, thus, considered time dependent. In addition, several evolutionary processes are either adaptations to local habitats or changing habitats, otherwise restricted thereby. Since evolutionary processes driving speciation take place within the landscape of environmental and temporal bounds, several published studies have aimed at providing accurate, fossil-calibrated, estimates of the divergence times of both extant and extinct species. Correct calibration is critical towards attributing evolutionary adaptations and speciation both to the time and paleogeography that contributed to it. Data from more than 4000 studies and nearly 1,50,000 species are available from a central TimeTree resource and provide opportunities of retrieving divergence times, evolutionary timelines, and time trees in various formats for most vertebrates. These data greatly enhance the ability of researchers to investigate evolution. However, there is limited functionality when studying lists of species that require batch retrieval. To overcome this, a PYTHON package termed Python-Automated Retrieval of TimeTree data (PAReTT) was created to facilitate a biologist-friendly interaction with the TimeTree resource. Here, we illustrate the use of the package through three examples that includes the use of timeline data, time tree data, and divergence time data. Furthermore, PAReTT was previously used in a meta-analysis of candidate genes to illustrate the relationship between divergence times and candidate genes of migration. The PAReTT package is available for download from GitHub or as a pre-compiled Windows executable, with extensive documentation on the package available on GitHub wiki pages regarding dependencies, installation, and implementation of the various functions.
Similar content being viewed by others
Avoid common mistakes on your manuscript.
Introduction
Evolutionary processes are linked to time, be it diversification within a lineage which may lead to the emergence of a new species, or via subtle molecular changes over several generations steadily driving phenotypic variation (Wagner 2018; Francisco Henao Diaz et al. 2019), leading to speciation at the subspecies or ecotype level. For example, some primary divisions between entire taxonomic orders of birds arose approximately 75 million years ago while more recent divisions between subspecies occurred as recently as 1 million years ago (Prum et al. 2015; Mwale et al. 2022).
Most evolutionary processes are context dependent and are, thus, studied as part of ecological (Olson et al. 2001) and geographic changes (Linck et al. 2020). Both shape the landscape within which selection, adaptation, and extinction take place (Wu et al. 2022), including the historical geography or paleogeography at the time of divergence and speciation (Scotese 2016; Müller et al. 2018). This includes the factorization of well-established phenomena that preceded contemporary geography such as continental drift and known major periods of glaciation (Fig. 1), which can only be factored into the evolutionary history of a lineage or species if the time periods for diversification are known. For example, some species considered to be conspecific based on continuous distribution maps may have experienced historical barriers to gene flow that drove speciation millions of years ago. Conversely, some habitats may have previously been unsuitable for a species and have only become suitable for recolonization more recently (Olson et al. 2008; Le et al. 2022).
In studying evolutionary rates, accurate estimates of diversification rates within lineages are also dependent on comparing the temporal range within which the species, and subspecies, of a particular lineage are formed (Jetz et al. 2012). This is pertinent when comparing evolutionary rates between lineages to determine diversification rates, e.g., passerine bird species and non-passerines (Jetz et al. 2012); identifying lineages of interest in the study of speciation due to higher diversification rates (O'Connell et al. 2019); or in studying complex historical speciation events (Lamichhaney et al. 2018). It is, therefore, crucial that studies on evolutionary processes are contextualized within relevant time frames.
Over the past few decades, a plethora of molecular studies have been published using variable methods from fossil-calibrated Bayesian inference (Rannala and Yang 2003; Kumar and Hedges 2016) to comparable relative time approaches (Yang and Yoder 2003; Tamura et al. 2012) to establish the timeline for the emergence and diversification. This includes both living and extinct species within several lineages of mammals (Nyakatura and Bininda-Emonds 2012; Springer et al. 2018), reptiles (Tucker et al. 2017), and birds (Barker et al. 2015; Prum et al. 2015). These studies have greatly advanced our understanding of evolutionary processes within the context of environmental changes and the time constraints that they occur in (Scholl and Wiens 2016). They have also helped clarify many of the questions we have with regard to the taxonomy and phylogeny of species, which have frequently been at odds with each other (Sangster 2014; Springer et al. 2018). More specifically, time trees and gene trees do not always have identical topology as gene trees represent the variable substitution and mutation rates in lineages (Lanfear et al. 2010) which can obscure true species divergence times if not calibrated with more accurate divergence times (Tiley et al. 2020).
The result is a compendium of thousands of studies that has culminated in a central TimeTree resource (Hedges et al. 2006) that collects and compiles divergence time estimates and time trees from published and peer-reviewed studies. From this resource, estimates of divergence times, related timelines, and time trees are available online (Kumar et al. 2017). This also includes the ability to apply the use of TimeTree in MEGA (Mello 2018) and a mobile phone app (Kumar and Hedges 2011). Collectively this provides access to divergence time estimates for use in calibrating phylogenetic trees according to time, comparing clades in phylogenetic trees to know clades of shared common ancestry, as well as comparing genetic distance between species to their temporal or evolutionary distance. There is, however, still limited functionality in retrieving divergence times from the resource when dealing with species lists rather than individual pairs of species for downstream analyses or incorporation in molecular studies. As evolutionary studies frequently focus on multiple species, and even multiple lineages, at a time, this presents a significant barrier towards streamlining the integration of divergence time data into larger studies.
Previous attempts at automation (Krah 2015) to facilitate batch retrieval provided limited utilities and were poorly maintained, resulting in the removal of the package from the CRAN repository; although archived versions may still be available. The TimeTree resource has continued to develop and expand with the latest release of TimeTree 5, and the need for such capabilities is eminent in the ever-expanding field of evolutionary biology. While an application programming interface (API) has recently been created (Kumar et al. 2022), the use of APIs for the interaction with a database is not very biologist-friendly and requires additional computational skills. To bridge the current need, we have endeavored to create an easily accessible and freely available algorithm to retrieve relevant data on evolutionary histories from the TimeTree site for the seamless integration of divergence time data in molecular studies. In this paper we report on the PAReTT (Python-Automated Retrieval of TimeTree data), a menu-driven and user-friendly PYTHON package to automate interaction with the TimeTree resource for retrieving batch data with lists of species. We further provide several case examples to illustrate data retrieval and incorporation of data into scientific studies. The package is freely available on GitHub or as a stand-alone Windows executable.
Methods
Implementation
PAReTT (version 1.0.2) was scripted in the Spyder 5 IDE in pure PYTHON and is compatible with versions 3.6 and upward. A full list of dependencies is provided on the GitHub wiki, along with details for download and installation. This includes the use of several well-established PYTHON-based libraries such as NumPy (version 1.20.1) and pandas (version 1.2.4) for ease of input and high-order molding of data structures with relative ease (McKinney 2010; Harris et al. 2020), as well as Bio (version 1.3.9) for handling trees in the Newick format. PAReTT further uses the headless browser functionality implemented in Splinter (version 0.17.0) with the Selenium (version 4.1.5) extensions for the Firefox browser to submit user-specified web data to the TimeTree website (www.timetree.org) and retrieve the relevant results. Results are printed in real time to the shell, while list results are first stored to a ‘dataframe’ object which is written to user-specified output file. Some functionality had also been provided to validate data for any errors that may have occurred and preview basic tree files. Furthermore, the Magallon–Sanderson equation (Magallón and Sanderson 2001) was used to provide an option to calculate the diversification rate (r) of a lineage, genus, or species complex for which the number of extant species and divergence times are known. The extinction ratio (ε) is the fraction of the extinction rate (μ) divided by speciation rate (λ) according to the following equation:
The extinction rate represents the number of species formed that goes extinct in a given time period while the speciation rate represents the number of species that form within a given time period independent of survival outcomes.
When the extinction ratio is not known, the equation, with crown age, is given by (n is total known species and Δt is divergence time):
When the extinction rate is known, the equation, with crown age, is given by
The diversification rate calculations make use of the math modules that form part of the standard PYTHON releases. The PAReTT script was benchmarked to test for time and memory consumption of individual functions using memory-profiler version 0.16.0.
Input and Output File Formats
PAReTT uses two primary forms of input that users specify when the user is prompted to provide the name of the input file by the interactive menus. The first is a basic text file, indicated as ‘.txt,’ while the second is a standard comma-separated value (CSV) file, indicated as ‘.csv.’ While it is preferred to specify the full name of the file (e.g., ‘Species.txt’), PAReTT was scripted with checkpoints to ensure the proper format of input files, even when only a name is given, and should read the input files as long as they are in the current working directory. If the files are not stored in the current working directory, then the full file path name is preferred. The specific requirements for the content of each input file are detailed under usage in Section ‘Usage.’
Output files differ based on the specific data being retrieved. For example, timelines are retrieved as figures in the JPEG format while time trees, for both complete taxa as well as lists of species, are retrieved in the Newick format. Any species in the provided list for which the divergence time could not be resolved in the tree or were substituted by a similar species are stored as a table for review. Trees can be visualized and edited by most phylogenetic software programs including FigTree (Rambaut 2017) and MEGA (Kumar et al. 2018); however, the basic topology of these trees can also be viewed directly in PAReTT. Divergence time data, based on the median time from all studies from which divergence times estimates are derived, are printed on screen for pairs (only two species). Divergence times for lists of species will iterate through every possible combination of pairs in the lists and store data in ‘dataframe’ objects. These objects can then be stored in the output file as a vectorized three column matrix in a comma-separated value file. Output files are stored in the active working directory.
Usage
The main menu presents the initial options to verify the availability of data for a species, determine divergence times, a timeline, a time tree, validate the data, print the citation for TimeTree, or calculate divergence times as summarized in Fig. 2. The data availability option brings up a submenu to specify if availability should be verified for a single species or species list. When checking a single species, the availability is printed to the screen as the species name followed by either ‘Available’ or ‘Not Available.’ This function was designed to ensure data availability prior to further data retrieval steps. For a list of species, the species name and availability are printed on screen and stored to export results in a CSV file.
The timeline and time tree options will bring up a similar submenu that provides the option to retrieve information for an individual species, individual taxon, or a list of species. As before, individual species will result in a single output. The timeline retrieval function will retrieve an image in the JPEG format that illustrates the evolutionary history for the species highlighting the major time points where a kingdom, order, class, genus, and species first emerged. As an example, a timeline was retrieved for the Lazuli bunting, Passerina amoena [Say, 1823] in Example A. Input given as a list will retrieve individual images for each species in the list. For this example, we used the knowledge of divergence times from the timeline to compliment the timeline data with other relevant information such as the paleogeography (Sampson et al. 2010) and range data from Birds of the World (Greene et al. 2020).
The time tree option has similar functionality except that input can either be a larger taxonomic group, such as family or genus containing several congenic species, or a list of species as this output provides a time-calibrated tree displaying both the interrelatedness of species as well as the timescale along which the branches diverged. In Example B, two individual time trees were generated for the Nearctic thrushes (genus: Catharus) and Australasian fairywrens (genus: Malurus), respectively. The individual diversification rate (r) was calculated for each genus in PAReTT with the Magallon–Sanderson equation (Magallón and Sanderson 2001). More detailed speciation, extinction, and diversification rates (Etienne and Apol 2009) were computed with PyRate version 3.1.1 to further illustrate the use of diversification rates in evolutionary studies (Silvestro et al. 2014).
The Divergence time submenu (Example C) provides the option to check for the divergence time between two species e.g., the Neotropical Swainson’s thrush, Catharus ustulatus [Nuttall, 1840], and the Australasian Superb fairywren, Malurus cyaneus [Ellis, 1782]. The result will be printed to the screen as the name of ‘Taxon a’ and ‘Taxon b’ followed by the mean divergence time in millions of years ago (MYA) e.g., 35 MYA. The list option takes a text file with a list of species names and iterates through the list to determine the divergence time between each species in the list (Supplementary Fig. 1). The results are stored in a ‘dataframe’ object which can be exported as a CSV file in the form of a three column vectorized matrix with the names for ‘Taxa 1’ in the first column, the names of ‘Taxa 2’ in the second column, and the divergence times between them in the third column. Additional functionality is provided in the main menu to validate data. This option can be used to check output files for missing values, as well as retrieve and replace such values, in case a server error occurred. The table generated for species lists, in the form of a three column vectorized matrix, can then be converted to a full matrix to use divergence times as a measure of separation or differentness in Mantel tests (Mantel 1967; Carr 2021) as applied to landscape or spatial genetics. This was done to compare the distribution of genetic distance, as measured by fixation index (FST) calculated with POPGENE version 1.32 (Yeh et al. 1997), for two circadian clock gene polymorphisms as they relate to evolutionary histories among forty bird species (Le Clercq et al. 2023).
Results
Example A—Timelines and Paleogeography
The timeline (Fig. 3) was retrieved for the Neotropical bird, the Lazuli bunting. The left panel indicates the major geologic timescales in Eons and Eras while the right indicates the main divergence times when specific taxa emerged. This includes the current Phanerozoic Eon as well as the subdivisions from the Paleozoic Era, which lasted until approximately 250 MYA, and the Mesozoic which lasted until 65 MYA illustrated in the first panel of Fig. 1. This period was marked by the emergence of several major lineages including the first birds (class: Aves) approximately 110 MYA as well as the taxonomic order Passeriformes, which includes most of the songbirds, approximately 63 MYA. The specific species, a bunting in the family Cardinalidae, emerged from a common ancestor shared with other cardinals in the Cenozoic approximately 11 MYA, while species of the genus Passerina first emerged approximately 4 MYA and subsequently diverged to form species. The range of the Lazuli bunting is located on the Western half of North America (Greene et al. 2020) which was physically separated from the Eastern half by the North American inland sea; the modern continent only formed after the Upper Cretaceous period around the Paleocene (Fig. 1).
Example B—Time Trees and Diversification Rates
Time trees (Fig. 4) were generated for two genera of birds that each contain several congenic species (11–12 species) but have different evolutionary histories in terms of the divergence times within their genus. The first represents the genus Catharus for which 12 species are included in the time tree. These species diverged over a period spanning approximately 4.73 million years and have an absolute diversification rate of 0.38 (N = 12). By comparison, the second tree for the genus Malurus includes a similar number of species; however, these species diverged over a period of approximately 9 million years and have a diversification rate (r = 0.19, N = 11) of nearly half the rate observed in Catharus. More detailed speciation and diversification rate estimates, for each species evolutionary timeline, are indicated in Fig. 5. Both genera displayed comparable trends in both speciation rate (λ) and diversification rate (r); however, these processes happened on different timescales, since approximately 10 MYA for Malurus species and 6 MYA for Catharus species. Overall, the rates for Catharus species were slightly higher. As extinct species for these lineages are unknown, the estimates for extinction rates (μ) were close to zero, resulting in highly similar speciation and diversification plots.
Example C—Divergence Times and Genetic Distance
As an example, the divergence times retrieved for four species are given in Table 1: Lazuli bunting, Malachite kingfisher (Corythornis cristatus [Pallas, 1764]), Amethyst sunbird (Chalcomitra amethystine [Shaw, 1812]), and Emerald cuckoo (Chrysococcyx cupreus [Shaw, 1792]). The results clearly illustrate the more recent divergence time (25.4–38.1 MYA) between Lazuli bunting and Amethyst sunbird, both members of the same order (order: Passeriformes), as well as the far-older divergence times (73.7–97.3 MYA) between birds from different orders such as the Malachite kingfisher (order: Coraciiformes) and Emerald cuckoo (order: Cuculiformes). Furthermore, PAReTT was used to assess data availability and retrieve divergence times between species for a list of forty bird species in a recent review and meta-analysis on clock genes as candidate genes in migration studies, published in Biological Reviews (Le Clercq et al. 2023). This study found a significant relationship between divergence times and the observed genetic distance as measured by fixation index (FST), for allele data of two candidate genes, using Mantel tests for matrix comparison (Fig. 6). Thus, the alleles and their distributions potentially still reflect the ancestral state rather than contemporary changes due to selection. The results from the benchmarking tests, performed in tandem, showed an average time for submitting data and retrieving the result ranged from fifteen to thirty seconds and memory consumption remained low, ranging from < 100 to 400 Megabytes (Supplementary Table 1).
Discussion
In this paper, we used three examples to illustrate the types of data that can be retrieved using PAReTT as well as how these data can be incorporated into evolutionary studies. The first involved a detailed timeline of the evolutionary history for Lazuli buntings which enabled a direct comparison of divergence times to the relative paleogeography for their range. The observation that their modern range corresponds to geographic patterns during their divergence time is indicative of speciation happening during former geographic isolation due to the North American inland sea (Western interior seaway), without substantial range expansion after the continent formed. This may have contributed to the division between the Lazuli bunting and other Neotropical buntings such as the Painted bunting, Passerina ciris [Linnaeus, 1758], which has a range that is restricted to the South-East of North America (Lowther et al. 2020) and Indigo bunting, Passerina cyanea [Linnaeus, 1766], which has a North-Eastern range (Payne 2020), although the primary division between these lineages is only dated to approximately 4.48 MYA. Similar observations have been made in North American Catharus species of thrushes (Voelker et al. 2013).
This example clearly illustrates the added value of divergence data and accurate timelines in reconstructing and understanding evolutionary processes. While we did use paleogeography (Sampson et al. 2010) from the literature and range data from the Birds of the World species records (Greene et al. 2020), this should be achievable in most species. Paleogeography can be reconstructed for nearly any period using PALEOMAP (Scotese 2016), as illustrated in Fig. 1, while range data can be retrieved for most birds (BirdLife International and Handbook of the Birds of the World 2021) as well as many mammals, reptiles, amphibians, and fishes (International Union for Conservation of Nature (IUCN) 2022) for use in range mapping analyses.
The second example illustrated the retrieval of time trees at the species level for two specific genera for the purpose of visually representing the timescale during which speciation and diversification happen in different lineages. Diversification rate calculations within PAReTT are based on user input rather than tree input as accurate measures would require a completely sampled phylogeny which is often unavailable. The diversification rate, based solely on the species for which data were available on the TimeTree resource, differed substantially between the two genera: having both different node ages for each genus as well as differing in the number of species, while having similar phylogenetic tree topology. More detailed analyses of speciation and diversification over time showed higher initial speciation with an eventual decline, possibly indicating a rate shift, followed by a plateau of lower rates. This could be due to the analyses only evaluating speciation at the species level and not the subspecies level, as several species within both lineages are partitioned into subspecies. For both genera, the TimeTree data were fairly complete as only two additional Catharus species, and one additional Malurus species, are currently recognized. In this example speciation and diversification rate plots were nearly identical due to the lack of known extinct species. This is contrary to the results that could be obtained for genera such as Acrocephalus warblers that includes 42 species of which 6 insular forms, including the Pagan reed warbler (Acrocephalus yamashinae [Taka-Tsukasa, 1931]), are known to be extinct.
The study of speciation, extinction, and diversification rates are critical in identifying lineages that rapidly for evolutionary studies to elucidate key factors that confer evolutionary advantages or disadvantages (Jetz et al. 2012; O'Connell et al. 2019). In addition, identifying lineages with slower speciation are informative for conservation practices, considering such species may experience higher difficulty to adapt to changes in their environment and both speciation and diversification rates have been tied to range changes, a critical attribute used in assessing species viability (Castiglione et al. 2017).
The third example focused on the retrieval of divergence times between lists of species to enable the construction of a matrix where divergence time serves as a proxy for temporal evolutionary distance. This enabled the comparison of genetic distance to evolutionary distance using Mantel tests (Mantel 1967; Carr 2021). The significant correlation between the measures illustrated the high heritability of genotypes within lineages which, combined with and a lack of selection, portends the possibility of these genes reflecting ancestral states (Le Clercq et al. 2023). This illustrates the significance in studying divergence time data in relation to genetic data in molecular studies. The TimeTree resource does, however, still lack options to facilitate batch retrieval of divergence times for lists of species.
Several key differences still exist in the types and formats of data that can be retrieved using PAReTT versus the main website. When retrieving timelines, PAReTT will retrieve the full timeline including other relevant ecological attributes; if only the major epochs and period are required for the image, then this can be specified on the online version. When retrieving time trees, PAReTT will automatically retrieve trees at the species level while trees above the genus level can be retrieved for a family or order using the website. Additionally, as PAReTT is designed to retrieve data for downstream analyses, the time trees are exported as editable Newick format trees rather than images intended to be used as is. Special features of PAReTT include the ability to retrieve batch divergence times for a list of species as a vectorized matrix that is well suited to downstream data analyses of divergence times as matrix data, although further details such as confidence intervals and the number of included studies is best retrieved from the website as needed. PAReTT can also calculate diversification rates based on retrieved data to ascertain if different rates exist between lineages.
Here, we illustrated the use of a newly scripted PYTHON package called PAReTT that provides an added layer of functionality to the TimeTree resource that can enhance molecular and evolutionary studies. Future updates will include the ability to switch between scientific names and common names for species as well as the ability to calculate diversification rates for a table of multiple lineages.
Data Availability
The custom Python script for PAReTT version 1.0.2 is available for download for installation from source code on GitHub (https://github.com/LSLeClercq/PAReTT), or as a Windows executable of version 1.0.1 from the Zenodo online depository (https://zenodo.org/record/6653321#.Y6MnNHZBw2w), and includes example files used for testing. Data used in this paper were deposited online (https://zenodo.org/record/7496660#.Y7A-aHZBw2x).
References
Barker K, Burns KJ, Klicka J et al (2015) New insights into new world biogeography: an integrated view from the phylogeny of blackbirds, cardinals, sparrows, tanagers, warblers, and allies. Auk 132:333–348. https://doi.org/10.1642/AUK-14-110.1
BirdLife International, Handbook of the Birds of the World (2021) Bird species distribution maps of the world. Version 2021.1. http://datazone.birdlife.org/species/requestdis. Accessed 9 Dec 2021
Carr J (2021) Mantel. PYTHON package version 2.1.0. https://github.com/jwcarr/mantel. Accessed 21 Apr 2022
Castiglione S, Mondanaro A, Melchionna M et al (2017) Diversification rates and the evolution of species range size frequency distribution. Front Ecol Evol 5:147. https://doi.org/10.3389/FEVO.2017.00147/BIBTEX
Etienne RS, Apol MEF (2009) Estimating speciation and extinction rates from diversity data and the fossil record. Evolution 63:244–255. https://doi.org/10.1111/j.1558-5646.2008.00537.x
Francisco Henao Diaz L, Harmon LJ, Sugawara MTC et al (2019) Macroevolutionary diversification rates show time dependency. Proc Natl Acad Sci U S A 116:7403–7408. https://doi.org/10.1073/pnas.1818058116
Greene E, Muehter VR, Davison W (2020) Lazuli Bunting (Passerina amoena). In: Poole AF (ed) Birds of the World. Cornell Lab of Ornithology, Ithaca, NY, USA. https://doi.org/10.2173/bow.lazbun.01
Harris CR, Millman KJ, van der Walt SJ et al (2020) Array programming with NumPy. Nature 585:357–362. https://doi.org/10.1038/s41586-020-2649-2
Hedges SB, Dudley J, Kumar S (2006) TimeTree: a public knowledge-base of divergence times among organisms. Bioinformatics 22:2971–2972. https://doi.org/10.1093/bioinformatics/btl505
International Union for Conservation of Nature (IUCN) (2022) Digital distribution maps on The IUCN Red List of Threatened Species. Version 6.2. https://www.iucnredlist.org/resources/spatial-data-download. Accessed 23 Nov 2022
Jetz W, Thomas GH, Joy JB et al (2012) The global diversity of birds in space and time. Nature 491:444–448. https://doi.org/10.1038/nature11631
Krah F-S (2015) Timetree: interface to the timetree of life webpage. R package version 1.0. https://cran.r-project.org/web/packages/timetree/index.html
Kumar S, Hedges SB (2011) Timetree2: species divergence times on the iPhone. Bioinformatics 27:2023–2024. https://doi.org/10.1093/bioinformatics/btr315
Kumar S, Hedges SB (2016) Advances in time estimation methods for molecular data. Mol Biol Evol 33:863–869. https://doi.org/10.1093/molbev/msw026
Kumar S, Stecher G, Suleski M, Hedges SB (2017) TimeTree: a resource for timelines, timetrees, and divergence times. Mol Biol Evol 34:1812–1819. https://doi.org/10.1093/MOLBEV/MSX116
Kumar S, Stecher G, Li M et al (2018) MEGA X: molecular evolutionary genetics analysis across computing platforms. Mol Biol Evol 35:1547–1549. https://doi.org/10.1093/molbev/msy096
Kumar S, Suleski M, Craig JM et al (2022) TimeTree 5: an expanded resource for species divergence times. Mol Biol Evol 39:msac174. https://doi.org/10.1093/molbev/msac174
Lamichhaney S, Han F, Webster MT et al (2018) Rapid hybrid speciation in Darwin's finches. Science 359:224–228. https://doi.org/10.1126/science.aao4593
Lanfear R, Ho SYW, Love D, Bromham L (2010) Mutation rate is linked to diversification in birds. Proc Natl Acad Sci U S A 107:20423–20428. https://doi.org/10.1073/pnas.1007888107
Le CT, Do TB, Pham TMA et al (2022) Reconstruction of the evolutionary biogeography reveals the origins of Alpinia Roxb. (Zingiberaceae): a case of out-of-Asia migration to the Southern Hemisphere. Acta Bot Brasilica 36:e2021abb0255. https://doi.org/10.1590/0102-33062021abb0255
Le Clercq LS, Bazzi G, Cecere JG et al (2023) Time trees and clock genes: a systematic review and comparative analysis of contemporary avian migration genetics. Biol Rev. https://doi.org/10.1111/brv.12943
Linck E, Freeman BG, Dumbacher JP (2020) Speciation and gene flow across an elevational gradient in New Guinea kingfishers. J Evol Biol 33:1643–1652. https://doi.org/10.1111/jeb.13698
Lowther PE, Lanyon SM, Thompson CW, Schulenberg TS (2020) Painted bunting (Passerina ciris), version 1.0. Birds World. https://doi.org/10.2173/BOW.PAIBUN.01
Magallón S, Sanderson MJ (2001) Absolute diversification rates in angiosperm clades. Evolution (N Y) 55:1762–1780. https://doi.org/10.1111/j.0014-3820.2001.tb00826.x
Mantel N (1967) The detection of disease clustering and a generalized regression approach. Cancer Res 27:209–220
McKinney W (2010) Data structures for statistical computing in python. In: Proc. of the 9th Python in Science Conf. (SciPy 2010) pp 56–61
Mello B (2018) Estimating timetrees with MEGA and the timetree resource. Mol Biol Evol 35:2334–2342. https://doi.org/10.1093/molbev/msy133
Müller RD, Cannon J, Qin X et al (2018) GPlates: building a virtual earth through deep time. Geochem, Geophys Geosyst 19:2243–2261. https://doi.org/10.1029/2018GC007584
Mwale M, Dalton DL, Kropff AS et al (2022) Genetic and morphological variation of Woodland Kingfisher Halcyon senegalensis reveals cryptic mitochondrial lineages and patterns of mitochondrial nuclear discordance. Ostrich 93:192–207. https://doi.org/10.2989/00306525.2022.2066215
Nyakatura K, Bininda-Emonds ORP (2012) Updating the evolutionary history of Carnivora (Mammalia): a new species-level supertree complete with divergence time estimates. BMC Biol 10:12. https://doi.org/10.1186/1741-7007-10-12
O'Connell DP, Kelly DJ, Lawless N et al (2019) Diversification of a great speciator in the Wallacea region: differing responses of closely related resident and migratory kingfisher species (Aves: Alcedinidae: Todiramphus). Ibis 161:806–823. https://doi.org/10.1111/ibi.12688
Olson DM, Dinerstein E, Wikramanayake ED et al (2001) Terrestrial ecoregions of the world: a new map of life on earth: a new global map of terrestrial ecoregions provides an innovative tool for conserving biodiversity. Bioscience 51:933–938. https://doi.org/10.1641/0006-3568(2001)051[0933:TEOTWA]2.0.CO;2
Olson DE, FitzGerald G, Hand DM et al (2008) Use of parentage analysis to determine reproductive success of hatchery-origin spring chinook salmon outplanted into Shitike Creek, Oregon. North Am J Fish Manag 28:1472–1485. https://doi.org/10.1577/m07-195.1
Payne RB (2020) Indigo bunting (Passerina cyanea). In: Poole AF (ed) Birds of the World. Cornell Lab of Ornithology, Ithaca, NY USA. https://doi.org/10.2173/bow.indbun.01
Prum RO, Berv JS, Dornburg A et al (2015) A comprehensive phylogeny of birds (Aves) using targeted next-generation DNA sequencing. Nature 526:569–573. https://doi.org/10.1038/nature15697
Rambaut A (2017) FigTree-version 1.4.3, a graphical viewer of phylogenetic trees. https://github.com/rambaut/figtree/releases. Accessed 8 Jul 2022
Rannala B, Yang Z (2003) Bayes estimation of species divergence times and ancestral population sizes using DNA sequences from multiple loci. Genetics 164:1645–1656. https://doi.org/10.1093/genetics/164.4.1645
Sampson SD, Loewen MA, Farke AA et al (2010) New horned dinosaurs from Utah provide evidence for intracontinental dinosaur endemism. PLoS ONE 5:1–12. https://doi.org/10.1371/journal.pone.0012292
Sangster G (2014) The application of species criteria in avian taxonomy and its implications for the debate over species concepts. Biol Rev 89:199–214. https://doi.org/10.1111/BRV.12051
Scholl JP, Wiens JJ (2016) Diversification rates and species richness across the Tree of Life. Proc R Soc B Biol Sci. https://doi.org/10.1098/RSPB.2016.1334
Scotese CR (2016) PALEOMAP PaleoAtlas for GPlates and the PaleoData Plotter Program. http://www.earthbyte.org/paleomap-%0Apaleoatlas-for-gplates/. Accessed 21 Apr 2022
Silvestro D, Salamin N, Schnitzler J (2014) PyRate: a new program to estimate speciation and extinction rates from incomplete fossil data. Methods Ecol Evol 5:1126–1131. https://doi.org/10.1111/2041-210X.12263
Springer MS, Murphy WJ, Roca AL (2018) Appropriate fossil calibrations and tree constraints uphold the mesozoic divergence of solenodons from other extant mammals. Mol Phylogenet Evol 121:158–165. https://doi.org/10.1016/j.ympev.2018.01.007
Tamura K, Battistuzzi FU, Billing-Ross P et al (2012) Estimating divergence times in large molecular phylogenies. Proc Natl Acad Sci U S A 109:19333–19338. https://doi.org/10.1073/pnas.1213199109
Tiley GP, Poelstra JW, dos Reis M et al (2020) Molecular clocks without rocks: new solutions for old problems. Trends Genet 36:845–856. https://doi.org/10.1016/j.tig.2020.06.002
Tucker DB, Hedges SB, Colli GR et al (2017) Genomic timetree and historical biogeography of Caribbean island ameiva lizards (Pholidoscelis: Teiidae). Ecol Evol 7:7080–7090. https://doi.org/10.1002/ece3.3157
Voelker G, Bowie RCK, Klicka J (2013) Gene trees, species trees and earth history combine to shed light on the evolution of migration in a model avian system. Mol Ecol 22:3333–3344. https://doi.org/10.1111/mec.12305
Wagner CE (2018) Improbable big birds Darwin's finches prove a mechanism for the rapid formation of new species. Science 359:157–159. https://doi.org/10.1126/science.aar4796
Wu MY, Lau CJ, Ng EYX et al (2022) Genomes from historic dna unveil massive hidden extinction and terminal endangerment in a tropical asian songbird radiation. Mol Biol Evol. https://doi.org/10.1093/MOLBEV/MSAC189
Yang Z, Yoder AD (2003) Comparison of likelihood and Bayesian methods for estimating divergence times using multiple gene loci and calibration points, with application to a radiation of cute-looking mouse lemur species. Syst Biol 52:705–716. https://doi.org/10.1080/10635150390235557
Yeh FC, Yang RC, Boyle TBJ, et al (1997) POPGENE, the user-friendly shareware for population genetic analysis. Mol Biol Biotechnol centre, Univ Alberta, Canada. https://sites.ualberta.ca/~fyeh/popgene.html. Accessed 13 Jun 2022
Acknowledgements
All images were created or edited in BioRender.com. This work is based on the research supported wholly/in part by the National Research Foundation of South Africa (Grant Number: 112062).
Funding
Open access funding provided by University of the Free State. This study was supported by the National Research Foundation (Grant No. 112062).
Author information
Authors and Affiliations
Contributions
LSLC scripted the PAReTT program, created the images, and wrote the draft manuscripts. DLD, AK, and JPG provided research support and edited the final draft.
Corresponding author
Ethics declarations
Conlict of interest
The authors have no conflicts of interest to declare.
Additional information
Handling editor: Arndt von Haesele.
Supplementary Information
Below is the link to the electronic supplementary material.
Rights and permissions
Open Access This article is licensed under a Creative Commons Attribution 4.0 International License, which permits use, sharing, adaptation, distribution and reproduction in any medium or format, as long as you give appropriate credit to the original author(s) and the source, provide a link to the Creative Commons licence, and indicate if changes were made. The images or other third party material in this article are included in the article's Creative Commons licence, unless indicated otherwise in a credit line to the material. If material is not included in the article's Creative Commons licence and your intended use is not permitted by statutory regulation or exceeds the permitted use, you will need to obtain permission directly from the copyright holder. To view a copy of this licence, visit http://creativecommons.org/licenses/by/4.0/.
About this article
Cite this article
Le Clercq, LS., Kotzé, A., Grobler, J.P. et al. PAReTT: A Python Package for the Automated Retrieval and Management of Divergence Time Data from the TimeTree Resource for Downstream Analyses. J Mol Evol 91, 502–513 (2023). https://doi.org/10.1007/s00239-023-10106-3
Received:
Accepted:
Published:
Issue Date:
DOI: https://doi.org/10.1007/s00239-023-10106-3