imagingbook.pub.lucaskanade

Class LucasKanadeForwardMatcher

java.lang.Object

imagingbook.pub.lucaskanade.LucasKanadeMatcher

imagingbook.pub.lucaskanade.LucasKanadeForwardMatcher

public class LucasKanadeForwardMatcher
extends LucasKanadeMatcher

Lucas-Kanade (forward-additive) matcher, as described in Simon Baker and Iain Matthews, "Lucas-Kanade 20 Years On: A Unifying Framework: Part 1", CMU-RI-TR-02-16 (2002) Also called the "forward-additive" algorithm. This version assumes that the the origin of R is at its center!

Version:

2014/02/08

Nested Class Summary

Nested classes/interfaces inherited from class imagingbook.pub.lucaskanade.LucasKanadeMatcher

LucasKanadeMatcher.Parameters

Constructor Summary

Constructors

Constructor and Description
LucasKanadeForwardMatcher(ij.process.FloatProcessor I, ij.process.FloatProcessor R)
LucasKanadeForwardMatcher(ij.process.FloatProcessor I, ij.process.FloatProcessor R, LucasKanadeMatcher.Parameters params) Creates a new matcher of type LucasKanadeForwardMatcher.

Method Summary

Modifier and Type	Method and Description
double	getRmsError() Measures the RMS intensity difference between the reference image R and the patch in the search image I defined by the current warp Tp.
boolean	hasConverged() Checks if the matcher has converged.
ProjectiveMapping	iterateOnce(ProjectiveMapping Tp) Performs a single matching iteration on the given image pair (I, R).

Methods inherited from class imagingbook.pub.lucaskanade.LucasKanadeMatcher

getIteration, getMatch, getReferenceMappingTo, getReferencePoints, gradientX, gradientY, showSteepestDescentImages

Methods inherited from class java.lang.Object

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

Constructor Detail

LucasKanadeForwardMatcher

public LucasKanadeForwardMatcher(ij.process.FloatProcessor I,
                                 ij.process.FloatProcessor R,
                                 LucasKanadeMatcher.Parameters params)

Creates a new matcher of type LucasKanadeForwardMatcher.

Parameters:

I - the search image (of type FloatProcessor).

R - the reference image (of type FloatProcessor)

params - a parameter object of type LucasKanadeMatcher.Parameters.

LucasKanadeForwardMatcher

public LucasKanadeForwardMatcher(ij.process.FloatProcessor I,
                                 ij.process.FloatProcessor R)

Method Detail

hasConverged

public boolean hasConverged()

Description copied from class: LucasKanadeMatcher

Checks if the matcher has converged.

Specified by:

hasConverged in class LucasKanadeMatcher

Returns:

true if minimization criteria have been reached.

getRmsError

public double getRmsError()

Description copied from class: LucasKanadeMatcher

Measures the RMS intensity difference between the reference image R and the patch in the search image I defined by the current warp Tp.

Specified by:

getRmsError in class LucasKanadeMatcher

Returns:

the RMS error under the current warp

iterateOnce

public ProjectiveMapping iterateOnce(ProjectiveMapping Tp)

Description copied from class: LucasKanadeMatcher

Performs a single matching iteration on the given image pair (I, R).

Specified by:

iterateOnce in class LucasKanadeMatcher

Parameters:

Tp - the warp transformation from the reference image R to the initial search patch, assuming that R is centered at the coordinate origin!

Returns:

a new warp transformation (again assuming that R is centered at the coordinate origin) or null if the iteration was unsuccessful.