aoristic.df: Calculate aoristic weights

View source: R/aoristic.df.R

aoristic.dfR Documentation

Calculate aoristic weights

Description

Calculates aoristic proportional weights across 168 units representing each hour of the week (24 hours x 7 days). It is designed for situations when an event time is not known but could be spread across numerous hours or days, represented by Start/From and End/To date-times.

Usage

aoristic.df(data1, Xcoord, Ycoord, DateTimeFrom, DateTimeTo)

Arguments

data1

Data frame containing coordinates and date-time columns.

Xcoord

Name of the numeric X coordinate or latitude column.

Ycoord

Name of the numeric Y coordinate or longitude column.

DateTimeFrom

Name of the Start/From POSIXct column.

DateTimeTo

Name of the End/To POSIXct column.

Details

If an observation is missing the End/To date-time, or its End/To precedes its Start/From, the entire weight is assigned to the hour containing the Start/From date-time. Durations of at least one week receive a uniform probability of '1/168' in every hour.

Value

A data frame with source fields, duration in whole elapsed minutes, and aoristic probabilities for every hour of the week.

References

Ratcliffe, J. H. (2002). Aoristic signatures and the spatio-temporal analysis of high volume crime patterns. Journal of Quantitative Criminology, 18(1), 23-43.

Examples

df <- aoristic.df(dcburglaries, "X", "Y", "StartDateTime", "EndDateTime")

aoristic documentation built on Sept. 9, 2026, 9:08 a.m.