Overview
An easy way to examine archaeological count data. This package provides several tests and measures of diversity: heterogeneity and evenness (Brillouin, Shannon, Simpson, etc.), richness and rarefaction (Chao1, Chao2, ACE, ICE, etc.), turnover and similarity (Brainerd-Robinson, etc.). It allows to easily visualize count data and statistical thresholds: rank vs. abundance plots, heatmaps, Ford (1962) and Bertin (1977) diagrams, etc. tabula provides methods for:
- Diversity measurement:
heterogeneity()
,evenness()
,richness()
,rarefaction()
,turnover()
. - Similarity measurement and co-occurrence:
similarity()
,occurrence()
. - Assessing sample size and significance:
bootstrap()
,jackknife()
,simulate()
. - Bertin (1977) or Ford (1962) (battleship curve) diagrams:
plot_bertin()
,plot_ford()
. - Seriograph (Desachy 2004):
seriograph()
,matrigraph()
. - Heatmaps:
plot_heatmap()
,plot_spot()
.
kairos is a companion package to tabula that provides functions for chronological modeling and dating of archaeological assemblages from count data.
To cite tabula in publications use:
Frerebeau N (2019). "tabula: An R Package for Analysis, Seriation,
and Visualization of Archaeological Count Data." _Journal of Open
Source Software_, *4*(44). doi:10.21105/joss.01821
<https://doi.org/10.21105/joss.01821>.
Frerebeau N (2023). _tabula: Analysis and Visualization of
Archaeological Count Data_. Université Bordeaux Montaigne, Pessac,
France. doi:10.5281/zenodo.1489944
<https://doi.org/10.5281/zenodo.1489944>, R package version 3.0.1,
<https://packages.tesselle.org/tabula/>.
This package is a part of the tesselle project
<https://www.tesselle.org>.
Installation
You can install the released version of tabula from CRAN with:
install.packages("tabula")
And the development version from GitHub with:
# install.packages("remotes")
remotes::install_github("tesselle/tabula")
Usage
It assumes that you keep your data tidy: each variable (type/taxa) must be saved in its own column and each observation (sample/case) must be saved in its own row.
## Data from Lipo et al. 2015
data("mississippi", package = "folio")
## Ford diagram
plot_ford(mississippi)
## Co-occurrence of ceramic types
mississippi |>
occurrence() |>
plot_spot()
Contributing
Please note that the tabula project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.