
<!-- README.md is generated from README.Rmd. Please edit that file -->

# tesselle <img width=120px src="man/figures/logo.png" align="right" />

<!-- badges: start -->

<a href="https://ci.codeberg.org/repos/14698" class="pkgdown-devel"><img
src="https://ci.codeberg.org/api/badges/14698/status.svg"
alt="status-badge" /></a>
<a href="https://packages.tesselle.org/tesselle/coverage/"
class="pkgdown-devel"><img
src="https://packages.tesselle.org/tesselle/coverage/badge.svg"
alt="Code coverage" /></a>
<a href="https://cran.r-project.org/package=tesselle"
class="pkgdown-devel"><img
src="https://tinyverse.netlify.app/badge/tesselle"
alt="Dependencies" /></a>

<a href="https://tesselle.r-universe.dev/tesselle"
class="pkgdown-devel"><img
src="https://tesselle.r-universe.dev/badges/tesselle"
alt="r-universe" /></a>
<a href="https://cran.r-project.org/package=tesselle"
class="pkgdown-release"><img
src="https://www.r-pkg.org/badges/version/tesselle"
alt="CRAN Version" /></a> <a
href="https://cran.r-project.org/web/checks/check_results_tesselle.html"
class="pkgdown-release"><img
src="https://badges.cranchecks.info/worst/tesselle.svg"
alt="CRAN checks" /></a>
<a href="https://cran.r-project.org/package=tesselle"
class="pkgdown-release"><img
src="https://cranlogs.r-pkg.org/badges/tesselle"
alt="CRAN Downloads" /></a>

[![Project Status: Active – The project has reached a stable, usable
state and is being actively
developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.6500491.svg)](https://doi.org/10.5281/zenodo.6500491)
[![SWH](https://archive.softwareheritage.org/badge/origin/https://codeberg.org/tesselle/tesselle/)](https://archive.softwareheritage.org/browse/origin/?origin_url=https://codeberg.org/tesselle/tesselle)
<!-- badges: end -->

## Overview

The [tesselle](https://www.tesselle.org/) suite is a collection of
packages for research and teaching in archaeology. These packages focus
on quantitative analysis methods developed for archaeology. The tesselle
packages are designed to work seamlessly together and to complement
general-purpose and other specialized statistical packages. These
packages can be used to explore and analyze common data types in
archaeology: [count data](https://packages.tesselle.org/tabula/),
[compositional data](https://packages.tesselle.org/nexus/) and
[chronological data](https://packages.tesselle.org/kairos/).

The **tesselle** package is designed to make it easy to install and load
key packages from the tesselle suite in a single step.

------------------------------------------------------------------------

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 (2026). *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.7.0, <https://packages.tesselle.org/tesselle/>.

This package is a part of the tesselle project
<https://www.tesselle.org>.

## Installation

You can install the released version of **tesselle** from
[CRAN](https://CRAN.R-project.org) with:

``` r
install.packages("tesselle")
```

And the development version from [Codeberg](https://codeberg.org/) with:

``` r
# install.packages("remotes")
remotes::install_git("https://codeberg.org/tesselle/tesselle")
```

## Usage

`library(tesselle)` will load the core packages:

- [**tabula**](https://packages.tesselle.org/tabula/): analysis and
  visualization of archaeological count data;
- [**kairos**](https://packages.tesselle.org/kairos/): analysis of
  chronological patterns from archaeological count data;
- [**nexus**](https://packages.tesselle.org/nexus/): analysis of
  compositional data;

And two companion packages:

- [**dimensio**](https://packages.tesselle.org/dimensio/): multivariate
  analysis;
- [**isopleuros**](https://packages.tesselle.org/isopleuros/): ternary
  plots.

``` r
library(tesselle)
#> --- Attaching packages -------------------------------------- tesselle 1.7.0 ---
#> * dimensio    0.14.1
#> * isopleuros  1.4.0
#> * kairos      2.3.0
#> * nexus       0.6.0
#> * tabula      3.3.2
```

## Contributing

Please note that the **tesselle** project is released with a
[Contributor Code of Conduct](https://www.tesselle.org/conduct.html). By
contributing to this project, you agree to abide by its terms.
