org.bytedeco.opencv.opencv_cudaoptflow

Class OpticalFlowDual_TVL1

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.opencv.opencv_core.Algorithm

org.bytedeco.opencv.opencv_cudaoptflow.DenseOpticalFlow

org.bytedeco.opencv.opencv_cudaoptflow.OpticalFlowDual_TVL1

All Implemented Interfaces:

AutoCloseable

@Namespace(value="cv::cuda")
 @Properties(inherit=opencv_cudaoptflow.class)
public class OpticalFlowDual_TVL1
extends DenseOpticalFlow

\brief Implementation of the Zach, Pock and Bischof Dual TV-L1 Optical Flow method. \note C. Zach, T. Pock and H. Bischof, "A Duality Based Approach for Realtime TV-L1 Optical Flow". \note Javier Sanchez, Enric Meinhardt-Llopis and Gabriele Facciolo. "TV-L1 Optical Flow Estimation".

Nested Class Summary

Nested classes/interfaces inherited from class org.bytedeco.javacpp.Pointer

Pointer.CustomDeallocator, Pointer.Deallocator, Pointer.NativeDeallocator, Pointer.ReferenceCounter

Field Summary

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
OpticalFlowDual_TVL1(Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
static OpticalFlowDual_TVL1	create()
static OpticalFlowDual_TVL1	create(double tau, double lambda, double theta, int nscales, int warps, double epsilon, int iterations, double scaleStep, double gamma, boolean useInitialFlow)
double	getEpsilon() Stopping criterion threshold used in the numerical scheme, which is a trade-off between precision and running time.
double	getGamma() Weight parameter for (u - v)^2, tightness parameter.
double	getLambda() Weight parameter for the data term, attachment parameter.
int	getNumIterations() Stopping criterion iterations number used in the numerical scheme.
int	getNumScales() Number of scales used to create the pyramid of images.
int	getNumWarps() Number of warpings per scale.
double	getScaleStep()
double	getTau() Time step of the numerical scheme.
double	getTheta() parameter used for motion estimation.
boolean	getUseInitialFlow()
void	setEpsilon(double epsilon)
void	setGamma(double gamma)
void	setLambda(double lambda)
void	setNumIterations(int iterations)
void	setNumScales(int nscales)
void	setNumWarps(int warps)
void	setScaleStep(double scaleStep)
void	setTau(double tau)
void	setTheta(double theta)
void	setUseInitialFlow(boolean useInitialFlow)

Methods inherited from class org.bytedeco.opencv.opencv_cudaoptflow.DenseOpticalFlow

calc, calc, calc, calc, calc, calc

Methods inherited from class org.bytedeco.opencv.opencv_core.Algorithm

clear, empty, getDefaultName, getPointer, position, read, save, save, write, write, write

Methods inherited from class org.bytedeco.javacpp.Pointer

address, asBuffer, asByteBuffer, availablePhysicalBytes, calloc, capacity, capacity, close, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, formatBytes, free, getPointer, getPointer, getPointer, hashCode, isNull, isNull, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetAddress, offsetof, offsetof, parseBytes, physicalBytes, position, put, realloc, referenceCount, releaseReference, retainReference, setNull, sizeof, sizeof, toString, totalBytes, totalCount, totalPhysicalBytes, withDeallocator, zero

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

OpticalFlowDual_TVL1

public OpticalFlowDual_TVL1(Pointer p)

Pointer cast constructor. Invokes Pointer(Pointer).

Method Detail

getTau

public double getTau()

Time step of the numerical scheme.

setTau

public void setTau(double tau)

getLambda

public double getLambda()

Weight parameter for the data term, attachment parameter. This is the most relevant parameter, which determines the smoothness of the output. The smaller this parameter is, the smoother the solutions we obtain. It depends on the range of motions of the images, so its value should be adapted to each image sequence.

setLambda

public void setLambda(double lambda)

getGamma

public double getGamma()

Weight parameter for (u - v)^2, tightness parameter. It serves as a link between the attachment and the regularization terms. In theory, it should have a small value in order to maintain both parts in correspondence. The method is stable for a large range of values of this parameter.

setGamma

public void setGamma(double gamma)

getTheta

public double getTheta()

parameter used for motion estimation. It adds a variable allowing for illumination variations Set this parameter to 1. if you have varying illumination. See: Chambolle et al, A First-Order Primal-Dual Algorithm for Convex Problems with Applications to Imaging Journal of Mathematical imaging and vision, may 2011 Vol 40 issue 1, pp 120-145

setTheta

public void setTheta(double theta)

getNumScales

public int getNumScales()

Number of scales used to create the pyramid of images.

setNumScales

public void setNumScales(int nscales)

getNumWarps

public int getNumWarps()

Number of warpings per scale. Represents the number of times that I1(x+u0) and grad( I1(x+u0) ) are computed per scale. This is a parameter that assures the stability of the method. It also affects the running time, so it is a compromise between speed and accuracy.

setNumWarps

public void setNumWarps(int warps)

getEpsilon

public double getEpsilon()

Stopping criterion threshold used in the numerical scheme, which is a trade-off between precision and running time. A small value will yield more accurate solutions at the expense of a slower convergence.

setEpsilon

public void setEpsilon(double epsilon)

getNumIterations

public int getNumIterations()

Stopping criterion iterations number used in the numerical scheme.

setNumIterations

public void setNumIterations(int iterations)

getScaleStep

public double getScaleStep()

setScaleStep

public void setScaleStep(double scaleStep)

getUseInitialFlow

@Cast(value="bool")
public boolean getUseInitialFlow()

setUseInitialFlow

public void setUseInitialFlow(@Cast(value="bool")
                              boolean useInitialFlow)

create

@opencv_core.Ptr
public static OpticalFlowDual_TVL1 create(double tau,
                                                           double lambda,
                                                           double theta,
                                                           int nscales,
                                                           int warps,
                                                           double epsilon,
                                                           int iterations,
                                                           double scaleStep,
                                                           double gamma,
                                                           @Cast(value="bool")
                                                           boolean useInitialFlow)

create

@opencv_core.Ptr
public static OpticalFlowDual_TVL1 create()