Class LineConvexSubset

java.lang.Object

org.apache.commons.geometry.euclidean.twod.LineSubset

org.apache.commons.geometry.euclidean.twod.LineConvexSubset

All Implemented Interfaces:

Embedding<Vector2D,Vector1D>, HyperplaneConvexSubset<Vector2D>, HyperplaneSubset<Vector2D>, Splittable<Vector2D, HyperplaneSubset<Vector2D>>, RegionEmbedding<Vector2D,Vector1D>, Sized

Direct Known Subclasses:

Ray, ReverseRay, Segment

public abstract class LineConvexSubset
extends LineSubset
implements HyperplaneConvexSubset<Vector2D>

Class representing a convex subset of a line in 2D Euclidean space. Instances need not be finite, in which case the start or end point (or both) will be null. Line segments and rays are examples of convex line subsets.

See Also:

• Lines

Method Summary

Modifier and Type	Method	Description
Vector2D	closest(Vector2D pt)	Return the closest point to the argument that is contained in the subset (ie, not classified as outside), or null if no such point exists.
abstract Vector2D	getEndPoint()	Get the end point for the subset.
Interval	getInterval()	Get the 1D interval for the region.
abstract Vector2D	getStartPoint()	Get the start point for the subset.
abstract double	getSubspaceEnd()	Get the 1D end location of the subset or Double.POSITIVE_INFINITY if no end location exists.
Interval	getSubspaceRegion()	Get the embedded subspace region.
abstract double	getSubspaceStart()	Get the 1D start location of the subset or Double.NEGATIVE_INFINITY if no start location exists.
boolean	isEmpty()	Return true if this instance does not contain any points.
abstract LineConvexSubset	reverse()	Reverse the orientation of the hyperplane for this instance, returning the result as a new instance.
Split<LineConvexSubset>	split(Hyperplane<Vector2D> splitter)	Split this instance with the given hyperplane.
List<LineConvexSubset>	toConvex()	Convert this instance into a list of convex child subsets representing the same region.
abstract LineConvexSubset	transform(Transform<Vector2D> transform)	Return a new hyperplane subset resulting from the application of the given transform.

Methods inherited from class LineSubset

classify, getBounds, getHyperplane, getLine, getPrecision, intersection, intersection, toSpace, toSubspace

Methods inherited from class Object

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

Methods inherited from interface Embedding

toSpace, toSubspace

Methods inherited from interface HyperplaneSubset

classify, contains, getCentroid, getHyperplane, isFull

Methods inherited from interface Sized

getSize, isFinite, isInfinite

Method Details

toConvex

public List<LineConvexSubset> toConvex()

Convert this instance into a list of convex child subsets representing the same region. Implementations are not required to return an optimal convex subdivision of the current instance. They are free to return whatever subdivision is readily available.

Specified by:

toConvex in interface HyperplaneSubset<Vector2D>

Specified by:

toConvex in class LineSubset

Returns:

a list of hyperplane convex subsets representing the same subspace region as this instance

isEmpty

public boolean isEmpty()

Return true if this instance does not contain any points.

This method always returns false.

Specified by:

isEmpty in interface HyperplaneSubset<Vector2D>

Returns:

true if this instance does not contain any points

getStartPoint

public abstract Vector2D getStartPoint()

Get the start point for the subset.

Returns:

the start point for the subset, or null if no start point exists

getSubspaceStart

public abstract double getSubspaceStart()

Get the 1D start location of the subset or Double.NEGATIVE_INFINITY if no start location exists.

Returns:

the 1D start location of the subset or Double.NEGATIVE_INFINITY if no start location exists.

getEndPoint

public abstract Vector2D getEndPoint()

Get the end point for the subset.

Returns:

the end point for the subset, or null if no end point exists.

getSubspaceEnd

public abstract double getSubspaceEnd()

Get the 1D end location of the subset or Double.POSITIVE_INFINITY if no end location exists.

Returns:

the 1D end location of the subset or Double.POSITIVE_INFINITY if no end location exists

getSubspaceRegion

public Interval getSubspaceRegion()

Get the embedded subspace region.

Specified by:

getSubspaceRegion in interface RegionEmbedding<Vector2D,Vector1D>

Specified by:

getSubspaceRegion in class LineSubset

Returns:

the embedded subspace region

getInterval

public Interval getInterval()

Get the 1D interval for the region. This method is an alias for getSubspaceRegion().

Returns:

the 1D interval for the region.

split

public Split<LineConvexSubset> split(Hyperplane<Vector2D> splitter)

Split this instance with the given hyperplane.

Specified by:

split in interface HyperplaneConvexSubset<Vector2D>

Specified by:

split in interface Splittable<Vector2D, HyperplaneSubset<Vector2D>>

Parameters:

splitter - the hyperplane to split this object with.

Returns:

result of the split operation

closest

public Vector2D closest(Vector2D pt)

Return the closest point to the argument that is contained in the subset (ie, not classified as outside), or null if no such point exists.

Specified by:

closest in interface HyperplaneSubset<Vector2D>

Parameters:

pt - the reference point

Returns:

the closest point to the reference point that is contained in the subset, or null if no such point exists

transform

public abstract LineConvexSubset transform(Transform<Vector2D> transform)

Return a new hyperplane subset resulting from the application of the given transform. The current instance is not modified.

Specified by:

transform in interface HyperplaneConvexSubset<Vector2D>

Specified by:

transform in interface HyperplaneSubset<Vector2D>

Parameters:

transform - the transform instance to apply

Returns:

new transformed hyperplane subset

reverse

public abstract LineConvexSubset reverse()

Reverse the orientation of the hyperplane for this instance, returning the result as a new instance. The returned subset contains the same points but has a reversed orientation.

Specified by:

reverse in interface HyperplaneConvexSubset<Vector2D>

Returns:

a hyperplane convex subset representing the same region but with the opposite orientation.