Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ropensci/fellingdater
A suite of functions designed to assist dendrochronologists in inferring estimates for felling dates, derived from dated tree-ring series.
https://github.com/ropensci/fellingdater
dendrochronology r r-package rstats sapwood tree-rings
Last synced: 3 months ago
JSON representation
A suite of functions designed to assist dendrochronologists in inferring estimates for felling dates, derived from dated tree-ring series.
- Host: GitHub
- URL: https://github.com/ropensci/fellingdater
- Owner: ropensci
- License: mit
- Created: 2020-06-30T19:30:03.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-16T20:01:32.000Z (7 months ago)
- Last Synced: 2024-04-17T20:05:26.305Z (7 months ago)
- Topics: dendrochronology, r, r-package, rstats, sapwood, tree-rings
- Language: R
- Homepage: https://docs.ropensci.org/fellingdater/
- Size: 39.2 MB
- Stars: 7
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.Rmd
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- open-sustainable-technology - fellingdater - A suite of functions designed to assist dendrochronologists in inferring estimates for felling dates, derived from dated tree-ring series. (Biosphere / Forest Modeling and Analysis)
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# `fellingdater`: Estimate, report and combine felling dates of historical tree-ring series
[](https://github.com/ropensci/fellingdater/actions/workflows/R-CMD-check.yaml) [](https://github.com/ropensci/software-review/issues/618) [](https://ropensci.r-universe.dev)
[](https://zenodo.org/doi/10.5281/zenodo.11186274)
[](https://joss.theoj.org/papers/3db8c54ec854b575bf5450336ccb000b)
This R-package offers a suite of functions designed to assist dendrochronologists in inferring estimates for felling dates, derived from dated tree-ring series. The presence of partially preserved sapwood (*sw*) allows to estimate the missing number of sapwood rings, and to report an interval in which the actual felling date (*fd*) likely falls.
This procedure can be applied to individual series as well as to a collection of timbers.
In cases where it can be assumed that a group of historical timbers were all felled simultaneously (i.e., in the same year), but due to the absence of the bark/cambial zone (waney edge) and the final formed tree ring, this cannot be determined, the preserved sapwood rings can be used to establish a date range for the felling event.
Taking into account the observed number of sapwood rings across all analysed samples and combining them into a single estimate, a more accurate and precise estimation of the felling date year for the group of timbers under study is likely to be obtained.
An additional function offers a tool for summing sapwood probability distributions, comparable to 'summed probability densities (SPD)' commonly applied to sets of radiocarbon (^14^C) dates.
## Installation
You can install the latest release of `fellingdater` from [GitHub](https://github.com/ropensci/fellingdater/) or [R-universe](https://ropensci.r-universe.dev/fellingdater):
``` r
# install.packages("pak")
pak::pak("ropensci/fellingdater")
```
``` r
install.packages("fellingdater", repos = "https://ropensci.r-universe.dev")
```
## Basic example
In the following example the combined felling date range for a set of five dated tree-ring series is computed:
```{r basic-example}
library(fellingdater)
## a data set where all series have partially preserved sapwood:
trs_example1
```
```{r example}
sw_combine(trs_example1, plot = TRUE)
```
The light grey distributions represent the probability density function of the felling date range for each individual series. The dark grey distribution is the combined estimate for a common felling date.
The sapwood model used in the example above to estimate the felling date range, was published by [Hollstein (1980)](https://search.worldcat.org/nl/title/6391864):
```{r model_sapwood_counts, dpi=200}
sw_model("Hollstein_1980", plot = TRUE)
```
## Getting started
You can find an overview of the **main functions** and **sapwood datasets** distributed with the package in the [documentation](https://docs.ropensci.org/fellingdater/reference/).
Some practical examples are provided in the [`Get started`](https://docs.ropensci.org/fellingdater/articles/getting_started.html) vignette.
## The workflow
The `fellingdater`-package allows to fully document the methodology to establish a felling date -- for a single timber or a group of timbers -- making the whole procedure reproducible. It assists in building standardized workflows when applied to large datasets of historical tree-ring series originating from geographically distinct regions. The package is designed to offer several functions related to each step in the (generalized) workflow when working with tree-ring series from (pre-)historical objects or constructions.
## Motivation & citation
This package was developed during the analysis of a large data set of tree-ring series originating from medieval timber constructions in [Bruges](https://en.wikipedia.org/wiki/Bruges) (Belgium). The results of this study were published in [*Dendrochronologia*](https://www.journals.elsevier.com/dendrochronologia).
Please cite these papers when using the `fellingdater` package:
>Kristof HANECA [](https://orcid.org/0000-0002-7719-8305) 2024. _fellingdater_: a toolkit to estimate, report and combine felling dates derived from historical tree-ring series. *Journal of Open Source
Software*, 9(97), 6716.\
>
> Kristof HANECA [](https://orcid.org/0000-0002-7719-8305), Vincent DEBONNE [](https://orcid.org/0000-0003-4536-146X), Patrick HOFFSUMMER 2020. The ups and downs of the building trade in a medieval city: tree-ring data as proxies for economic, social and demographic dynamics in Bruges (*c.* 1200 -- 1500). *Dendrochronologia* 64, 125773.\
>
## Comments and contributions
- Please report any issues or bugs here: .
- Get citation information for `fellingdater` in R typing `citation(package = 'fellingdater')`.
- Please note that the `fellingdater` package is released with a [Contributor Code of Conduct](https://github.com/ropensci/fellingdater/blob/main/.github/CONTRIBUTING.md). By contributing to this project, you agree to abide by its terms.