Module imagingbook.common

Package imagingbook.common.image.matching.lucaskanade

Class LucasKanadeInverseMatcher

java.lang.Object

imagingbook.common.image.matching.lucaskanade.LucasKanadeMatcher

imagingbook.common.image.matching.lucaskanade.LucasKanadeInverseMatcher

public class LucasKanadeInverseMatcher
extends LucasKanadeMatcher

Lucas-Kanade elastic "Inverse Compositional" matcher, as described in [1]. See Sec. 24.3 (Alg. 4.2) of [2] for additional details.

[1] Simon Baker and Iain Matthews, "Lucas-Kanade 20 Years On: A Unifying Framework: Part 1", CMU-RI-TR-02-16 (2002)
[2] W. Burger, M.J. Burge, Digital Image Processing – An Algorithmic Introduction, 3rd ed, Springer (2022).

Version:

2014/02/08

Nested Class Summary

Nested classes/interfaces inherited from class imagingbook.common.image.matching.lucaskanade.LucasKanadeMatcher

LucasKanadeMatcher.Parameters

Constructor Summary

Constructors

Constructor	Description
LucasKanadeInverseMatcher(FloatProcessor I, FloatProcessor R)	Constructor using default parameters.
LucasKanadeInverseMatcher(FloatProcessor I, FloatProcessor R, LucasKanadeMatcher.Parameters params)	Constructor.

Method Summary

Modifier and Type	Method	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.
ProjectiveMapping2D	iterateOnce(ProjectiveMapping2D Tp)	Performs a single matching iteration on the given image pair (I, R).

Methods inherited from class imagingbook.common.image.matching.lucaskanade.LucasKanadeMatcher

getIteration, getMatch, getReferenceMappingTo, getReferencePoints

Methods inherited from class java.lang.Object

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

Constructor Details

LucasKanadeInverseMatcher

public LucasKanadeInverseMatcher(FloatProcessor I,
 FloatProcessor R,
 LucasKanadeMatcher.Parameters params)

Constructor.

Parameters:

I - the search image (of type FloatProcessor).

R - the reference image (of type FloatProcessor)

params - a parameter object of type LucasKanadeMatcher.Parameters.

LucasKanadeInverseMatcher

public LucasKanadeInverseMatcher(FloatProcessor I,
 FloatProcessor R)

Constructor using default parameters.

Parameters:

I - the search image (of type FloatProcessor).

R - the reference image (of type FloatProcessor)

Method Details

iterateOnce

public ProjectiveMapping2D iterateOnce(ProjectiveMapping2D 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.

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