Learn R Programming

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