DISOpticalFlow Class

http://www.emgu.com

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 Hierarchy

SystemObject
  Emgu.UtilDisposableObject
    Emgu.UtilUnmanagedObject
      Emgu.CVDISOpticalFlow

Namespace: Emgu.CV
Assembly: Emgu.CV.World (in Emgu.CV.World.dll) Version: 4.0.1.3373 (4.0.1.3373)

Syntax

C++

Copy

public class DISOpticalFlow : UnmanagedObject, 
	IDenseOpticalFlow, IAlgorithm

Public Class DISOpticalFlow
	Inherits UnmanagedObject
	Implements IDenseOpticalFlow, IAlgorithm

public ref class DISOpticalFlow : public UnmanagedObject, 
	IDenseOpticalFlow, IAlgorithm

type DISOpticalFlow =  
    class
        inherit UnmanagedObject
        interface IDenseOpticalFlow
        interface IAlgorithm
    end

The DISOpticalFlow type exposes the following members.

Constructors

	Name	Description
	DISOpticalFlow	Create an instance of DIS optical flow algorithm.

Top

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.

Top

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	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Destructor (Inherited from DisposableObject.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (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	Returns a string that represents the current object. (Inherited from Object.)

Top

Fields

	Name	Description
	_ptr	A pointer to the unmanaged object (Inherited from UnmanagedObject.)

Top

Extension Methods

	Name	Description
	Calc	Calculates an optical flow. (Defined by DenseOpticalFlowExtensions.)
	Clear	Clear the algorithm (Defined by AlgorithmExtensions.)
	GetDefaultName	Returns the algorithm string identifier. This string is used as top level xml/yml node tag when the object is saved to a file or string. (Defined by AlgorithmExtensions.)
	IsEmpty	Returns true if the Algorithm is empty. e.g. in the very beginning or after unsuccessful read. (Defined by AlgorithmExtensions.)
	Load	Loads algorithm from the file (Defined by AlgorithmExtensions.)
	LoadFromString	Loads algorithm from a String (Defined by AlgorithmExtensions.)
	Read	Reads algorithm parameters from a file storage. (Defined by AlgorithmExtensions.)
	Save	Save the algorithm to file (Defined by AlgorithmExtensions.)
	SaveToString	Save the algorithm to a string (Defined by AlgorithmExtensions.)
	Write(FileStorage)	Overloaded. Stores algorithm parameters in a file storage (Defined by AlgorithmExtensions.)
	Write(FileStorage, String)	Overloaded. Stores algorithm parameters in a file storage (Defined by AlgorithmExtensions.)

Top

Reference

Emgu.CV Namespace