last_occ: last occurrence of taxon

In StratPal: Stratigraphic Paleobiology Modeling Pipelines

last occurrence of taxon

Description

Determines the time and position of a taxons last occurrence as a function of time of extinction, fossil abundance, stratigraphy, ecology, and taphonomy. Effectively a high-level wrapper around p3/p3_var_rate, apply_niche, apply_taphonomy and time_to_strat/strat_to_time from the admtools package.

Usage

last_occ(
  t_ext,
  rate,
  adm,
  niche = trivial_niche,
  gc = trivial_gradient,
  niche_domain = "time",
  pres_potential = all_preserved,
  ctc = perfect_preservation,
  taphonomy_domain = "strat"
)

Arguments

t_ext	true time of extinction
rate	either positive number or a function. If a number, rate of fossil occurrences passed to p3, if a function passed as rate function to p3_var_rate
adm	age-depth model
niche	niche model, by default the trivial niche
gc	gradient change for the niche mode, by default the trivial gradient. See ?apply_niche
niche_domain	"time" or "strat" - in which domain should the niche model be applied?
pres_potential	preservation potential of fossils, by default all preserved (no taphonomic effects)
ctc	change in taphonomic conditions, by default no change in conditions. See ?apply_taphonomy
taphonomy_domain	"time" or "strat" - in which domain should the taphonomic effects be applied?

Value

a named vector with two entries:

• "h": stratigraphic position of the last occurrence

• "t": time of the last occurrence

See Also

range_offset() to quantify biostratigraphic precision

Examples

# last occurrences 2 km from shore
h = scenarioA$h_m[,"2km"]
adm = admtools::tp_to_adm(t = scenarioA$t_myr, h = h)
l_occ = last_occ(t_ext = 1.8, rate = 5, adm = adm)
l_occ # show timing and position of last occurrences

StratPal documentation built on Dec. 6, 2025, 5:08 p.m.