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

155

Version

0.7.1

License

Apache License (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Niklas Hohmann

Last Published

December 6th, 2025

Functions in StratPal (0.7.1)

rej_samp

random numbers from rejection sampling
range_offset

range offset of taxon
trivial_gradient

model absence of environmental gradients
reduce_to_paleoTS

reduce pre-paleoTS format to paleoTS
trivial_niche

trivial niche model
scenarioA

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

simulate ornstein-uhlenbeck (OU) process
stasis

simulate phenotypic stasis
snd_niche

simple niche model
thin

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

simulate strict phenotypic stasis (specimen level)
stasis_sl

simulate phenotypic stasis (specimen level)
strat_filter

generate basic stratigraphic filter
discrete_niche

niche from discrete data
is_char_mat

validity of character matrices
StratPal-package

StratPal: Stratigraphic Paleobiology Modeling Pipelines
discrete_gradient

construct discretized gradient
apply_taphonomy

model taphonomic effects
gradient_from_data

gradient or taphonomic conditions from data
bounded_niche

define niche from boundaries
as_char_mat

construct character matrix
all_preserved

Indestructible fossils
apply_niche

apply niche model
last_occ

last occurrence of taxon
p3

simulate Poisson point process
ornstein_uhlenbeck_sl

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

probabilistic removal of elements
plot.pre_paleoTS

plot pre-paleoTS objects
p3_var_rate

simulate variable rate Poisson point process
perfect_preservation

perfect taphonomic conditions
random_walk

simulate (un)biased random walk
random_walk_sl

simulate (un)biased random walk (specimen level)