blogspot.software_and_algorithms.stern_library.data_structure

Class StaticIntervalTree.Node<U extends Comparable<U>,T extends Interval<U>>

java.lang.Object

blogspot.software_and_algorithms.stern_library.data_structure.StaticIntervalTree.Node<U,T>

Enclosing class:

StaticIntervalTree<U extends Comparable<U>,T extends Interval<U>>

protected static class StaticIntervalTree.Node<U extends Comparable<U>,T extends Interval<U>>
extends Object

A node for a static interval tree is a binary tree node augmented with an associated point value and the ability to store intervals.

Intervals that are stored within this node either contain the node's point value or are open at an endpoint that equals the node's point value. Intervals are stored so that these two cases are easily distinguished from one another: Each such class of interval is stored in two structures, one is a tree sorted by low endpoint and the other is a tree sorted by high endpoint. This enables efficient point queries as well as insertions and deletions from the node.

Constructor Summary

Constructors

Constructor and Description
Node(U point) Construct a new node associated with the specified point.

Method Summary

Modifier and Type	Method and Description
void	clear() Clear the elements of this node.
boolean	delete(T interval) Delete the specified interval from this node.
void	fetchIntervalsContainingNodePoint(Collection<T> target) Fetch all intervals from this node that contain the node's point.
void	fetchIntervalsContainingPointHigh(Collection<T> target, U queryPoint, boolean isClosedOnValue) Fetch intervals containing the specified value.
void	fetchIntervalsContainingPointLow(Collection<T> target, U queryPoint, boolean isClosedOnValue) Fetch intervals containing the specified value.
void	fetchOverlappingIntervals(Collection<T> target, Interval<U> queryInterval) Fetch all intervals from this node which overlap the specified interval.
StaticIntervalTree.Node<U,T>	getLeft() Get the left child.
U	getPoint() Get the point associated with this node.
StaticIntervalTree.Node<U,T>	getRight() Get the right child.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Node

public Node(U point)

Construct a new node associated with the specified point.

Parameters:

point - the point with which this node is associated.

Method Detail

clear

public void clear()

Clear the elements of this node.

delete

public boolean delete(T interval)

Delete the specified interval from this node.

Parameters:

interval - the interval to delete.

Returns:

true if an element was deleted as a result of this call, false otherwise.

fetchIntervalsContainingNodePoint

public void fetchIntervalsContainingNodePoint(Collection<T> target)

Fetch all intervals from this node that contain the node's point.

Parameters:

target - the target Collection into which to place the desired intervals.

fetchIntervalsContainingPointHigh

public void fetchIntervalsContainingPointHigh(Collection<T> target,
                                              U queryPoint,
                                              boolean isClosedOnValue)

Fetch intervals containing the specified value. This method is called when the specified value is greater than this node's point.

Parameters:

target - the target Collection into which to place the desired intervals.

queryPoint - the query value.

isClosedOnValue - true if the search is inclusive of the specified value, false otherwise.

fetchIntervalsContainingPointLow

public void fetchIntervalsContainingPointLow(Collection<T> target,
                                             U queryPoint,
                                             boolean isClosedOnValue)

Fetch intervals containing the specified value. This method is called when the specified value is less than this node's point.

Parameters:

target - the target Collection into which to place the desired intervals.

queryPoint - the query value.

isClosedOnValue - true if the search is inclusive of the specified value, false otherwise.

fetchOverlappingIntervals

public void fetchOverlappingIntervals(Collection<T> target,
                                      Interval<U> queryInterval)

Fetch all intervals from this node which overlap the specified interval. By contract, the interval must be such that Interval.getLow() <= getPoint() <= Interval.getHigh().

Parameters:

target - the target Collection into which to place the desired intervals.

queryInterval - the query interval.

getLeft

public StaticIntervalTree.Node<U,T> getLeft()

Get the left child.

Returns:

the left child, null if none exists.

getPoint

public U getPoint()

Get the point associated with this node.

Returns:

the point associated with this node.

getRight

public StaticIntervalTree.Node<U,T> getRight()

Get the right child.

Returns:

the right child, null if none exists.

toString

public String toString()

Overrides:

toString in class Object