org.openimaj.image.connectedcomponent.proc

Class BasicShapeDescriptor

java.lang.Object

org.openimaj.image.connectedcomponent.proc.BasicShapeDescriptor

All Implemented Interfaces:

FeatureVectorProvider<DoubleFV>, ConnectedComponentProcessor

public class BasicShapeDescriptor
extends Object
implements ConnectedComponentProcessor, FeatureVectorProvider<DoubleFV>

Basic descriptors of the shape of a connected component.

Author:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BasicShapeDescriptor.BasicShapeDescriptorType An enum of all the different basic shape descriptors.

Field Summary

Fields

Modifier and Type	Field and Description
double	area The area of the component
double	chfit The ratio of the area of the component to the area of its convex hull
double	compactness The compactness of the component.
double	cornerEst The estimated number of corners of the component
double	cx The x coordinate of the component centroid
double	cy The y coordinate of the component centroid
double	direction The primary orientation of the component
double	elongatedness The elongatedness of the component.

Constructor Summary

Constructors

Constructor and Description
BasicShapeDescriptor()

Method Summary

Modifier and Type	Method and Description
DoubleFV	getFeatureVector() Get the FeatureVector associated with this object.
double[]	getFeatureVectorArray() Get all the values of the descriptor as an array in the order area, centroid_x, centroid_y, direction, elongatedness, compactness convex_hull_fit, corner_count
void	process(ConnectedComponent cc) Perform an operation on the given ConnectedComponent.

Methods inherited from class java.lang.Object

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

Field Detail

area

public double area

The area of the component

See Also:

PixelSet.calculateArea()

cx

public double cx

The x coordinate of the component centroid

See Also:

PixelSet.calculateCentroid()

cy

public double cy

The y coordinate of the component centroid

See Also:

PixelSet.calculateCentroid()

direction

public double direction

The primary orientation of the component

See Also:

PixelSet.calculateDirection()

elongatedness

public double elongatedness

The elongatedness of the component. Elongatedness is defined as the ratio of the height to width of the oriented bounding box of the component.

See Also:

ConnectedComponent.calculateOrientatedBoundingBoxAspectRatio()

compactness

public double compactness

The compactness of the component. Compactness is defined as the ratio of the squared edge length of the component to its area.

chfit

public double chfit

The ratio of the area of the component to the area of its convex hull

See Also:

ConnectedComponent.calculatePercentageConvexHullFit()

cornerEst

public double cornerEst

The estimated number of corners of the component

See Also:

ConnectedComponent.estimateNumberOfVertices(int, int)

Constructor Detail

BasicShapeDescriptor

public BasicShapeDescriptor()

Method Detail

process

public void process(ConnectedComponent cc)

Description copied from interface: ConnectedComponentProcessor

Perform an operation on the given ConnectedComponent.

Specified by:

process in interface ConnectedComponentProcessor

Parameters:

cc - The ConnectedComponent to process.

getFeatureVectorArray

public double[] getFeatureVectorArray()

Get all the values of the descriptor as an array in the order area, centroid_x, centroid_y, direction, elongatedness, compactness convex_hull_fit, corner_count

Returns:

an array of descriptor values

getFeatureVector

public DoubleFV getFeatureVector()

Description copied from interface: FeatureVectorProvider

Get the FeatureVector associated with this object.

Specified by:

getFeatureVector in interface FeatureVectorProvider<DoubleFV>

Returns:

the feature vector.