Start » Filter Reference » OpenCV » Motion Analysis and Object Tracking » cvDISOpticalFlow

cvDISOpticalFlow

Basic

Module: OpenCV

DIS optical flow algorithm.

Name Type Description
Input value
 inSrc1 Image First input image.
Input value
 inSrc2 Image Second input image.
Input value
 inPreset CvDISOpticalFlowPreset
Input value
 inFinestScale Integer* Finest level of the Gaussian pyramid on which the flow is computed (zero level corresponds to the original image resolution). The final flow is obtained by bilinear upscaling.
Input value
 inGradientDescentIterations Integer* Maximum number of gradient descent iterations in the patch inverse search stage. Higher values may improve quality in some cases.
Input value
 inPatchSize Integer* Size of an image patch for matching (in pixels). Normally, default 8x8 patches work well enough in most cases.
Input value
 inPatchStride Integer* Stride between neighbor patches. Must be less than patch size. Lower values correspond to higher flow quality.
Input value
 inUseMeanNormalization Bool* Whether to use mean-normalization of patches when computing patch distance. It is turned on by default as it typically provides a noticeable quality boost because of increased robustness to illumination variations. Turn it off if you are certain that your sequence doesn't contain any changes in illumination.
Input value
 inUseSpatialPropagation Bool* Whether to use spatial propagation of good optical flow vectors. This option is turned on by default, as it tends to work better on average and can sometimes help recover from major errors introduced by the coarse-to-fine scheme employed by the DIS optical flow algorithm. Turning this option off can make the output flow field a bit smoother, however.
Input value
 inVariationalRefinementAlpha Real* Weight of the smoothness term.
Input value
 inVariationalRefinementDelta Real* Weight of the color constancy term.
Input value
 inVariationalRefinementGamma Real* Weight of the gradient constancy term.
Input value
 inVariationalRefinementIterations Integer* Maximum number of gradient descent iterations in the patch inverse search stage. Higher values may improve quality in some cases.
Output value
 outFlow Image

Requirements

For input inSrc1 only pixel formats are supported: 1⨯uint8.

For input inSrc2 only pixel formats are supported: 1⨯uint8.

Read more about pixel formats in Image documentation.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Not supported inSrc1 pixel format in AvsFilter_cvDISOpticalFlow. Supported formats: 1xUInt8.
DomainError Not supported inSrc2 pixel format in AvsFilter_cvDISOpticalFlow. Supported formats: 1xUInt8.

Complexity Level

This filter is available on Basic Complexity Level.