Learn R Programming

⚠️There's a newer version (0.1.5) of this package.Take me there.

ChronochRt

ChronochRt offers an easy way to draw chronological charts from tables. It aims to provide an intuitive environment for anyone new to R and includes ggplot2 geoms and theme for chronological charts.

Installation

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

install.packages("chronochrt")

or install the development version with the newest bugfixes and features from gitlab with:

 devtools::install_github("archaeothommy/chronochrt")

You are very welcome to contribute to the package through forking the repository or creating an issue to suggest changes.

Features

  • Slim structure of chronological datasets
  • Import tabular data files
  • Import Excel files (requires the package readxl)
  • Possibility to display up to 2 chronological systems within the same region (e.g. long and short chronologies)
  • Layout of the chronological chart optimised for easy readability and comprehensibility
  • Years in BCE must be negative - that’s all you need to care about dates
  • Handling of insecure dates
  • Handling of gaps, e.g. abandonment phases of sites
  • Optional text labels
  • Optional image labels to e.g. display key finds or show typological developments
  • Geoms for the chronological chart and image labels
  • Export of the chronological chart in different file formats (raster and vector graphics)
  • Easy customisation of the chronological chart
  • Based on the tidyverse: Seamless integration in pipes, enhanced customisation with ggplot2

Is there a feature missing? Please let us know by creating an issue.

Example

library(ChronochRt)

data <- add_chron(region = "A",
                  name = c("A", "A1", "A2", "B"),
                  start = c(-200, -200, 0, -100),
                  end = c(200, 0, 200, 100),
                  level = c(1,2,2,1),
                  add = FALSE,
                  new_table = TRUE)

plot_chronochrt(data)

Getting started

Funding for the development of ChronochRt 0.0.5

This project has received funding from the European Union’s Horizon 2020 research and innovation programme under the Marie Skłodowska-Curie grant agreement No 766311.

Copy Link

Version

Install

install.packages('chronochrt')

Monthly Downloads

233

Version

0.1.4

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Thomas Rose

Last Published

November 22nd, 2025

Functions in chronochrt (0.1.4)

plot_chronochrt

Plot a chronological chart
add_label_image

Provide image labels for a chronological chart
theme_chronochrt

The ChronochRt ggplot theme
chronochrt-package

ChronochRt
geom_chronochRtImage

Add image labels to plot
convert_to_chron

Prepare an existing data set for plotting
import_chron

Import data for Chronological chart
add_label_text

Provide text labels for a chronological chart
geom_chronochRt

A chronological chart
corr_xmax

Determine maximum x value of parallel chrons
add_chron

Create or add chronological data
arrange_regions

Arranging the regions (sections) of a chronological chart
%>%

Pipe operator
import_chron_delim

Import chronological information from other delimited files
import_chron_csv

Import chronological information from .csv files
import_chron_excel

Import chronological information from excel files