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

cvDISOpticalFlow


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.