ArchaeoPhases (version 2.1.0)

allen_relation: Allen Relation Between Definite Intervals

Description

Allen Relation Between Definite Intervals

Usage

allen_relation(x, y, ...)
# S4 method for numeric,numeric
allen_relation(x, y)
# S4 method for ANY,missing
allen_relation(x)

Value

A character matrix specifying the Allen relations.

Arguments

x, y

A numeric vector giving the lower and upper boundaries of the time intervals, respectively. If y is missing, an attempt is made to interpret x in a suitable way (see grDevices::xy.coords()).

...

Currently not used.

Author

T. S. Dye, N. Frerebeau

Details

Relation			Converse
precedes	(p)	(P)	preceded by
meets	(m)	(M)	met by
overlaps	(o)	(O)	overlapped by
finished by	(F)	(f)	finishes
contains	(D)	(d)	during
starts	(s)	(S)	started by
equals	(e)

References

Allen, J. F. (1983). Maintaining Knowledge about Temporal Intervals. Communications of the ACM, 26(11): 832-843. tools:::Rd_expr_doi("10.1145/182.358434").

Alspaugh, T. (2019). Allen's Interval Algebra. URL: https://thomasalspaugh.org/pub/fnd/allen.html.

See Also

Other Allen's intervals: allen_analyze(), allen_analyze_relations(), allen_complement(), allen_composition(), allen_converse(), allen_illustrate(), allen_illustrate_relations(), allen_intersect(), allen_joint_concurrency(), allen_observe(), allen_observe_frequency(), allen_plot(), allen_relation_code(), allen_union()

Examples

## Data from Husi 2022
loire <- data.frame(
  lower = c(625, 700, 1200, 1225, 1250, 500, 1000, 1200,
            1325, 1375, 1200, 1300, 1375, 1275, 1325),
  upper = c(750, 825, 1250, 1275, 1325, 700, 1300, 1325,
            1400, 1500, 1300, 1375, 1500, 1325, 1425)
)

## Basic relations
allen_relation(loire$lower, loire$upper)

## Complement
(comp <- allen_complement("F")) # "pmoDseSdfOMP"

## Converse
(conv <- allen_converse(comp)) # "pmoFDseSdOMP"

## Composition
allen_composition("oFD", "oFDseS") # "pmoFD"

## Intersection
allen_intersect("pFsSf", "pmoFD") # "pF"

# Union
allen_union("pFsSf", "pmoFD") # "pmoFDsSf"