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, biostratigraphy 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 (e.g., for transforming phylogenetic trees), 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

219

Version

0.7.0

License

Apache License (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Niklas Hohmann

Last Published

November 24th, 2025

Functions in StratPal (0.7.0)

perfect_preservation

perfect taphonomic conditions
thin

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

model absence of environmental gradients
trivial_niche

trivial niche model
rej_samp

random numbers from rejection sampling
scenarioA

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

simple niche model
stasis

simulate phenotypic stasis
strict_stasis_sl

simulate strict phenotypic stasis (specimen level)
stasis_sl

simulate phenotypic stasis (specimen level)
bounded_niche

define niche from boundaries
apply_niche

apply niche model
discrete_niche

niche from discrete data
last_occ

last occurrence of taxon
ornstein_uhlenbeck

simulate ornstein-uhlenbeck (OU) process
all_preserved

Indestructible fossils
gradient_from_data

gradient or taphonomic conditions from data
StratPal-package

StratPal: Stratigraphic Paleobiology Modeling Pipelines
apply_taphonomy

model taphonomic effects
discrete_gradient

construct discretized gradient
random_walk_sl

simulate (un)biased random walk (specimen level)
p3_var_rate

simulate variable rate Poisson point process
random_walk

simulate (un)biased random walk
range_offset

range offset of taxon
ornstein_uhlenbeck_sl

simulate ornstein-uhlenbeck (OU) process (specimen level)
plot.pre_paleoTS

plot pre-paleoTS objects
p3

simulate Poisson point process
prob_remove

probabilistic removal of elements
reduce_to_paleoTS

reduce pre-paleoTS format to paleoTS