Learn R Programming

StratPal

R package for stratigraphic paleobiology modeling pipelines.

Overview

The fossil record is a joint expression of ecological, taphonomic, evolutionary, and stratigraphic processes (Holland and Patzkowsky, 2012). This package allowing to simulate biological processes in the time domain (e.g., trait evolution, fossil abundance), and examine how their expression in the rock record (stratigraphic domain) is influenced based on age-depth models, ecological niche models, and taphonomic effects. Functions simulating common processes used in modeling trait evolution or event type data such as first/last occurrences are provided and can be used standalone or as part of a pipeline. The package comes with example data sets and tutorials in several vignettes, which can be used as a template to set up one's own simulation.

Authors

Niklas Hohmann
Utrecht University
email: n.h.hohmann [at] uu.nl
Web page: uu.nl/staff/NHohmann
Orcid: 0000-0003-1559-1838

Requirements

R version >= 4.2

Installation

To install the package from CRAN, run

install.packages("StratPal")

in your R console.

Github

To install the package from GitHub, first install the remotes package by running

install.packages("remotes")

in the R console. Then, run

remotes::install_github(repo = "MindTheGap-ERC/StratPal",
                        build_vignettes = TRUE,
                        ref = "HEAD",
                        dependencies = TRUE)

to install the latest stable version of the package.

Usage

Run

library(StratPal)

to load the package. Use

browseVignettes(package = "StratPal")

to view the available vignettes (long form documentation) with use cases or visit the package webpage (mindthegap-erc.github.io/StratPal) to get started.

Contribution

For contribution guidelines see the CONTRIBUTING.md file

License

Apache 2.0, see LICENSE file for license text.

Copyright

Copyright 2024 Netherlands eScience Center and Utrecht University

Citation

To cite the package, please use both references:

Alternatively, you can also use the CITATION.cff file at the root of the repository, or citation("StratPal").

References {#References}

  • Holland, Steven M. and Patzkowsky, Mark E. "Stratigraphic Paleobiology : Understanding the Distribution of Fossil Taxa in Time and Space."" The University of Chicago Press; 2012.

This package uses data from

  • Hohmann, Niklas; Koelewijn, Joël R.; Burgess, Peter; Jarochowska, Emilia. 2024. "Identification of the mode of evolution in incomplete carbonate successions." BMC Ecology and Evolution, 24, 113. DOI: 10.1186/s12862-024-02287-2.

  • Hohmann, Niklas, Koelewijn, Joël R.; Burgess, Peter; Jarochowska, Emilia. 2023. "Identification of the Mode of Evolution in Incomplete Carbonate Successions - Supporting Data." Open Science Framework. https://doi.org/10.17605/OSF.IO/ZBPWA, published under the CC-BY 4.0 license.

Funding information

Funded by the European Union (ERC, MindTheGap, StG project no 101041077). Views and opinions expressed are however those of the author(s) only and do not necessarily reflect those of the European Union or the European Research Council. Neither the European Union nor the granting authority can be held responsible for them.

Copy Link

Version

Install

install.packages('StratPal')

Monthly Downloads

196

Version

0.4.0

License

Apache License (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Niklas Hohmann

Last Published

March 27th, 2025

Functions in StratPal (0.4.0)

p3

simulate Poisson point process
rej_samp

random numbers from rejection sampling
random_walk

simulate (un)biased random walk
snd_niche

simple niche model
plot.pre_paleoTS

plot pre-paleoTS objects
prob_remove

probabilistic removal of elements
strict_stasis_sl

simulate strict phenotypic stasis (specimen level)
thin

thin a series of events (e.g. fossil occurrences)
discrete_niche

niche from discrete data
bounded_niche

define niche from boundaries
apply_taphonomy

model taphonomic effects
ornstein_uhlenbeck_sl

simulate ornstein-uhlenbeck (OU) process (specimen level)
apply_niche

apply niche model
ornstein_uhlenbeck

simulate ornstein-uhlenbeck (OU) process
p3_var_rate

simulate variable rate Poisson point process
discrete_gradient

construct discretized gradient
StratPal-package

StratPal: Stratigraphic Paleobiology Modeling Pipelines
stasis_sl

simulate phenotypic stasis (specimen level)
scenarioA

example data, scenario A from Hohmann et al. (2024)
stasis

simulate phenotypic stasis
reduce_to_paleoTS

reduce pre-paleoTS format to paleoTS
random_walk_sl

simulate (un)biased random walk (specimen level)