StratPal (version 0.6.0)

last_occ: 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"
)

Value

a named vector with two entries:

• "h": stratigraphic position of the last occurrence

• "t": time of the last occurrence

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?

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