Learn R Programming

kairos

Overview

A convenient and reproducible toolkit for relative and absolute dating and analysis of chronological patterns. This package includes functions for chronological modeling and dating of archaeological assemblages from count data. It provides methods for matrix seriation. It also allows to compute time point estimates and density estimates of the occupation and duration of an archaeological site. kairos provides methods for:

  • Matrix seriation: seriate_rank() and seriate_average()
  • Mean ceramic date estimation (South 1977): mcd()
  • Event and accumulation date estimation (Bellanger and Husi 2012): event()
  • Aoristic analysis (Ratcliffe 2000): aoristic()
  • Chronological apportioning (Roberts et al. 2012): apportion()

tabula is a companion package to kairos that provides functions for visualization and analysis of archaeological count data.


To cite kairos in publications use:

Frerebeau N (2024). kairos: Analysis of Chronological Patterns from Archaeological Count Data. Université Bordeaux Montaigne, Pessac, France. doi:10.5281/zenodo.5653896 https://doi.org/10.5281/zenodo.5653896, R package version 2.1.1, https://packages.tesselle.org/kairos/.

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

Installation

You can install the released version of kairos from CRAN with:

install.packages("kairos")

And the development version from GitHub with:

# install.packages("remotes")
remotes::install_github("tesselle/kairos")

Usage

## Load packages
library(kairos)
#> Loading required package: dimensio

kairos v2.0 uses aion for internal date representation. Look at vignette("aion") before you start.

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 Husi 2022
data("loire", package = "folio")
keep <- c("Anjou", "Blésois", "Orléanais", "Haut-Poitou", "Touraine")
loire <- subset(loire, area %in% keep)

## Get time range
loire_range <- loire[, c("lower", "upper")]

## Calculate aoristic sum (weights) by group
ao <- aoristic(loire_range, step = 50, weight = TRUE, groups = loire$area)

## Plot
plot(ao, col = "grey")


## Rate of change by group
ro <- roc(ao, n = 30)
plot(ro)

Contributing

Please note that the kairos project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

References

Bellanger, L., and P. Husi. 2012. “Statistical Tool for Dating and Interpreting Archaeological Contexts Using Pottery.” Journal of Archaeological Science 39 (4): 777–90. https://doi.org/10.1016/j.jas.2011.06.031.

Ratcliffe, J. H. 2000. “Aoristic Analysis: The Spatial Interpretation of Unspecific Temporal Events.” International Journal of Geographical Information Science 14 (7): 669–79. https://doi.org/10.1080/136588100424963.

Roberts, J. M., B. J. Mills, J. J. Clark, W. R. Haas, D. L. Huntley, and M. A. Trowbridge. 2012. “A Method for Chronological Apportioning of Ceramic Assemblages.” Journal of Archaeological Science 39 (5): 1513–20. https://doi.org/10.1016/j.jas.2011.12.022.

South, S. A. 1977. Method and Theory in Historical Archaeology. Studies in Archeology. New York: Academic Press.

Copy Link

Version

Install

install.packages('kairos')

Monthly Downloads

245

Version

2.1.1

License

GPL (>= 3)

Issues

Pull Requests

Stars

Forks

Last Published

July 26th, 2024

Functions in kairos (2.1.1)

RateOfChange-class

Rate of Change
permute

Rearranges a Data Matrix
mutators

Get or Set Parts of an Object
plot_event

Event Plot
plot_fit

Detection of Selective Processes
resample_event

Resample Event Dates
mcd

Mean Ceramic Date
RefinePermutationOrder-class

Partial Bootstrap CA
resample_mcd

Resample Mean Ceramic Dates
kairos-package

kairos: Analysis of Chronological Patterns from Archaeological Count Data
fit

Frequency Increment Test
seriate_refine

Refine CA-based Seriation
roc

Rate of Change
seriate_average

Correspondence Analysis-Based Seriation
seriate_rank

Reciprocal Ranking Seriation
kairos-deprecated

Deprecated Functions in kairos
series

Sampling Times
subset

Extract or Replace Parts of an Object
plot_mcd

MCD Plot
plot_time

Abundance vs Time Plot
plot_aoristic

Plot Aoristic Analysis
predict_event

Predict Event and Accumulation Dates
reexports

Objects exported from other packages
AoristicSum-class

Aoristic Sum
apportion

Chronological Apportioning
aoristic

Aoristic Analysis
PermutationOrder-class

Permutation Order
MeanDate-class

Mean Date
IncrementTest-class

Frequency Increment Test
CountApportion-class

Count Apportioning
EventDate-class

Date Model
model

Extract Model Results
data.frame

Coerce to a Data Frame
event

Event and Accumulation Dates