org.openimaj.image.feature.dense.gradient.dsift

Class AbstractDenseSIFT<IMAGE extends Image<?,IMAGE>>

java.lang.Object

org.openimaj.image.feature.dense.gradient.dsift.AbstractDenseSIFT<IMAGE>

Type Parameters:

IMAGE - Type of image being processed

All Implemented Interfaces:

Cloneable, ImageAnalyser<IMAGE>

Direct Known Subclasses:

ColourDenseSIFT, DenseSIFT, PyramidDenseSIFT

public abstract class AbstractDenseSIFT<IMAGE extends Image<?,IMAGE>>
extends Object
implements ImageAnalyser<IMAGE>, Cloneable

Base class for implementations of a dense SIFT feature extractors.

Author:

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

See Also:

"http://www.vlfeat.org/api/dsift.html#dsift-usage"

Constructor Summary

Constructors

Constructor and Description
AbstractDenseSIFT()

Method Summary

Modifier and Type	Method and Description
void	analyseImage(IMAGE image) Compute the dense sift descriptors of the given image.
abstract void	analyseImage(IMAGE image, Rectangle bounds) Compute the dense sift descriptors inside the bounds rectangle of the given image.
AbstractDenseSIFT<IMAGE>	clone()
abstract int	getBinHeight() (Optional operation) Get the height of a single bin of the sampling window (in pixels).
abstract int	getBinWidth() (Optional operation) Get the width of a single bin of the sampling window (in pixels).
abstract LocalFeatureList<ByteDSIFTKeypoint>	getByteKeypoints() Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with byte vectors.
abstract LocalFeatureList<ByteDSIFTKeypoint>	getByteKeypoints(float energyThreshold) Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with byte vectors.
abstract float[][]	getDescriptors() Get the computed raw dense SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) .
abstract LocalFeatureList<FloatDSIFTKeypoint>	getFloatKeypoints() Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with float vectors.
abstract LocalFeatureList<FloatDSIFTKeypoint>	getFloatKeypoints(float energyThreshold) Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with float vectors.
abstract int	getNumBinsX() Get the number of spatial bins in the X direction
abstract int	getNumBinsY() Get the number of spatial bins in the Y direction
abstract int	getNumOriBins() Get the number of orientation bins
abstract void	setBinHeight(int size) (Optional operation) Set the height of a single bin of the sampling window (in pixels).
abstract void	setBinWidth(int size) (Optional operation) Set the width of a single bin of the sampling window (in pixels).

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDenseSIFT

public AbstractDenseSIFT()

Method Detail

analyseImage

public abstract void analyseImage(IMAGE image,
                                  Rectangle bounds)

Compute the dense sift descriptors inside the bounds rectangle of the given image.

Parameters:

image - the image

bounds - the bounds rectangle

analyseImage

public final void analyseImage(IMAGE image)

Compute the dense sift descriptors of the given image. The entire image will be sampled.

Specified by:

analyseImage in interface ImageAnalyser<IMAGE extends Image<?,IMAGE>>

Parameters:

image - the image

getFloatKeypoints

public abstract LocalFeatureList<FloatDSIFTKeypoint> getFloatKeypoints()

Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with float vectors.

Returns:

a list of FloatDSIFTKeypoints.

getByteKeypoints

public abstract LocalFeatureList<ByteDSIFTKeypoint> getByteKeypoints()

Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with byte vectors.

Returns:

a list of ByteDSIFTKeypoints.

getFloatKeypoints

public abstract LocalFeatureList<FloatDSIFTKeypoint> getFloatKeypoints(float energyThreshold)

Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with float vectors. Only the features with an energy above the given threshold will be returned.

Parameters:

energyThreshold - the threshold on the feature energy

Returns:

a list of FloatDSIFTKeypoints.

getByteKeypoints

public abstract LocalFeatureList<ByteDSIFTKeypoint> getByteKeypoints(float energyThreshold)

Get the SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) in the form of a list of local features with byte vectors. Only the features with an energy above the given threshold will be returned.

Parameters:

energyThreshold - the threshold on the feature energy

Returns:

a list of ByteDSIFTKeypoints.

clone

public AbstractDenseSIFT<IMAGE> clone()

Overrides:

clone in class Object

setBinWidth

public abstract void setBinWidth(int size)

(Optional operation) Set the width of a single bin of the sampling window (in pixels). Sampling window width is this multiplied by getNumBinsX().

Parameters:

size - size to set

setBinHeight

public abstract void setBinHeight(int size)

(Optional operation) Set the height of a single bin of the sampling window (in pixels). Sampling window height is this multiplied by getNumBinsY().

Parameters:

size - size to set

getBinWidth

public abstract int getBinWidth()

(Optional operation) Get the width of a single bin of the sampling window (in pixels). Sampling window width is this multiplied by getNumBinsX().

Returns:

the bin width

getBinHeight

public abstract int getBinHeight()

(Optional operation) Get the height of a single bin of the sampling window (in pixels). Sampling window height is this multiplied by getNumBinsY().

Returns:

the bin height

getNumBinsX

public abstract int getNumBinsX()

Get the number of spatial bins in the X direction

Returns:

the number of bins in the x direction

getNumBinsY

public abstract int getNumBinsY()

Get the number of spatial bins in the Y direction

Returns:

the number of bins in the y direction

getNumOriBins

public abstract int getNumOriBins()

Get the number of orientation bins

Returns:

the number of orientation bins

getDescriptors

public abstract float[][] getDescriptors()

Get the computed raw dense SIFT descriptors from the previous call to analyseImage(Image) or analyseImage(Image, Rectangle) .

Returns:

the descriptors.