Class DISOpticalFlow

Namespace

Emgu.CV

Assembly

Emgu.CV.dll

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.

public class DISOpticalFlow : UnmanagedObject, IDisposable, IDenseOpticalFlow, IAlgorithm

Inheritance

object

DisposableObject

UnmanagedObject

DISOpticalFlow

Implements

IDisposable

IDenseOpticalFlow

IAlgorithm

Inherited Members

UnmanagedObject._ptr

UnmanagedObject.Ptr

DisposableObject.Dispose()

DisposableObject.ReleaseManagedResources()

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Extension Methods

AlgorithmExtensions.Clear(IAlgorithm)

AlgorithmExtensions.GetDefaultName(IAlgorithm)

AlgorithmExtensions.IsEmpty(IAlgorithm)

AlgorithmExtensions.Load(IAlgorithm, string, string, string)

AlgorithmExtensions.LoadFromString(IAlgorithm, string, string, string)

AlgorithmExtensions.Read(IAlgorithm, FileNode)

AlgorithmExtensions.Save(IAlgorithm, string)

AlgorithmExtensions.SaveToString(IAlgorithm, string)

AlgorithmExtensions.Write(IAlgorithm, FileStorage, string)

AlgorithmExtensions.Write(IAlgorithm, FileStorage)

DenseOpticalFlowExtensions.Calc(IDenseOpticalFlow, IInputArray, IInputArray, IInputOutputArray)

Constructors

DISOpticalFlow(Preset)

Create an instance of DIS optical flow algorithm.

public DISOpticalFlow(DISOpticalFlow.Preset preset = Preset.Fast)

Parameters

preset DISOpticalFlow.Preset

Algorithm preset

Properties

AlgorithmPtr

Pointer to cv::Algorithm

public nint AlgorithmPtr { get; }

Property Value

nint

DenseOpticalFlowPtr

Pointer to native cv::DenseOpticalFlow

public nint DenseOpticalFlowPtr { get; }

Property Value

nint

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.

public int FinestScale { get; set; }

Property Value

int

GradientDescentIterations

Maximum number of gradient descent iterations in the patch inverse search stage. Higher values may improve quality in some cases.

public int GradientDescentIterations { get; set; }

Property Value

int

PatchSize

Size of an image patch for matching (in pixels). Normally, default 8x8 patches work well enough in most cases.

public int PatchSize { get; set; }

Property Value

int

PatchStride

Stride between neighbor patches. Must be less than patch size. Lower values correspond to higher flow quality.

public int PatchStride { get; set; }

Property Value

int

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.

public bool UseMeanNormalization { get; set; }

Property Value

bool

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.

public bool UseSpatialPropagation { get; set; }

Property Value

bool

VariationalRefinementAlpha

Weight of the smoothness term

public float VariationalRefinementAlpha { get; set; }

Property Value

float

VariationalRefinementDelta

Weight of the color constancy term

public float VariationalRefinementDelta { get; set; }

Property Value

float

VariationalRefinementGamma

Weight of the gradient constancy term

public float VariationalRefinementGamma { get; set; }

Property Value

float

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.

public int VariationalRefinementIterations { get; set; }

Property Value

int

Methods

DisposeObject()

Release the unmanaged memory associated with this Optical flow algorithm.

protected override void DisposeObject()