org.openimaj.image.feature.local.engine.asift

Class ASIFTEngine

java.lang.Object

org.openimaj.image.feature.local.engine.asift.ASIFTEngine

All Implemented Interfaces:

Engine<AffineSimulationKeypoint,FImage>

@Reference(type=Article,
           author={"Morel, Jean-Michel","Yu, Guoshen"},
           title="{ASIFT: A New Framework for Fully Affine Invariant Image Comparison}",
           year="2009",
           journal="SIAM J. Img. Sci.",
           publisher="Society for Industrial and Applied Mathematics")
public class ASIFTEngine
extends Object
implements Engine<AffineSimulationKeypoint,FImage>

An Engine for ASIFT.

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected AffineSimulationExtractor<LocalFeatureList<Keypoint>,Keypoint,FImage,Float>	asift
protected int	nTilts

Constructor Summary

Constructors

Constructor and Description
ASIFTEngine() Construct using 5 tilt levels and no initial double-sizing.
ASIFTEngine(boolean hires) Construct using 5 tilt levels with optional initial double-sizing.
ASIFTEngine(boolean hires, int nTilts) Construct using given number of tilt levels with optional initial double-sizing.
ASIFTEngine(DoGSIFTEngineOptions<FImage> opts) Construct using 5 tilt levels and the given parameters for the internal DoGSIFTEngine.
ASIFTEngine(DoGSIFTEngineOptions<FImage> opts, int nTilts) Construct using the given numbe of tilt levels and parameters for the internal DoGSIFTEngine.

Method Summary

Modifier and Type	Method and Description
LocalFeatureList<AffineSimulationKeypoint>	findFeatures(FImage image) Find local features in the given image and return them.
LocalFeatureList<Keypoint>	findKeypoints(FImage image) Find the features as a list of Keypoint objects
LocalFeatureList<Keypoint>	findKeypoints(FImage image, AffineParams params) Find the features of a single simulation as a list of Keypoint objects
Map<AffineParams,LocalFeatureList<Keypoint>>	findKeypointsMapped(FImage image) Find the features and return the resultant features in a per-simulation format.

Methods inherited from class java.lang.Object

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

Field Detail

asift

protected AffineSimulationExtractor<LocalFeatureList<Keypoint>,Keypoint,FImage,Float> asift

nTilts

protected int nTilts

Constructor Detail

ASIFTEngine

public ASIFTEngine()

Construct using 5 tilt levels and no initial double-sizing. The default parameters for the internal DoGSIFTEngine are used.

ASIFTEngine

public ASIFTEngine(boolean hires)

Construct using 5 tilt levels with optional initial double-sizing. The default parameters for the internal DoGSIFTEngine are used.

Parameters:

hires - should the image should be double sized as a first step

ASIFTEngine

public ASIFTEngine(boolean hires,
                   int nTilts)

Construct using given number of tilt levels with optional initial double-sizing. The default parameters for the internal DoGSIFTEngine are used.

Parameters:

hires - should the image should be double sized as a first step

nTilts - number of tilt levels

ASIFTEngine

public ASIFTEngine(DoGSIFTEngineOptions<FImage> opts)

Construct using 5 tilt levels and the given parameters for the internal DoGSIFTEngine.

Parameters:

opts - parameters for the internal DoGSIFTEngine.

ASIFTEngine

public ASIFTEngine(DoGSIFTEngineOptions<FImage> opts,
                   int nTilts)

Construct using the given numbe of tilt levels and parameters for the internal DoGSIFTEngine.

Parameters:

opts - parameters for the internal DoGSIFTEngine.

nTilts - number of tilt levels

Method Detail

findKeypoints

public LocalFeatureList<Keypoint> findKeypoints(FImage image)

Find the features as a list of Keypoint objects

Parameters:

image - the image

Returns:

the detected features

findKeypoints

public LocalFeatureList<Keypoint> findKeypoints(FImage image,
                                                AffineParams params)

Find the features of a single simulation as a list of Keypoint objects

Parameters:

image - the image

params - the simulation parameters

Returns:

the detected features

findKeypointsMapped

public Map<AffineParams,LocalFeatureList<Keypoint>> findKeypointsMapped(FImage image)

Find the features and return the resultant features in a per-simulation format.

Parameters:

image - the image

Returns:

the features

findFeatures

public LocalFeatureList<AffineSimulationKeypoint> findFeatures(FImage image)

Description copied from interface: Engine

Find local features in the given image and return them.

Specified by:

findFeatures in interface Engine<AffineSimulationKeypoint,FImage>

Parameters:

image - the image

Returns:

the features.