| DISOpticalFlow Class |
DIS optical flow algorithm.
This class implements the Dense Inverse Search(DIS) optical flow algorithm.Includes three presets with preselected parameters to provide reasonable trade-off between speed and quality.However, even the slowest preset is still relatively fast, use DeepFlow if you need better quality and don't care about speed.
More details about the algorithm can be found at:
Till Kroeger, Radu Timofte, Dengxin Dai, and Luc Van Gool. Fast optical flow using dense inverse search. In Proceedings of the European Conference on Computer Vision (ECCV), 2016.
Inheritance HierarchyNamespace: Emgu.CV
Assembly: Emgu.CV.World (in Emgu.CV.World.dll) Version: 3.2.0.2682 (3.2.0.2682)
SyntaxThe DISOpticalFlow type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | DISOpticalFlow |
Create an instance of DIS optical flow algorithm.
|
Properties| Name | Description | |
|---|---|---|
 | AlgorithmPtr |
Pointer to cv::Algorithm
|
| DenseOpticalFlowPtr |
Pointer to native cv::DenseOpticalFlow
|
| FinestScale |
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.
|
| GradientDescentIterations |
Maximum number of gradient descent iterations in the patch inverse search stage. Higher values may improve quality in some cases.
|
| PatchSize |
Size of an image patch for matching (in pixels). Normally, default 8x8 patches work well enough in most cases.
|
| PatchStride |
Stride between neighbor patches. Must be less than patch size. Lower values correspond to higher flow quality.
|
| Ptr |
Pointer to the unmanaged object
(Inherited from UnmanagedObject.) |
| UseMeanNormalization |
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.
|
| UseSpatialPropagation |
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.
|
| VariationalRefinementAlpha |
Weight of the smoothness term
|
| VariationalRefinementDelta |
Weight of the color constancy term
|
| VariationalRefinementGamma |
Weight of the gradient constancy term
|
| VariationalRefinementIterations |
Number of fixed point iterations of variational refinement per scale. Set to zero to disable variational refinement completely. Higher values will typically result in more smooth and high-quality flow.
|
Methods| Name | Description | |
|---|---|---|
| Dispose |
The dispose function that implements IDisposable interface
(Inherited from DisposableObject.) |
 | DisposeObject |
Release the unmanaged memory associated with this Optical flow algorithm.
(Overrides DisposableObjectDisposeObject.) |
| Equals | (Inherited from Object.) |
| Finalize |
Destructor
(Inherited from DisposableObject.) |
| GetHashCode | (Inherited from Object.) |
| GetType | (Inherited from Object.) |
| MemberwiseClone | (Inherited from Object.) |
| ReleaseManagedResources |
Release the managed resources. This function will be called during the disposal of the current object.
override ride this function if you need to call the Dispose() function on any managed IDisposable object created by the current object
(Inherited from DisposableObject.) |
| ToString | (Inherited from Object.) |
Fields| Name | Description | |
|---|---|---|
 | _ptr |
A pointer to the unmanaged object
(Inherited from UnmanagedObject.) |
Extension Methods| Name | Description | |
|---|---|---|
 | Calc |
Calculates an optical flow.
(Defined by DenseOpticalFlowExtensions.) |
| Read |
Reads algorithm parameters from a file storage.
(Defined by AlgorithmExtensions.) |
| Write |
Stores algorithm parameters in a file storage
(Defined by AlgorithmExtensions.) |
See Also