WOLFRAM

Wolfram Language & System Documentation Center

ImageDisplacements[{image1,image2,…,imagen}]

gives estimated horizontal and vertical displacements between consecutive images.

ImageDisplacements[video]

gives displacements between consecutive video frames.

ImageDisplacements[input,flow]

uses flow as an initial estimate for displacement between first two images or video frames.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Applications  
Interactive Examples  
See Also
Related Guides
History
Cite this Page

ImageDisplacements

ImageDisplacements[{image1,image2,…,imagen}]

gives estimated horizontal and vertical displacements between consecutive images.

ImageDisplacements[video]

gives displacements between consecutive video frames.

ImageDisplacements[input,flow]

uses flow as an initial estimate for displacement between first two images or video frames.

Details and Options

  • ImageDisplacements, also known as dense optical flow, compares consecutive images or video frames and returns a list of displacement matrices.
  • For a pair of consecutive images imagei and imagei+1, the displacement matrix returns a {δx,δy} for every pixel of imagei.
  • ImageDisplacements works with an AnimatedImage, a Video object or a sequence of images of the same dimensions.
  • The following options are supported:
  • MaxIterations10number of iterations to run
    MethodAutomaticthe method to use
    PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
  • By default, the more suitable method is used. Possible method settings are "Farneback" and "DenseInverseSearch".

Examples

open all close all

Basic Examples  (2)

Compute the displacement between two images:

Plot the displacements:

Compute the displacements between consecutive images of a list:

Applications  (2)

Detect rotating objects in a wind farm:

Extract the rotation component of the flow by computing its curl:

Colorize the rotation map and superimpose it on top of the original image:

Compute and visualize divergence of a velocity field:

Compute the displacements:

Compute divergence of displacements:

Visualize the divergence on each frame:

Interactive Examples  (1)

Slow motion video effect:

Compute the optical flow:

Construct the interpolated frames and insert them into the final sequence:

Wolfram Research (2016), ImageDisplacements, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageDisplacements.html (updated 2025).

Text

Wolfram Research (2016), ImageDisplacements, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageDisplacements.html (updated 2025).

CMS

Wolfram Language. 2016. "ImageDisplacements." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/ImageDisplacements.html.

APA

Wolfram Language. (2016). ImageDisplacements. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ImageDisplacements.html

BibTeX

@misc{reference.wolfram_2025_imagedisplacements, author="Wolfram Research", title="{ImageDisplacements}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/ImageDisplacements.html}", note=[Accessed: 15-August-2025]}

BibLaTeX

@online{reference.wolfram_2025_imagedisplacements, organization={Wolfram Research}, title={ImageDisplacements}, year={2025}, url={https://reference.wolfram.com/language/ref/ImageDisplacements.html}, note=[Accessed: 15-August-2025]}