org.apache.commons.geometry.enclosing

Class WelzlEncloser<P extends Point<P>>

java.lang.Object

org.apache.commons.geometry.enclosing.WelzlEncloser<P>

Type Parameters:

P - Point type.

All Implemented Interfaces:

Encloser<P>

Direct Known Subclasses:

WelzlEncloser2D, WelzlEncloser3D

public class WelzlEncloser<P extends Point<P>>
extends Object
implements Encloser<P>

Class implementing Emo Welzl's algorithm to find the smallest enclosing ball in linear time.

The class implements the algorithm described in paper Smallest Enclosing Disks (Balls and Ellipsoids) by Emo Welzl, Lecture Notes in Computer Science 555 (1991) 359-370. The pivoting improvement published in the paper Fast and Robust Smallest Enclosing Balls, by Bernd Gärtner and further modified in paper Efficient Computation of Smallest Enclosing Balls in Three Dimensions by Linus Källberg to avoid performing local copies of data have been included.

Constructor Summary

Constructors

Constructor and Description
WelzlEncloser(SupportBallGenerator<P> generator, DoublePrecisionContext precision) Simple constructor.

Method Summary

Modifier and Type	Method and Description
EnclosingBall<P>	enclose(Iterable<P> points) Find a ball enclosing a list of points.

Methods inherited from class java.lang.Object

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

Constructor Detail

WelzlEncloser

public WelzlEncloser(SupportBallGenerator<P> generator,
                     DoublePrecisionContext precision)

Simple constructor.

Parameters:

generator - generator for balls on support

precision - precision context used to compare floating point values

Method Detail

enclose

public EnclosingBall<P> enclose(Iterable<P> points)

Find a ball enclosing a list of points.

Specified by:

enclose in interface Encloser<P extends Point<P>>

Parameters:

points - points to enclose

Returns:

enclosing ball