org.openimaj.image.objectdetection.filtering

Class OpenCVGrouping

java.lang.Object

org.openimaj.image.objectdetection.filtering.OpenCVGrouping

All Implemented Interfaces:

DetectionFilter<Rectangle,ObjectIntPair<Rectangle>>

public final class OpenCVGrouping
extends Object
implements DetectionFilter<Rectangle,ObjectIntPair<Rectangle>>

Filter to perform the grouping of detection rectangles in the way OpenCV does. Basically the groups are formed by grouping together all the rectangles that overlap by a certain amount. For each group, the mean rectangle is calculated. Groups that have too little support are removed, as are groups that are enclosed by other groups.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Field Summary

Fields

Modifier and Type	Field and Description
static float	DEFAULT_EPS The default eps value for determining whether two rectangles overlap enough to be considered as being of the same group.
static int	DEFAULT_MINIMUM_SUPPORT The default value for the minimum number of rectangles required within a group.

Constructor Summary

Constructors

Constructor and Description
OpenCVGrouping() Construct a new OpenCVGrouping with the default values of DEFAULT_EPS for the eps and DEFAULT_MINIMUM_SUPPORT for the support.
OpenCVGrouping(float eps, int minSupport) Construct a new OpenCVGrouping with the given parameters.
OpenCVGrouping(int minSupport) Construct a new OpenCVGrouping with the given minimum support number.

Method Summary

Modifier and Type	Method and Description
List<ObjectIntPair<Rectangle>>	apply(List<Rectangle> input) Perform the filtering operation on the input and return the output.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_EPS

public static final float DEFAULT_EPS

The default eps value for determining whether two rectangles overlap enough to be considered as being of the same group.

See Also:

Constant Field Values

DEFAULT_MINIMUM_SUPPORT

public static final int DEFAULT_MINIMUM_SUPPORT

The default value for the minimum number of rectangles required within a group.

See Also:

Constant Field Values

Constructor Detail

OpenCVGrouping

public OpenCVGrouping(float eps,
                      int minSupport)

Construct a new OpenCVGrouping with the given parameters.

Parameters:

eps - The eps value for determining whether two rectangles overlap enough to be considered as being of the same group.

minSupport - The minimum number of rectangles required within a group. Groups with less than this number of rectangles will be removed.

OpenCVGrouping

public OpenCVGrouping(int minSupport)

Construct a new OpenCVGrouping with the given minimum support number. The DEFAULT_EPS value is used for the eps.

Parameters:

minSupport - The minimum number of rectangles required within a group. Groups with less than this number of rectangles will be removed.

OpenCVGrouping

public OpenCVGrouping()

Construct a new OpenCVGrouping with the default values of DEFAULT_EPS for the eps and DEFAULT_MINIMUM_SUPPORT for the support.

Method Detail

apply

public List<ObjectIntPair<Rectangle>> apply(List<Rectangle> input)

Description copied from interface: DetectionFilter

Perform the filtering operation on the input and return the output.

Specified by:

apply in interface DetectionFilter<Rectangle,ObjectIntPair<Rectangle>>

Parameters:

input - the input detections

Returns:

the output detections