A statistical graphic designed for the archaeological study of when events of a specified kind occurred.
occurrence(object, ...)
# S4 method for class 'EventsMCMC'
occurrence(object, level = 0.95)
# S4 method for class 'OccurrenceEvents,missing'
plot(
x,
calendar = getOption("ArchaeoPhases.calendar"),
main = NULL,
sub = NULL,
ann = graphics::par("ann"),
axes = TRUE,
frame.plot = axes,
panel.first = NULL,
panel.last = NULL,
...
)
An EventsMCMC
object.
Other graphical parameters may also be passed as
arguments to this function, particularly, border
, col
, lwd
, lty
or
pch
.
A length-one numeric
vector giving the confidence level.
An OccurrenceEvents
object.
A aion::TimeScale
object specifying the target
calendar (see calendar()
).
A character
string giving a main title for the plot.
A character
string giving a subtitle for the plot.
A logical
scalar: should the default annotation (title and x
and y axis labels) appear on the plot?
A logical
scalar: should axes be drawn on the plot?
A logical
scalar: should a box be drawn around the
plot?
An an expression
to be evaluated after the plot axes are
set up but before any plotting takes place. This can be useful for drawing
background grids.
An expression
to be evaluated after plotting has taken
place but before the axes, title and box are added.
occurrence()
returns an OccurrenceEvents
object.
plot()
is called it for its side-effects: it results in a graphic being
displayed (invisibly returns x
).
An OccurrenceEvents
object.
If we have \(k\) events, then we can estimate the calendar date \(t\) corresponding to the smallest date such that the number of events observed before \(t\) is equal to \(k\).
The occurrence()
estimates these occurrences and gives the credible
interval or the highest posterior density (HPD) region for a given level
of confidence.