Learn R Programming

⚠️There's a newer version (0.7.0) of this package.Take me there.

Claddis

Claddis is an R package designed to import cladistic-type data sets (#NEXUS format) into R and perform disparity analysis and rate tests.

Package status

Travis release version

Travis development version

CRAN

Version

Claddis is on CRAN (version 0.6.1) but is also being developed on GitHub. To get the absolute latest version you can use:

if(!require(devtools)) install.packages("devtools", dependencies = TRUE)
devtools::install_github("graemetlloyd/Claddis", ref = "master")

However, installing a development version of a package is only recommended for expert users.

Please also consult the CHANGELOG file for all updates (including new functions, features and bug fixes) to Claddis.

Installation

You can install Claddis in R via CRAN with:

install.packages("Claddis", dependencies = TRUE)

Or from GitHub with:

if(!require(devtools)) install.packages("devtools", dependencies = TRUE)
devtools::install_github("graemetlloyd/Claddis", ref = "CRAN")

And load it into memory using:

library(Claddis)

Help

Basic help can be found with:

?Claddis

And clicking on the Index link at the base of the help file will reveal links to every available function.

Tutorials

Note that I have previously linked to tutorials for the package here, but substantial reworking of the core code means these will no longer work and so currently the example code in each function's help file is the best substitute for this. New tutorials will eventually be produced and shared here.

Users should also be aware of the dispRity R package, that can form the end of a Claddis disparity pipeline.

Citation

The first formal paper describing Claddis was published as Lloyd (2016):

Lloyd, G. T., 2016. Estimating morphological diversity and tempo with discrete character-taxon matrices: implementation, challenges, progress, and future directions. Biological Journal of the Linnean Society, 118, 131-151.

The effects of ancestral state estimation choices on phylomorphospaces was discussed in Lloyd (2018):

Lloyd, G. T., 2018. Journeys through discrete-character morphospace: synthesizing phylogeny, tempo, and disparity. Palaeontology, 61, 637-645.

Copy Link

Version

Install

install.packages('Claddis')

Monthly Downloads

583

Version

0.6.3

License

GPL (>= 2)

Maintainer

Graeme T. Lloyd

Last Published

September 26th, 2020

Functions in Claddis (0.6.3)

assign_taxa_to_bins

Assign taxa to time bins
map_stochastic_changes

Finds all state changes on a tree using stochastic character mapping
plot_morphospace

Plot Morphopace
trim_matrix

Trims a morphological distance matrix
plot_morphospace_stack

Plot stacked ordination spaces
trim_marginal_whitespace

Trims marginal whitespace
bin_changes

Counts the changes in a series of time bins
fix_root_time

Fixes root.time after taxa have been pruned from a tree
plot_multi_morphospace

Plot Multiple Morphopaces
gauthier_1986

Character-taxon matrix from Gauthier 1986
plot_rates_character

Visualize a rate test time series
Claddis-package

Measuring Morphological Diversity and Evolutionary Tempo
bin_character_completeness

Phylogenetic character completeness in time-bins
align_matrix_block

Aligns a phylogenetic matrix block
bin_edge_lengths

Edge-lengths present in time-bins
print.cladisticMatrix

Compact display of a cladistic matrix
find_descendant_edges

Gets descendant edges of an internal node
estimate_ancestral_states

Ancestral Character State Estimation
day_2016

Character-taxon matrix from Day et al. 2016
prune_cladistic_matrix

Prunes a character matrix of characters or taxa
find_linked_edges

Find linked edges for a tree
match_tree_edges

Edge matching function
plot_changes_on_tree

Plots character changes on branches
date_nodes

Returns node ages for a time-scaled tree
compactify_matrix

Collapses matrix to unique character state distributions
read_nexus_matrix

Reads in a morphological #NEXUS data file
safe_taxonomic_reduction

Safe Taxonomic Reduction
plot_chronophylomorphospace

Chronophylomorphospace Plot
find_minimum_spanning_edges

Get edges of minimum spanning tree
michaux_1989

Character-taxon matrix from Michaux 1989
plot_rates_time

Visualize a rate test time series
find_mrca

Find ancestor
ordinate_cladistic_matrix

Principal Coordinates on a Cladistic Matrix
partition_time_bins

Time bin partitioner
write_tnt_matrix

Writes out a morphological TNT data file
write_nexus_matrix

Writes out a morphological #NEXUS data file
plot_rates_tree

Visualize a rate test time series
safe_taxonomic_reinsertion

Reinsert Safely Removed Taxa Into A Tree
test_rates

Discrete character rates across trees, time, and character types
calculate_morphological_distances

Get distance matrices from a cladistic matrix
build_cladistic_matrix

Creates a morphological data file from a matrix
map_dollo_changes

Stochastic Character Map For Dollo Character