boofcv.alg.feature.orientation

Class OrientationHistogram<D extends ImageSingleBand>

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 ImageSingleBand>
extends 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.

Author:

Peter Abeles

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 int	radius
protected int	radiusScale
protected ImageRectangle	rect
protected double[]	sumDerivX
protected double[]	sumDerivY
protected Kernel2D_F32	weights

Constructor Summary

Constructors

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

Method Summary

Methods

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.
int	getRadius()
Kernel2D_F32	getWeights()
void	setImage(D derivX, D derivY) Specifies input image data for estimating orientation.
void	setRadius(int radius) Specify the size of the region that is considered.
void	setScale(double scale) Specifies scale at which the orientation is estimated.

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

radius

protected int radius

radiusScale

protected int radiusScale

derivX

protected D extends ImageSingleBand derivX

derivY

protected D extends ImageSingleBand derivY

rect

protected 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 Kernel2D_F32 weights

Constructor Detail

OrientationHistogram

public OrientationHistogram(int numAngles,
                    boolean isWeighted)

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

Parameters:

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

Method Detail

getRadius

public int getRadius()

setRadius

public void setRadius(int radius)

Specify the size of the region that is considered.

Parameters:

radius -

getWeights

public Kernel2D_F32 getWeights()

setScale

public void setScale(double scale)

Description copied from interface: RegionOrientation

Specifies scale at which the orientation is estimated.

Specified by:

setScale in interface RegionOrientation

Parameters:

scale - Scale of the orientation region.

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 ImageSingleBand>

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.