WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

ImageFeatureTrack
✖
ImageFeatureTrack

✖
ImageFeatureTrack[{image1,image2,…,imagen}]

tracks features from image1 through imagen.

✖
ImageFeatureTrack[{image1,image2,…,imagen},pts]

tracks features starting from the initial set of points pts in image1.

Details and Options

  • ImageFeatureTrack tracks feature points in a sequence of images.
  • ImageFeatureTrack works with an AnimatedImage or a sequence of images of the same dimensions.
  • ImageFeatureTrack[{image1,image2,…,imagen}] automatically determines a set of feature points in the images to track, and returns a list {pts1,pts2,…,ptsn}, where ptsi is the position of the features in imagei.
  • ImageFeatureTrack assumes the standard image coordinate system, where x runs from 0 to width and y runs from 0 to height. Position {0,0} corresponds to the bottom-left corner of the image.
  • If a point is not found in some imagei, the coordinates are returned as Missing[].
  • The following options can be specified:
  • Masking Allregion of interest
    MaxFeatureDisplacement15maximum distance between corresponding points in adjacent images
    MaxFeatures 100maximum number of tracked points
    MaxIterations20maximum number of iterations
    Tolerance0.03tolerance for matching points
  • With the setting MaxFeatureDisplacement->{r1,r2}, different search window ranges can be specified for vertical and horizontal directions.
  • With Masking->roi, the set of points is restricted so that the returned points pts1 of image1 all lie within the region of interest roi.
  • The tracking between subsequent images is computed by an iterative algorithm. With MaxIterations->n and Tolerance->tol, the algorithm terminates when the iterative displacement is less than tol or the number of iterations exceeds n.

Examples

open allclose all

Basic Examples  (1)Summary of the most common use cases

Track specified points from one image to another:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-flr0be
Out[1]=1

Scope  (2)Survey of the scope of standard use cases

Automatically find the initial set of points to track:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-dblpnu
Out[1]=1

Visualize tracked points:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-bh7o7q
Out[1]=1

Options  (2)Common values & functionality for each option

Masking  (1)

Track only the points that are inside of the specified mask:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-vhtoos
Out[3]=3

MaxFeatures  (1)

Specify a maximum number of points to be tracked:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-vmp9mv

Applications  (2)Sample problems that can be solved with this function

Show the optical flow of points in two images:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-dazn1a
Out[2]=2

Track the image corners between images:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-h6bzw7
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0fq6nv1gepiuu-tg8pr1
Out[2]=2

Interactive Examples  (1)Examples with interactive outputs

Track points in a sequence of images:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-4vjr3
Out[4]=4

Plot the motion of each tracked feature:

In[5]:=5
✖
https://wolfram.com/xid/0fq6nv1gepiuu-wt2vy1
Out[5]=5

Neat Examples  (1)Surprising or curious use cases

Tracking particles:

In[1]:=1
✖
https://wolfram.com/xid/0fq6nv1gepiuu-w13f6e
In[17]:=17
✖
https://wolfram.com/xid/0fq6nv1gepiuu-9c1i2a
Out[17]=17
Wolfram Research (2012), ImageFeatureTrack, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageFeatureTrack.html (updated 2022).
✖
Wolfram Research (2012), ImageFeatureTrack, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageFeatureTrack.html (updated 2022).

Text

Wolfram Research (2012), ImageFeatureTrack, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageFeatureTrack.html (updated 2022).

✖
Wolfram Research (2012), ImageFeatureTrack, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageFeatureTrack.html (updated 2022).

CMS

Wolfram Language. 2012. "ImageFeatureTrack." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/ImageFeatureTrack.html.

✖
Wolfram Language. 2012. "ImageFeatureTrack." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/ImageFeatureTrack.html.

APA

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

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

BibTeX

@misc{reference.wolfram_2025_imagefeaturetrack, author="Wolfram Research", title="{ImageFeatureTrack}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/ImageFeatureTrack.html}", note=[Accessed: 07-June-2025 ]}

✖
@misc{reference.wolfram_2025_imagefeaturetrack, author="Wolfram Research", title="{ImageFeatureTrack}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/ImageFeatureTrack.html}", note=[Accessed: 07-June-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_imagefeaturetrack, organization={Wolfram Research}, title={ImageFeatureTrack}, year={2022}, url={https://reference.wolfram.com/language/ref/ImageFeatureTrack.html}, note=[Accessed: 07-June-2025 ]}

✖
@online{reference.wolfram_2025_imagefeaturetrack, organization={Wolfram Research}, title={ImageFeatureTrack}, year={2022}, url={https://reference.wolfram.com/language/ref/ImageFeatureTrack.html}, note=[Accessed: 07-June-2025 ]}