spd: Summed probability distributions (SPD) of radiocarbon dates.

Description Usage Arguments Details Value References See Also

View source: R/aggregation.R

Description

The function generates Summed probability distributions (SPD) of radiocarbon dates, with optional binning routine for controlling inter-site or inter-phase variation in sampling intensity.

Usage

1
2
spd(x, timeRange, bins = NA, datenormalised = FALSE,
  spdnormalised = FALSE, runm = NA, verbose = TRUE)

Arguments

x

A CalDates class object containing the calibrated radiocarbon dates.

timeRange

A vector of length 2 indicating the start and end date of the analysis in cal BP.

bins

A vector containing the bin names associated with each radiocarbon date. If set to NA, binning is not carried out.

datenormalised

Controls for calibrated dates with probability mass outside the timerange of analysis. If set to TRUE the total probability mass within the time-span of analysis is normalised to sum to unity. Should be set to FALSE when the parameter normalised in calibrate is set to FALSE. Default is FALSE.

spdnormalised

A logical variable indicating whether the total probability mass of the SPD is normalised to sum to unity.

runm

A number indicating the window size of the moving average to smooth the SPD. If set to NA no moving average is applied. Default is NA

verbose

A logical variable indicating whether extra information on progress should be reported. Default is TRUE.

Details

The binning routine consists of computing summed probability distribution of all dates associated to a given bin, divided by the number of contributing dates. This controls for any striking differences in sampling intensity, and ensures that each site phase is equally contributing to the final SPD (see Timpson et al 2014 for details). Bins can be generated using the binPrep, whilst the sensitivity to parameter choice can be explored with the binsense function.

Value

An object of class CalSPD with the following elements

References

Timpson, A., et al, (2014). Reconstructing regional population fluctuations in the European Neolithic using radiocarbon dates: a new case-study using an improved method. Journal of Archaeological Science 52: 549-557. DOI:10.1016/j.jas.2014.08.011

See Also

calibrate for calibrating radiocarbon dates; binPrep for preparing bins.


rcarbon documentation built on Oct. 1, 2018, 5:03 p.m.