Measuring Morphological Diversity and Evolutionary Tempo
Overview
Measures morphological diversity from discrete character data and estimates evolutionary tempo on phylogenetic trees. Imports morphological data from #NEXUS (Maddison et al. (1997) doi:10.1093/sysbio/46.4.590) format with read_nexus_matrix(), and writes to both #NEXUS and TNT format (Goloboff et al. (2008) doi:10.1111/j.1096-0031.2008.00217.x). Main functions are test_rates(), which implements AIC and likelihood ratio tests for discrete character rates introduced across Lloyd et al. (2012) doi:10.1111/j.1558-5646.2011.01460.x, Brusatte et al. (2014) doi:10.1016/j.cub.2014.08.034, Close et al. (2015) doi:10.1016/j.cub.2015.06.047, and Lloyd (2016) doi:10.1111/bij.12746, and calculate_morphological_distances(), which implements multiple discrete character distance metrics from Gower (1971) doi:10.2307/2528823, Wills (1998) doi:10.1006/bijl.1998.0255, Lloyd (2016) doi:10.1111/bij.12746, and Hopkins and St John (2018) doi:10.1098/rspb.2018.1784. This also includes the GED correction from Lehmann et al. (2019) doi:10.1111/pala.12430. Multiple functions implement morphospace plots: plot_chronophylomorphospace() implements Sakamoto and Ruta (2012) doi:10.1371/journal.pone.0039752, plot_morphospace() implements Wills et al. (1994) doi:10.1017/S009483730001263X, plot_changes_on_tree() implements Wang and Lloyd (2016) doi:10.1098/rspb.2016.0214, and plot_morphospace_stack() implements Foote (1993) doi:10.1017/S0094837300015864. Other functions include safe_taxonomic_reduction(), which implements Wilkinson (1995) doi:10.1093/sysbio/44.4.501, map_dollo_changes() implements the Dollo stochastic character mapping of Tarver et al. (2018) doi:10.1093/gbe/evy096, and estimate_ancestral_states() implements the ancestral state options of Lloyd (2018) doi:10.1111/pala.12380. calculate_tree_length() and reconstruct_ancestral_states() implements the generalised algorithms from Swofford and Maddison (1992; no doi).
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-05-10
- WARNING12 OK, 1 WARNING2026-05-09
- OK14 OK2026-03-10
Documentation
- Help pages
- 92includes a package overview page
- Examples that run
- 94%84 run in a plain check · 4 only when donttest examples are enabled (R CMD check --as-cran) · 1 never run
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 89%
- Help pages citing references
- 39%
Downloads
Dependencies
Installing Claddis adds 41 packages (21 with compiled code, 21 MB of source tarballs). Heaviest: igraph 4.8 MB, maps 2.2 MB, phangorn 1.9 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- RR 4.5.0 released · 2025-04-11
- 0.7.0Latest2024-09-03 · current release · diff ↗ ·
removed 3 exports
compactify_matrix, map_stochastic_changes, pattern:^[[:alpha:]]+added 52 exports
add_polymorphisms_to_costmatrix, add_uncertainties_to_costmatrix, calculate_g, calculate_gmax, calculate_kardashian_index, calculate_MPD, calculate_tree_length, calculate_WMPD, check_cladisticMatrix, check_costMatrix, check_stateGraph, check_taxonGroups, check_timeBins, classify_costmatrix, compactify_cladistic_matrix, convert_adjacency_matrix_to_costmatrix, convert_costmatrix_to_stategraph, convert_state_tree_to_adjacency_matrix, convert_stategraph_to_costmatrix, count_cherries, drop_time_tip, estimate_squared_change_ancestors, find_costmatrix_minimum_span, find_shortest_costmatrix_path, find_stategraph_minimum_span, find_time_bin_midpoints, find_unique_trees, fix_costmatrix, is_graph_connected, is.cladisticMatrix and 22 more - RR 4.4.0 released · 2024-04-24
- RR 4.3.0 released · 2023-04-21
- RR 4.2.0 released · 2022-04-22
- RR 4.1.0 released · 2021-05-18
- 0.6.3
- 0.6.12020-08-27 · diff ↗ ·
removed 31 exports
AncStateEstMatrix, BlockAligner, ChangesInBins, ChronoPhyloMorphospacePlot, CompactifyMatrix, CorrectRootTime, DiscreteCharacterRate, DolloSCM, EdgeLengthsInBins, EdgeMatch, FindAncestor, FindLinkedEdges, GetAllStateChanges, GetDescendantEdges, GetNodeAges, MakeMorphMatrix, MatrixPruner, MinSpanTreeEdges, MorphDistMatrix, MorphMatrix2PCoA, MorphospacePlot, MultiMorphospacePlot, PhyloCharCompletenessInBins, PlotCharacterChanges, ReadMorphNexus, SafeTaxonomicReduction, SafeTaxonomicReinsertion, StackPlot, TrimMorphDistMatrix, WriteMorphNexus and 1 moreadded 36 exports
align_matrix_block, assign_taxa_to_bins, bin_changes, bin_character_completeness, bin_edge_lengths, build_cladistic_matrix, calculate_morphological_distances, compactify_matrix, date_nodes, estimate_ancestral_states, find_descendant_edges, find_linked_edges, find_minimum_spanning_edges, find_mrca, fix_root_time, map_dollo_changes, map_stochastic_changes, match_tree_edges, ordinate_cladistic_matrix, partition_time_bins, plot_changes_on_tree, plot_chronophylomorphospace, plot_morphospace, plot_morphospace_stack, plot_multi_morphospace, plot_rates_character, plot_rates_time, plot_rates_tree, prune_cladistic_matrix, read_nexus_matrix and 6 more - RR 4.0.0 released · 2020-04-24
- 0.3.4
- RR 3.6.0 released · 2019-04-26
- unarchivedReturned to CRAN2019-02-12
- 0.3.02019-02-12 · diff ↗ ·
added 24 exports
ChangesInBins, ChronoPhyloMorphospacePlot, CompactifyMatrix, CorrectRootTime, DiscreteCharacterRate, DolloSCM, EdgeLengthsInBins, EdgeMatch, FindLinkedEdges, GetAllStateChanges, GetDescendantEdges, GetNodeAges, MakeMorphMatrix, MatrixPruner, MinSpanTreeEdges, MorphMatrix2PCoA, MorphospacePlot, MultiMorphospacePlot, PhyloCharCompletenessInBins, PlotCharacterChanges, SafeTaxonomicReinsertion, StackPlot, WriteMorphNexus, WriteMorphTNT - RR 3.5.0 released · 2018-04-23
- RR 3.4.0 released · 2017-04-21
Show 4 earlier eventsHide 4 earlier events
- RR 3.3.0 released · 2016-05-03
- archivedRemoved from CRAN2015-10-29check problems were not corrected despite reminders
- 0.12015-04-28
- RR 3.2.0 released · 2015-04-16
Package metadata
- First published
- 2015-04-28
- Total releases
- 6 / 11 yrs
- License
- GPL (>= 2) OSI
- Minimum R
- ≥ 3.5.0
- Bundled data
- 2.8 KB / 3 files
- Download size
- 890 KB
Cite
Cite this package
Run in R for the authors' entry:
citation("Claddis")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.1111/bij.12746, 10.1111/pala.12380, 10.1111/pala.12430.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-25, which the citation names so these numbers can be found later. More on citing and the projects behind them.