folio

Datasets for Teaching Archaeology and Palaeontology - :exclamation: This is a read-only mirror from https://codeberg.org/tesselle/folio

https://github.com/tesselle/folio

Science Score: 77.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 15 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    1 of 1 committers (100.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (19.1%) to scientific vocabulary

Keywords

archaeological-science archaeology datasets paleontology r-package
Last synced: 6 months ago · JSON representation ·

Repository

Datasets for Teaching Archaeology and Palaeontology - :exclamation: This is a read-only mirror from https://codeberg.org/tesselle/folio

Basic Info
Statistics
  • Stars: 14
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 7
Topics
archaeological-science archaeology datasets paleontology r-package
Created about 5 years ago · Last pushed 9 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Citation Codemeta

README.Rmd

---
output: github_document
---



```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = NULL
)
Sys.setenv(LANGUAGE = "en") # Force locale
```

# folio 


[![status-badge](https://ci.codeberg.org/api/badges/14690/status.svg)](https://ci.codeberg.org/repos/14690){.pkgdown-devel}
[![Dependencies](https://tinyverse.netlify.app/badge/folio)](https://cran.r-project.org/package=folio){.pkgdown-devel}

[![r-universe](https://tesselle.r-universe.dev/badges/folio)](https://tesselle.r-universe.dev){.pkgdown-devel}
[![CRAN Version](https://www.r-pkg.org/badges/version/folio)](https://cran.r-project.org/package=folio){.pkgdown-release}
[![CRAN checks](https://badges.cranchecks.info/worst/folio.svg)](https://cran.r-project.org/web/checks/check_results_folio.html){.pkgdown-release}
[![CRAN Downloads](https://cranlogs.r-pkg.org/badges/folio)](https://cran.r-project.org/package=folio){.pkgdown-release}

[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4476182.svg)](https://doi.org/10.5281/zenodo.4476182)


## Overview

Datasets for teaching quantitative approaches and modeling in archaeology and paleontology. This package provides several types of data related to broad topics (cultural evolution, radiocarbon dating, paleoenvironments, etc.), which can be used to illustrate statistical methods in the classroom (multivariate data analysis, compositional data analysis, diversity measurement, etc.).

This package is for teaching purposes only: some datasets may be outdated.

**When using folio, you must cite the relevant publications for each dataset (see the documentation).**

---

```{r citation, echo=FALSE, comment='', results='asis'}
cite <- utils::citation("folio")
print(cite, bibtex = FALSE)
```

## Installation

You can install the released version of **folio** from [CRAN](https://CRAN.R-project.org) with:

```{r cran-installation, eval=FALSE}
install.packages("folio")
```

And the development version from [Codeberg](https://codeberg.org/) with:

```{r gh-installation, eval=FALSE}
# install.packages("remotes")
remotes::install_git("https://codeberg.org/tesselle/folio")
```

## Usage

```{r, fig.width=5, fig.height=5, fig.align='center'}
## Arnold and Libby's Curve of Knowns
## Replicate fig. 1 from Arnold and Libby (1949)
data("arnold1949")

fit <- lm(activity_found ~ age_expected, data = arnold1949)
summary(fit)

plot(
  x = arnold1949$age_expected,
  y = arnold1949$activity_found,
  type = "p",
  pch = 16,
  xlab = "Historical age (years)",
  ylab = "Specific activity (C/m/g)",
  main = "Samples of known ages"
)
segments(
  x0 = arnold1949$age_expected,
  y0 = arnold1949$activity_found - arnold1949$activity_found_error,
  x1 = arnold1949$age_expected,
  y1 = arnold1949$activity_found + arnold1949$activity_found_error
)
segments(
  x0 = arnold1949$age_expected - arnold1949$age_expected_error,
  y0 = arnold1949$activity_found,
  x1 = arnold1949$age_expected + arnold1949$age_expected_error,
  y1 = arnold1949$activity_found
)
abline(fit, col = "red")
```

## Related Works

* [**archdata**](https://cran.r-project.org/package=archdata) includes archaeological datasets used in [*Quantitative Methods in Archaeology Using R*](https://doi.org/10.1017/9781139628730) by David L. Carlson (2017).
* [**historydata**](https://cran.r-project.org/package=historydata) includes datasets intended for historians learning R.

## Contributing

Please note that the **folio** project is released with a [Contributor Code of Conduct](https://www.tesselle.org/conduct.html). By contributing to this project, you agree to abide by its terms.

```{r metadata, include=FALSE}
## Update codemeta.json
codemetar::write_codemeta(verbose = FALSE)

## Update CITATION.cff
cff_keys <- list(
  identifiers = list(
    list(description = "The concept DOI.",
         type = "doi",
         value = "10.5281/zenodo.4476182"),
    list(description = "The versioned DOI for version 0.1.0.",
         type = "doi",
         value = "10.5281/zenodo.4476183"),
    list(description = "The versioned DOI for version 1.0.0.",
         type = "doi",
         value = "10.5281/zenodo.4537570"),
    list(description = "The versioned DOI for version 1.1.0.",
         type = "doi",
         value = "10.5281/zenodo.6523636"),
    list(description = "The versioned DOI for version 1.2.0.",
         type = "doi",
         value = "10.5281/zenodo.6993457"),
    list(description = "The versioned DOI for version 1.3.0.",
         type = "doi",
         value = "10.5281/zenodo.7267613"),
    list(description = "The versioned DOI for version 1.4.0.",
         type = "doi",
         value = "10.5281/zenodo.10708937"),
    list(description = "The versioned DOI for version 1.5.0.",
         type = "doi",
         value = "10.5281/zenodo.13643896"),
    list(description = "The versioned DOI for version 1.5.1.",
         type = "doi",
         value = "10.5281/zenodo.15450499"),
    list(description = "The CRAN DOI",
         type = "doi",
         value = "10.32614/cran.package.folio")
  )
)
cff <- cffr::cff_create("DESCRIPTION", keys = cff_keys)
if (cffr::cff_validate(cff)) cffr::cff_write(cff, outfile = "CITATION.cff")
```

Owner

  • Name: tesselle
  • Login: tesselle
  • Kind: organization
  • Location: France

A collection of R packages for archaeological research and teaching

Citation (CITATION.cff)

# --------------------------------------------
# CITATION file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# --------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "folio" in publications use:'
type: software
license: GPL-3.0-or-later
title: 'folio: Datasets for Teaching Archaeology and Paleontology'
version: 1.5.1
doi: 10.5281/zenodo.4476182
identifiers:
- description: The concept DOI.
  type: doi
  value: 10.5281/zenodo.4476182
- description: The versioned DOI for version 0.1.0.
  type: doi
  value: 10.5281/zenodo.4476183
- description: The versioned DOI for version 1.0.0.
  type: doi
  value: 10.5281/zenodo.4537570
- description: The versioned DOI for version 1.1.0.
  type: doi
  value: 10.5281/zenodo.6523636
- description: The versioned DOI for version 1.2.0.
  type: doi
  value: 10.5281/zenodo.6993457
- description: The versioned DOI for version 1.3.0.
  type: doi
  value: 10.5281/zenodo.7267613
- description: The versioned DOI for version 1.4.0.
  type: doi
  value: 10.5281/zenodo.10708937
- description: The versioned DOI for version 1.5.0.
  type: doi
  value: 10.5281/zenodo.13643896
- description: The versioned DOI for version 1.5.1.
  type: doi
  value: 10.5281/zenodo.15450499
- description: The CRAN DOI
  type: doi
  value: 10.32614/cran.package.folio
abstract: Datasets for teaching quantitative approaches and modeling in archaeology
  and paleontology. This package provides several types of data related to broad topics
  (cultural evolution, radiocarbon dating, paleoenvironments, etc.), which can be
  used to illustrate statistical methods in the classroom (multivariate data analysis,
  compositional data analysis, diversity measurement, etc.).
authors:
- family-names: Frerebeau
  given-names: Nicolas
  email: nicolas.frerebeau@u-bordeaux-montaigne.fr
  orcid: https://orcid.org/0000-0001-5759-4944
preferred-citation:
  type: manual
  title: 'folio: Datasets for Teaching Archaeology and Paleontology'
  authors:
  - family-names: Frerebeau
    given-names: Nicolas
    email: nicolas.frerebeau@u-bordeaux-montaigne.fr
    orcid: https://orcid.org/0000-0001-5759-4944
  year: '2025'
  institution:
    name: Université Bordeaux Montaigne
    address: Pessac, France
  notes: R package version 1.5.1
  url: https://packages.tesselle.org/folio/
  doi: 10.5281/zenodo.4476182
repository: https://CRAN.R-project.org/package=folio
repository-code: https://codeberg.org/tesselle/folio
url: https://packages.tesselle.org/folio/
contact:
- family-names: Frerebeau
  given-names: Nicolas
  email: nicolas.frerebeau@u-bordeaux-montaigne.fr
  orcid: https://orcid.org/0000-0001-5759-4944
keywords:
- archaeology
- archaeological-science
- paleontology
- datasets
- r-package
references:
- type: software
  title: 'R: A Language and Environment for Statistical Computing'
  notes: Depends
  url: https://www.R-project.org/
  authors:
  - name: R Core Team
  institution:
    name: R Foundation for Statistical Computing
    address: Vienna, Austria
  year: '2025'
  version: '>= 2.10'

CodeMeta (codemeta.json)

{
  "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
  "@type": "SoftwareSourceCode",
  "identifier": "folio",
  "description": "Datasets for teaching quantitative approaches and modeling in archaeology and paleontology. This package provides several types of data related to broad topics (cultural evolution, radiocarbon dating, paleoenvironments, etc.), which can be used to illustrate statistical methods in the classroom (multivariate data analysis, compositional data analysis, diversity measurement, etc.).",
  "name": "folio: Datasets for Teaching Archaeology and Paleontology",
  "relatedLink": [
    "https://packages.tesselle.org/folio/",
    "https://CRAN.R-project.org/package=folio"
  ],
  "codeRepository": "https://codeberg.org/tesselle/folio",
  "issueTracker": "https://codeberg.org/tesselle/folio/issues",
  "license": "https://spdx.org/licenses/GPL-3.0",
  "version": "1.5.1",
  "programmingLanguage": {
    "@type": "ComputerLanguage",
    "name": "R",
    "url": "https://r-project.org"
  },
  "runtimePlatform": "R version 4.5.0 (2025-04-11)",
  "provider": {
    "@id": "https://cran.r-project.org",
    "@type": "Organization",
    "name": "Comprehensive R Archive Network (CRAN)",
    "url": "https://cran.r-project.org"
  },
  "author": [
    {
      "@type": "Person",
      "givenName": "Nicolas",
      "familyName": "Frerebeau",
      "email": "nicolas.frerebeau@u-bordeaux-montaigne.fr",
      "@id": "https://orcid.org/0000-0001-5759-4944"
    }
  ],
  "funder": [
    {
      "@type": "Organization",
      "name": "Universit Bordeaux Montaigne"
    },
    {
      "@type": "Organization",
      "name": "CNRS"
    }
  ],
  "maintainer": [
    {
      "@type": "Person",
      "givenName": "Nicolas",
      "familyName": "Frerebeau",
      "email": "nicolas.frerebeau@u-bordeaux-montaigne.fr",
      "@id": "https://orcid.org/0000-0001-5759-4944"
    }
  ],
  "softwareRequirements": {
    "1": {
      "@type": "SoftwareApplication",
      "identifier": "R",
      "name": "R",
      "version": ">= 2.10"
    },
    "SystemRequirements": null
  },
  "applicationCategory": "ArchaeologicalScience",
  "isPartOf": "https://www.tesselle.org",
  "keywords": [
    "archaeology",
    "archaeological-science",
    "paleontology",
    "datasets",
    "r-package"
  ],
  "fileSize": "532.047KB",
  "citation": [
    {
      "@type": "SoftwareSourceCode",
      "datePublished": "2025",
      "author": [
        {
          "@type": "Person",
          "givenName": "Nicolas",
          "familyName": "Frerebeau"
        }
      ],
      "name": "{folio: Datasets for Teaching Archaeology and Paleontology}",
      "identifier": "10.5281/zenodo.4476182",
      "url": "https://packages.tesselle.org/folio/",
      "description": "R package version 1.5.1",
      "@id": "https://doi.org/10.5281/zenodo.4476182",
      "sameAs": "https://doi.org/10.5281/zenodo.4476182"
    }
  ],
  "developmentStatus": "https://www.repostatus.org/#active"
}

GitHub Events

Total
  • Watch event: 1
  • Push event: 4
  • Create event: 1
Last Year
  • Watch event: 1
  • Push event: 4
  • Create event: 1

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 60
  • Total Committers: 1
  • Avg Commits per committer: 60.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 8
  • Committers: 1
  • Avg Commits per committer: 8.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
nfrerebeau n****u@u****r 60
Committer Domains (Top 20 + Academic)

Dependencies

DESCRIPTION cran
  • R >= 2.10 depends