setupSimulatedGradientChange {paleoAM} | R Documentation |
Given a series of inputs, simulates a sequence of gradient change against time for use in testing how environmental change alters the recovered sequence of fossil assemblages.
setupSimulatedGradientChange(
nEvents,
peakGradientValue,
bgGradientValue,
bgDurationRange,
transitionDuration,
eventDuration,
halfGradientOnly = FALSE,
includeInitialBackgroundPhase = TRUE,
plot = FALSE
)
nEvents |
Number of events to occur in a simulated sequence of gradient change. |
peakGradientValue |
The gradient value at the 'peak' for an event that represents an excursion on that environmental gradient. |
bgGradientValue |
The gradient value expected during background intervals during which no notable excursion is occurring on that environmental gradient. |
bgDurationRange |
A vector of two values, representing the minimum and maximum duration (in time units) of a background interval between successive events. |
transitionDuration |
How long the transition between peak and background intervals should be. The longer this interval, the more chances of an assemblage being sampled that represents transitional gradient values. |
eventDuration |
The duration (in time-units) of a simulated event during which the environmental gradient is at an excursion 'peak' level. |
halfGradientOnly |
Whether to simulate only half of
a background-event sequence, either beginning or terminating
the simulation at the peak value.
Only a single event can be simulated, so |
includeInitialBackgroundPhase |
A logical indicating whether to include a lengthy background phase, for use in calibrating a simulation. This function is mainly for diagnostic purposes and may be removed in future updates. |
plot |
Should the simulated gradient be shown as a plot? |
This function is rather complicated and was written at a time when it was envisioned that simulations would involve time series of many repeated events with varying background intervals between them, rather than simulated sequences having only one event. In practice, use of paleoAM has tended to find the latter to be more useful.
A list with five components:
simGradient
, a data frame giving the change in gradient values over time;
approxGradientSeriesFunction
, the simulated gradient given as an interpolated function;
eventStartEndTimes
, a vector of when each event and its preceding transition begin in time-units;
eventPhaseStartTimes
, a vector of when each new event phase (at the peak gradient value) begin in time-units;
and backgroundStartEnd
, a value indicating the time-step when the beginning background interval ends.