README.md

In chronochrt: Creating Chronological Charts

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_gitlab("archaeothommy/chronochrt")

Please help us to improve ChronochRt by filing observed bugs as an issue here.

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 here.

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

• Cheatsheet
• Vignettes

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.

chronochrt documentation built on May 29, 2024, 8:10 a.m.