Skip to content

R package ChronochRt - building chronological charts easily with R

License

Notifications You must be signed in to change notification settings

archaeothommy/chronochrt

Repository files navigation

ChronochRt

R-CMD-check Codecov test coverage CRAN_Status_Badge CRAN_downloads DOI

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.

About

R package ChronochRt - building chronological charts easily with R

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages