Class cv::cuda::OpticalFlowDual_TVL1#

Implementation of the Zach, Pock and Bischof Dual TV-L1 Optical Flow method. View details

#include <opencv2/cudaoptflow.hpp>

Collaboration diagram for cv::cuda::OpticalFlowDual_TVL1:

Public Member Functions#

Public Member Functions inherited from cv::cuda::DenseOpticalFlow

Return	Name	Description
`void`	`calc(` `InputArray I0,` `InputArray I1,` `InputOutputArray flow,` `Stream & stream = Stream::Null() )`	Calculates a dense optical flow.

Public Member Functions inherited from cv::Algorithm

Return	Name	Description
	`Algorithm()`
	`~Algorithm()`
`void`	`clear()`	Clears the algorithm state.
`bool`	`empty()`	Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read.
`String`	`getDefaultName()`
`void`	`read(const FileNode & fn)`	Reads algorithm parameters from a file storage.
`void`	`save(const String & filename)`
`void`	`write(` `const Ptr< FileStorage > & fs,` `const String & name = String() )`
`void`	`write(FileStorage & fs)`	Stores algorithm parameters in a file storage.
`void`	`write(` `FileStorage & fs,` `const String & name )`

Static Public Member Functions#

Static Public Member Functions inherited from cv::Algorithm

Return	Name	Description
`static Ptr< _Tp >`	`load(` `const String & filename,` `const String & objname = String() )`	Loads algorithm from the file.
`static Ptr< _Tp >`	`loadFromString(` `const String & strModel,` `const String & objname = String() )`	Loads algorithm from a String.
`static Ptr< _Tp >`	`read(const FileNode & fn)`	Reads algorithm from the file node.

Additional Inherited Members#

Detailed Description#

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”.

Member Function Documentation#

getEpsilon()#

double cv::cuda::OpticalFlowDual_TVL1::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.

getGamma()#

double cv::cuda::OpticalFlowDual_TVL1::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.

getLambda()#

double cv::cuda::OpticalFlowDual_TVL1::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.

getNumIterations()#

int cv::cuda::OpticalFlowDual_TVL1::getNumIterations()

Stopping criterion iterations number used in the numerical scheme.

getNumScales()#

int cv::cuda::OpticalFlowDual_TVL1::getNumScales()

Number of scales used to create the pyramid of images.

getNumWarps()#

int cv::cuda::OpticalFlowDual_TVL1::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.

getScaleStep()#

double cv::cuda::OpticalFlowDual_TVL1::getScaleStep()

getTau()#

double cv::cuda::OpticalFlowDual_TVL1::getTau()

Time step of the numerical scheme.

getTheta()#

double cv::cuda::OpticalFlowDual_TVL1::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

getUseInitialFlow()#

bool cv::cuda::OpticalFlowDual_TVL1::getUseInitialFlow()

setEpsilon()#

void cv::cuda::OpticalFlowDual_TVL1::setEpsilon(double epsilon)

setGamma()#

void cv::cuda::OpticalFlowDual_TVL1::setGamma(double gamma)

setLambda()#

void cv::cuda::OpticalFlowDual_TVL1::setLambda(double lambda)

setNumIterations()#

void cv::cuda::OpticalFlowDual_TVL1::setNumIterations(int iterations)

setNumScales()#

void cv::cuda::OpticalFlowDual_TVL1::setNumScales(int nscales)

setNumWarps()#

void cv::cuda::OpticalFlowDual_TVL1::setNumWarps(int warps)

setScaleStep()#

void cv::cuda::OpticalFlowDual_TVL1::setScaleStep(double scaleStep)

setTau()#

void cv::cuda::OpticalFlowDual_TVL1::setTau(double tau)

setTheta()#

void cv::cuda::OpticalFlowDual_TVL1::setTheta(double theta)

setUseInitialFlow()#

void cv::cuda::OpticalFlowDual_TVL1::setUseInitialFlow(bool useInitialFlow)

create()#

static Ptr< OpticalFlowDual_TVL1 > cv::cuda::OpticalFlowDual_TVL1::create(
double tau = 0.25,
double lambda = 0.15,
double theta = 0.3,
int nscales = 5,
int warps = 5,
double epsilon = 0.01,
int iterations = 300,
double scaleStep = 0.8,
double gamma = 0.0,
bool useInitialFlow = false )

Source file#

The documentation for this class was generated from the following file:

opencv2/cudaoptflow.hpp