org.protempa.proposition.interval

Class Relation

java.lang.Object

org.protempa.proposition.interval.Relation

All Implemented Interfaces:

Serializable

public final class Relation
extends Object
implements Serializable

A representation of the temporal relationship between two intervals, as described in Stillman et al. Tachyon: A constraint-based temporal reasoning model and its implementation. SIGART Bulletin. 1993;4(3):T1-T4, which was in turn inspired by Dechter's simple temporal problem, as defined in Dechter, R. et al. Temporal Constraint Networks. Artif. Intell. 1991;49:61-95.

Author:

Andrew Post

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Relation	AFTER
static Relation	BEFORE
static Relation	CONTAINS
static Relation	CONTAINS_OR_EQUALS
static Relation	DURING
static Relation	EQUALS
static Relation	FINISHED_BY
static Relation	FINISHES
static Relation	MEETS
static Relation	MET_BY
static Relation	OVERLAPPED_BY
static Relation	OVERLAPS
static Relation	STARTED_BY
static Relation	STARTS

Constructor Summary

Constructors

Constructor and Description
Relation()
Relation(Integer minDistanceBetweenStarts, Unit minDistanceBetweenStartsUnits, Integer maxDistanceBetweenStarts, Unit maxDistanceBetweenStartsUnits, Integer minSpan, Unit minSpanUnits, Integer maxSpan, Unit maxSpanUnits, Integer minDistanceBetween, Unit minDistanceBetweenUnits, Integer maxDistanceBetween, Unit maxDistanceBetweenUnits, Integer minDistanceBetweenFinishes, Unit minDistanceBetweenFinishesUnits, Integer maxDistanceBetweenFinishes, Unit maxDistanceBetweenFinishesUnits) Constructs a new Relation between two intervals from Weights and Units.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
Integer	getMaxDistanceBetween()
Integer	getMaxDistanceBetweenFinishes()
Unit	getMaxDistanceBetweenFinishesUnits()
Integer	getMaxDistanceBetweenStarts()
Unit	getMaxDistanceBetweenStartsUnits()
Unit	getMaxDistanceBetweenUnits()
Integer	getMaxSpan()
Unit	getMaxSpanUnits()
Integer	getMinDistanceBetween()
Integer	getMinDistanceBetweenFinishes()
Unit	getMinDistanceBetweenFinishesUnits()
Integer	getMinDistanceBetweenStarts()
Unit	getMinDistanceBetweenStartsUnits()
Unit	getMinDistanceBetweenUnits()
Integer	getMinSpan()
Unit	getMinSpanUnits()
int	hashCode()
boolean	hasRelation(Interval interval1, Interval interval2) Determines whether the given intervals have this relation.
Relation	inverse()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

BEFORE

public static final Relation BEFORE

AFTER

public static final Relation AFTER

OVERLAPS

public static final Relation OVERLAPS

OVERLAPPED_BY

public static final Relation OVERLAPPED_BY

MEETS

public static final Relation MEETS

MET_BY

public static final Relation MET_BY

EQUALS

public static final Relation EQUALS

CONTAINS

public static final Relation CONTAINS

CONTAINS_OR_EQUALS

public static final Relation CONTAINS_OR_EQUALS

DURING

public static final Relation DURING

STARTS

public static final Relation STARTS

STARTED_BY

public static final Relation STARTED_BY

FINISHES

public static final Relation FINISHES

FINISHED_BY

public static final Relation FINISHED_BY

Constructor Detail

Relation

public Relation()

Relation

public Relation(Integer minDistanceBetweenStarts,
                Unit minDistanceBetweenStartsUnits,
                Integer maxDistanceBetweenStarts,
                Unit maxDistanceBetweenStartsUnits,
                Integer minSpan,
                Unit minSpanUnits,
                Integer maxSpan,
                Unit maxSpanUnits,
                Integer minDistanceBetween,
                Unit minDistanceBetweenUnits,
                Integer maxDistanceBetween,
                Unit maxDistanceBetweenUnits,
                Integer minDistanceBetweenFinishes,
                Unit minDistanceBetweenFinishesUnits,
                Integer maxDistanceBetweenFinishes,
                Unit maxDistanceBetweenFinishesUnits)

Constructs a new Relation between two intervals from Weights and Units.

Parameters:

minDistanceBetweenStarts - the minimum distance between the starts of the intervals.

minDistanceBetweenStartsUnits - units for the minimum distance between the starts of the intervals.

maxDistanceBetweenStarts - the maximum distance between the starts of the intervals.

maxDistanceBetweenStartsUnits - units for the maximum distance between the starts of the intervals.

minSpan - the minimum distance between the start of interval 1 and the finish of interval 2.

minSpanUnits - units for the minimum distance between the start of interval 1 and the finish of interval 2.

maxSpan - the maximum distance between the start of interval 1 and the finish of interval 2.

maxSpanUnits - units for the maximum distance between the start of interval 1 and the finish of interval 2.

minDistanceBetween - the minimum distance between the finish of interval 1 and the start of interval 2.

minDistanceBetweenUnits - units for the minimum distance between the finish of interval 1 and the start of interval 2.

maxDistanceBetween - the maximum distance between the finish of interval 1 and the start of interval 2.

maxDistanceBetweenUnits - units for the maximum distance between the finish of interval 1 and the start of interval 2.

minDistanceBetweenFinishes - the minimum distance between the finish of interval 1 and the finish of interval 2.

minDistanceBetweenFinishesUnits - units for the minimum distance between the finish of interval 1 and the finish of interval 2.

maxDistanceBetweenFinishes - the maximum distance between the finish of interval 1 and the finish of interval 2.

maxDistanceBetweenFinishesUnits - units for the maximum distance between the finish of interval 1 and the finish of interval 2.

Throws:

IllegalArgumentException - if max gt; min for any of the constraints.

Method Detail

inverse

public Relation inverse()

getMinDistanceBetweenStarts

public Integer getMinDistanceBetweenStarts()

getMinDistanceBetweenStartsUnits

public Unit getMinDistanceBetweenStartsUnits()

getMaxDistanceBetweenStarts

public Integer getMaxDistanceBetweenStarts()

getMaxDistanceBetweenStartsUnits

public Unit getMaxDistanceBetweenStartsUnits()

getMinSpan

public Integer getMinSpan()

getMinSpanUnits

public Unit getMinSpanUnits()

getMaxSpan

public Integer getMaxSpan()

getMaxSpanUnits

public Unit getMaxSpanUnits()

getMinDistanceBetween

public Integer getMinDistanceBetween()

getMinDistanceBetweenUnits

public Unit getMinDistanceBetweenUnits()

getMaxDistanceBetween

public Integer getMaxDistanceBetween()

getMaxDistanceBetweenUnits

public Unit getMaxDistanceBetweenUnits()

getMinDistanceBetweenFinishes

public Integer getMinDistanceBetweenFinishes()

getMinDistanceBetweenFinishesUnits

public Unit getMinDistanceBetweenFinishesUnits()

getMaxDistanceBetweenFinishes

public Integer getMaxDistanceBetweenFinishes()

getMaxDistanceBetweenFinishesUnits

public Unit getMaxDistanceBetweenFinishesUnits()

hasRelation

public boolean hasRelation(Interval interval1,
                           Interval interval2)

Determines whether the given intervals have this relation.

Parameters:

interval1 - the left-hand-side Interval.

interval2 - the right-hand-side Interval.

Returns:

true if the intervals have this relation, false otherwise. Returns false if any null arguments are given.

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object