Get Started

Start using the tesselle packages.

Download and install

The tesselle packages can be downloaded and installed from CRAN.

A meta-package, called tesselle, lets you download and install the project’s packages with a single R command:

install.packages("tesselle")

Thanks to the R-universe project powered by rOpenSci, tesselle has its own CRAN-like repository: tesselle.r-universe.dev. This repository allows to install all versions and non-CRAN packages (e.g. WIP packages and large data packages). If you want to download and install a package from it, simply use install.packages() and specify the repository URL:

## Enable the repository globally
options(repos = c(tesselle = "https://tesselle.r-universe.dev",
                  CRAN = "https://cloud.r-project.org"))

## Install some packages
install.packages(c("tabula", "kairos"))

Use

Using the library() function, you can then attach the core tesselle packages:

#> --- Attaching packages -------------------------------------- tesselle 1.6.0 ---
#> * dimensio    0.14.0
#> * isopleuros  1.4.0
#> * kairos      2.3.0
#> * nexus       0.5.0
#> * tabula      3.3.1

The core packages are designed to work seamlessly together and can be used to explore and analyse common data types in archaeology:

  • tabula allows for the examination of archaeological count data. It provides several tests and measures of diversity. This package makes it easy to visualize count data and statistical thresholds: rank-abundance plots, heatmaps, Ford and Bertin diagrams.
  • kairos provides a toolkit for absolute dating and the analysis of chronological patterns. This package includes functions for chronological modeling and dating of archaeological assemblages from count data (e.g. matrix seriation).
  • nexus allows for the exploration and analysis of compositional data. It provides tools for chemical fingerprinting and source tracking of ancient materials by chemical composition.
  • dimensio offers methods to compute, extract, summarize and visualize results of simple multivariate data analysis (Principal Components Analysis and Correspondence Analysis).
  • isopleuros enables the creation of ternary plots and includes common ternary diagrams useful for archaeologists (e.g., soil texture charts, ceramic phase diagrams).

Additionally, companion packages complement these core packages for specific tasks, such as data visualization or preparation, and can be installed separately:

  • khroma provides accessible colour schemes tailored for each type of data (qualitative, diverging, or sequential).
  • alkahest is a toolbox for preprocessing XY data from experimental methods (i.e., any signal that can be measured along a continuous variable): it provides methods for baseline estimation and correction, smoothing, normalization, etc.
  • folio offers several datasets related to broad topics in archaeology and paleontology, which can be used to illustrate statistical methods in the classroom.

How to cite

If you use the tesselle packages in your publications, you must report and cite them properly (as with any other research software) to ensure transparency and reproducibility of your results. By doing so, published results are linked to a particular version of the software, ensuring traceability in case an error is discovered later.

Citing packages can encourage further development and improvement of these tools. Package authors and maintainers are more likely to continue their work if they see that it’s being used and valued by the research community. By citing their work, you’re providing a form of recognition, giving package authors and contributors proper credit for their time and efforts.

Use the citation() function for information on how to cite the base R system or any non-base package:

## Get the basic R reference
citation()
#> To cite R in publications use:
#> 
#>   R Core Team (2025). _R: A Language and Environment for Statistical
#>   Computing_. R Foundation for Statistical Computing, Vienna, Austria.
#>   <https://www.R-project.org/>.
#> 
#> A BibTeX entry for LaTeX users is
#> 
#>   @Manual{,
#>     title = {R: A Language and Environment for Statistical Computing},
#>     author = {{R Core Team}},
#>     organization = {R Foundation for Statistical Computing},
#>     address = {Vienna, Austria},
#>     year = {2025},
#>     url = {https://www.R-project.org/},
#>   }
#> 
#> We have invested a lot of time and effort in creating R, please cite it
#> when using it for data analysis. See also 'citation("pkgname")' for
#> citing R packages.
## Get the reference of the tesselle meta-package
citation("tesselle")
#> To cite tesselle in publications use:
#> 
#>   Frerebeau N (2024). "The tesselle Project: a Collection of R Packages
#>   for Research and Teaching in Archaeology." _Advances in
#>   Archaeological Practice_, *12*(4), 424-430. doi:10.1017/aap.2024.10
#>   <https://doi.org/10.1017/aap.2024.10>.
#> 
#>   Frerebeau N (2025). _tesselle: Easily Install and Load 'tesselle'
#>   Packages_. Université Bordeaux Montaigne, Pessac, France.
#>   doi:10.5281/zenodo.6500491 <https://doi.org/10.5281/zenodo.6500491>,
#>   R package version 1.6.0, <https://packages.tesselle.org/tesselle/>.
#> 
#> This package is a part of the tesselle project
#> <https://www.tesselle.org>.
#> 
#> To see these entries in BibTeX format, use 'print(<citation>,
#> bibtex=TRUE)', 'toBibtex(.)', or set
#> 'options(citation.bibtex.max=999)'.