resample_event: Resample Event Dates

Description

bootstrap() generate bootstrap estimations of an event.
jackknife() generate jackknife estimations of an event.

Usage

# S4 method for EventDate
jackknife(
  object,
  level = 0.95,
  calendar = get_calendar(),
  progress = getOption("kairos.progress"),
  verbose = getOption("kairos.verbose"),
  ...
)
# S4 method for EventDate
bootstrap(
  object,
  level = 0.95,
  probs = c(0.05, 0.95),
  n = 1000,
  calendar = get_calendar(),
  progress = getOption("kairos.progress"),
  ...
)

Value

A data.frame.

Arguments

object: An EventDate object (typically returned by event()).
level: A length-one numeric vector giving the confidence level.
calendar: An aion::TimeScale object specifying the target calendar (see aion::calendar()). If NULL, rata die are returned.
progress: A logical scalar: should a progress bar be displayed?
verbose: A logical scalar: should R report extra information on progress?
...: Further arguments to be passed to internal methods.
probs: A numeric vector of probabilities with values in \([0,1]\).
n: A non-negative integer specifying the number of bootstrap replications.

Author

N. Frerebeau

Details

If jackknife() is used, one type/fabric is removed at a time and all statistics are recalculated. In this way, one can assess whether certain type/fabric has a substantial influence on the date estimate. A three columns data.frame is returned, giving the results of the resampling procedure (jackknifing fabrics) for each assemblage (in rows) with the following columns:

mean: The jackknife mean (event date).
lower: The lower boundary of the confidence interval.
upper: The upper boundary of the confidence interval.

If bootstrap() is used, a large number of new bootstrap assemblages is created, with the same sample size, by resampling each of the original assemblage with replacement. Then, examination of the bootstrap statistics makes it possible to pinpoint assemblages that require further investigation.

A five columns data.frame is returned, giving the bootstrap distribution statistics for each replicated assemblage (in rows) with the following columns: