Release:
Development (master):
CRAN:
Check out the paper associated with the first version of this package.
Check out the presentation or the video of some of the package's features.
install.packages("dispRity")
library(dispRity)
The package is also available in the phylotastic r-universe or through the phylogenetics CRAN Task View.
You can also install the piping hot development version (not always recommended!) by installing the package directly through github:
if(!require(devtools)) install.packages("devtools")
library(devtools)
install_github("TGuillerme/dispRity")
library(dispRity)
See the patch notes for the latest developments.
A detailed vignette is available online or as a pdf:
Otherwise, each functions has a detailed associated manual with examples in R
(?which.function
).
Additionally, you can learn more about the structure of dispRity
objects here.
You can download the workshop follow-along sheet here (use right click > save link as...) or visualise it in html here.
Not sure what disparity metric to use?
Not sure what a disparity metric is in the first place?
Check out this paper on selecting the best metric for your specific question in Ecology and Evolution or the moms
shiny app.
You can also find more information in the dispRity
manual.
Read the full patch note here.
- Added the dispRity.multi internal architecture now allowing users to work with different matrices and different trees as inputs for
custom.subsets
,chrono.subsets
,boot.matrix
anddispRity
. This change is not affecting the user level appart from now allowing to bypass some error messages (thanks to Mario Corio for that obvious suggestion). - New statistical test:
pgls.dispRity
to run PGLS test on adispRity
object with a level-2 metric and a tree (using excellentphylolm
algorithm). The new test comes with its own S3 print, summary and plot functions if the inputdispRity
data contains multiple trees or multiple matrices (running and handling the output of multiplephylolm
). - New vignette compiling resources for developers to help people (and future me) to edit the package.
- And many more new additions, improvements and couple of bug fixes!
- NOTE there are now changes in the following function names:
ellipse.volume
is nowellipsoid.volume
;rescale.dispRity
is nowscale.dispRity
andrandtest.dist
is nowdistance.randtest
(the old aliases still work).
Previous patch notes and notes for the next version can be seen here.
Dave Bapst, Mario Corio, Armin Elsler, Graeme Lloyd (Request #104), Jari Oksanen (Request #85), Emmanuel Paradis, Abigail Pastore, Ashley Reaney, Gavin Thomas.
If you are using this package, please cite the paper:
- Guillerme, T. (2018) dispRity: a modular R package for measuring disparity. Methods in Ecology and Evolution. doi:10.1111/2041-210X.13022
Also don't forget to cite R
and consider citing the ape
package since dispRity
heavily relies on it (and, generally, cite all the R
packages you use!):
- Paradis E. & Schliep K. (2019). ape 5.0: an environment for modern phylogenetics and evolutionary analyses in R. Bioinformatics 35: 526-528.
- R Core Team (2020). R: A language and environment for statistical computing. R Foundation for Statistical Computing, Vienna, Austria. URL https://www.R-project.org/.
To cite the dispRity
manual, please use:
- Guillerme, T. & Cooper, N. (2018) dispRity manual. figshare. Preprint. 10.6084/m9.figshare.6187337.v1
To cite the time slicing method from the chrono.subsets
function, please use:
- Guillerme, T. & Cooper, N. (2018) Time for a rethink: time sub‐sampling methods in disparity‐through‐time analyses. Palaeontology, 61: 481-493. doi:10.1111/pala.12364
I have been developping this package while being hired succesively by these people (thanks a lot for supporting me develop this package, sometimes as a side project): Natalie Cooper, Martin Brazeau, Vera Weisbecker and Gavin Thomas.
If you use the dispRity
pacakge for morphological disparity analyses, you should also check the excellent Claddis
package!
The dispRity
package was cited in these papers. Below is a list of specific papers using specific functionalities. These papers do not only use the functionalities highlighted here (and the author do much more awesome science!) but this is just a list of references if you want an independent guide on how to use these functions:
- Ezcurra MD, Montefeltro FC, Pinheiro FL, Trotteyn MJ, Gentil AR, Lehmann OE, Pradelli LA. The stem-archosaur evolutionary radiation in South America. Journal of South American Earth Sciences. 2020 Oct 7:102935. Journal of South American Earth Sciences. 2020 DOI: 10.1016/j.jsames.2020.102935
- Godoy PL. Crocodylomorph cranial shape evolution and its relationship with body size and ecology. Journal of Evolutionary Biology. 2020 DOI: 10.1111/jeb.13540
- Schaeffer J, Benton MJ, Rayfield EJ, Stubbs TL. Morphological disparity in theropod jaws: comparing discrete characters and geometric morphometrics. Palaeontology. 2020. DOI: 10.1111/pala.12455
- Heggli OA, Cabral J, Konvalinka I, Vuust P, Kringelbach ML. A Kuramoto model of self-other integration across interpersonal synchronization strategies. PLoS computational biology. 2019 DOI:10.1371/journal.pcbi.1007422
- Esquerré D, Donnellan S, Brennan IG, Lemmon AR, Lemmon EM, Zaher H, Grazziotin FG, Keogh JS. Phylogenomics, biogeography and morphometrics reveal rapid phenotypic evolution in pythons after crossing Wallace’s line. Systematic Biology. 2019 DOI: 10.1093/sysbio/syaa024
- de Oca-Aguilar AC, De Luna E, Rebollar-Téllez EA, Piermarini PM, Ibáñez-Bernal S. Morphological discontinuous variation and disparity in Lutzomyia (Tricholateralis) cruciata Coquillett, 1907 are not related to contrasting environmental factors in two biogeographical provinces. Zoomorphology. 2019 DOI:10.1007/s00435-019-00450-8
- Skeels A, Dinnage R, Medina I, Cardillo M. Ecological interactions shape the evolution of flower color in communities across a temperate biodiversity hotspot Evolution Letters 2021 10.1002/evl3.225
- Taverne M, Fabre AC, King‐Gillies N, Krajnović M, Lisičić D, Martin L, Michal L, Petricioli D, Štambuk A, Tadić Z, Vigliotti C. Diet variability among insular populations of Podarcis lizards reveals diverse strategies to face resource‐limited environments. Ecology and Evolution. 2019 DOI:10.1002/ece3.5626.
Disparity analyses jointly using the dispRity
and Claddis
packages
- Wang M, Lloyd GT, Zhang C, Zhou Z. The patterns and modes of the evolution of disparity in Mesozoic birds. Proceedings of the Royal Society B. 2021 DOI:10;288(1944):20203105