boofcv.alg.feature.orientation

Class OrientationHistogram<D extends boofcv.struct.image.ImageGray>

java.lang.Object

boofcv.alg.feature.orientation.OrientationHistogram<D>

All Implemented Interfaces:

OrientationGradient<D>, RegionOrientation

Direct Known Subclasses:

ImplOrientationHistogram_F32, ImplOrientationHistogram_S16, ImplOrientationHistogram_S32

public abstract class OrientationHistogram<D extends boofcv.struct.image.ImageGray>
extends java.lang.Object
implements OrientationGradient<D>

Estimates the orientation by creating a histogram of discrete angles around the entire circle. The angle with the largest sum of edge intensities is considered to be the direction of the region. If weighted a Gaussian kernel centered around the targeted pixel is used.

Field Summary

Fields

Modifier and Type	Field and Description
protected double	angleDiv
protected double	angleRound
protected D	derivX
protected D	derivY
protected boolean	isWeighted
protected int	numAngles
protected double	objectToSample
protected int	radiusScale
protected boofcv.struct.ImageRectangle	rect
protected double[]	sumDerivX
protected double[]	sumDerivY
protected boofcv.struct.convolve.Kernel2D_F32	weights

Constructor Summary

Constructors

Constructor and Description
OrientationHistogram(double objectToSample, int numAngles, boolean isWeighted) Constructor.

Method Summary

Modifier and Type	Method and Description
double	compute(double X, double Y) Computes the orientation of a region about its center.
protected abstract void	computeUnweightedScore() Compute the score without using the optional weights
protected abstract void	computeWeightedScore(int c_x, int c_y) Compute the score using the weighting kernel.
double	getObjectToSample()
boofcv.struct.convolve.Kernel2D_F32	getWeights()
void	setImage(D derivX, D derivY) Specifies input image data for estimating orientation.
void	setObjectRadius(double objectRadius) Specifies the circle's radius that the orientation should be
void	setObjectToSample(int objectToSample) Specify the size of the region that is considered.

Methods inherited from class java.lang.Object

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

Methods inherited from interface boofcv.abst.feature.orientation.OrientationGradient

getImageType

Field Detail

objectToSample

protected double objectToSample

radiusScale

protected int radiusScale

derivX

protected D extends boofcv.struct.image.ImageGray derivX

derivY

protected D extends boofcv.struct.image.ImageGray derivY

rect

protected boofcv.struct.ImageRectangle rect

numAngles

protected int numAngles

sumDerivX

protected double[] sumDerivX

sumDerivY

protected double[] sumDerivY

angleDiv

protected double angleDiv

angleRound

protected double angleRound

isWeighted

protected boolean isWeighted

weights

protected boofcv.struct.convolve.Kernel2D_F32 weights

Constructor Detail

OrientationHistogram

public OrientationHistogram(double objectToSample,
                            int numAngles,
                            boolean isWeighted)

Constructor. Specify region size and if it is weighted or not.

Parameters:

objectToSample - Converts the size of the object to the sample region size

numAngles - Number of discrete angles that the orientation is estimated inside of

Method Detail

getObjectToSample

public double getObjectToSample()

setObjectToSample

public void setObjectToSample(int objectToSample)

Specify the size of the region that is considered.

Parameters:

objectToSample -

getWeights

public boofcv.struct.convolve.Kernel2D_F32 getWeights()

setObjectRadius

public void setObjectRadius(double objectRadius)

Description copied from interface: RegionOrientation

Specifies the circle's radius that the orientation should be

Specified by:

setObjectRadius in interface RegionOrientation

Parameters:

objectRadius - Object's radius.

setImage

public void setImage(D derivX,
                     D derivY)

Description copied from interface: OrientationGradient

Specifies input image data for estimating orientation.

Specified by:

setImage in interface OrientationGradient<D extends boofcv.struct.image.ImageGray>

Parameters:

derivX - Image derivative along x-axis.

derivY - Image derivative along y-axis.

compute

public double compute(double X,
                      double Y)

Description copied from interface: RegionOrientation

Computes the orientation of a region about its center.

Specified by:

compute in interface RegionOrientation

Parameters:

X - Center of the region in image pixels.

Y - Center of the region in image pixels.

Returns:

Orientation in radians. Angle zero points along x-axis and pi/2 along y-axis.

computeUnweightedScore

protected abstract void computeUnweightedScore()

Compute the score without using the optional weights

computeWeightedScore

protected abstract void computeWeightedScore(int c_x,
                                             int c_y)

Compute the score using the weighting kernel.