overlaps {diyar}

R Documentation

Overlapping number line objects

Description

Identify overlapping number_line objects

Usage

overlaps(x, y, methods = 8)

overlap(x, y)

exact(x, y)

reverse(x, y)

across(x, y)

x_across_y(x, y)

y_across_x(x, y)

chain(x, y)

x_chain_y(x, y)

y_chain_x(x, y)

aligns_start(x, y)

aligns_end(x, y)

inbetween(x, y)

x_inbetween_y(x, y)

y_inbetween_x(x, y)

overlap_method(x, y)

include_overlap_method(methods)

exclude_overlap_method(methods)

overlap_method_codes(methods)

overlap_method_names(methods)

Arguments

x	[number_line]
y	[number_line]
methods	[charater|integer]. Methods of overlap. Check different pairs of number_line objects by different methods. Options are "exact", "reverse", "inbetween", "across", "chain", "aligns_start" and "aligns_end". Combinations are also supported see diyar::overlap_methods$options.

Details

9 logical test;

exact() - Identical left and right points.

reverse() - Swapped left and right points.

inbetween() - start and end point of one number_line object is within the start and end point of another. Split into x_inbetween_y() and y_inbetween_x().

across() - start or end point of one number_line object is in between the start and end point of another. Split into x_across_y() and y_across_x().

chain() - endpoint of one number_line object is the same as the start point of another. Split into x_chain_y() and y_chain_x().

aligns_start() - identical start points only.

aligns_end() - identical end point only.

overlap() - any kind of overlap. A convenient method for "ANY" and "ALL" overlap methods.

overlaps() - overlap by a specified combination of the methods.

Describe methods of overlap;

overlap_method() - Shows how a pair of number_line object has overlapped. Does not show "overlap" since overlap() is always TRUE when any other method is TRUE.

include_overlap_method() and exclude_overlap_method() - Conveniently create the required values for methods, and case_overlap_methods and recurrence_overlap_methods in episodes.

overlap_method_codes() - Numeric codes for the supported combination of overlap methods.

Value

logical; character

See Also

number_line; set_operations

Examples

a <- number_line(-100, 100)
b <- number_line(10, 11.2)
c <- number_line(100, 200)
d <- number_line(100, 120)
e <- number_line(50, 120)
g <- number_line(100, 100)
f <- number_line(120, 50)

overlaps(a, g)
overlaps(a, g, methods = "exact|chain")

overlap(a, b)
overlap(a, e)

exact(a, g)
exact(a, a)

reverse(e, e)
reverse(e, f)

across(a, e)
x_across_y(a, e)
y_across_x(a, e)

chain(c, d)
chain(a, c)

x_chain_y(c, d)
x_chain_y(a, c)

y_chain_x(c, d)
y_chain_x(a, c)

aligns_start(c, d)
aligns_start(a, c)

aligns_end(d, e)
aligns_end(a, c)

inbetween(a, g)
inbetween(b, a)

x_inbetween_y(a, g)
x_inbetween_y(b, a)

y_inbetween_x(a, g)
y_inbetween_x(b, a)

overlap_method(a, c)
overlap_method(d, c)
overlap_method(a, g)
overlap_method(b, e)

include_overlap_method("across")
include_overlap_method(c("across", "chain"))

exclude_overlap_method("across")
exclude_overlap_method(c("across", "chain"))

overlap_method_codes("across")
overlap_method_codes("across|chain|exact")

overlap_method_names(100)
overlap_method_names(561)

---