As of Version 12.2, VideoTimeSeries has been superseded by VideoMapTimeSeries.


applies f to each frame of the Video object video, returning a time series.


applies f to overlapping partitions of n video frames.


applies f to partitions with offset d.


  • VideoTimeSeries can be used to detect temporal or spatial events in videos, such as object detection, motion detection or activity recognition.
  • VideoTimeSeries returns a TimeSeries whose values are the results of f applied to each video frame or partition of video frames. The times are the timestamps of the corresponding frame or partition.
  • Frame variables n and d can be given as a scalar specifying the number of frames or a time Quantity object.
  • VideoTimeSeries supports video containers and codecs specified by $VideoDecoders.
  • The following options can be given:
  • AlignmentCenteralignment of the timestamps with partitions
    MetaInformationNoneinclude additional metainformation
    MissingDataMethodNonemethod to use for missing values
    ResamplingMethod"Interpolation"the method to use for resampling paths


open allclose all

Basic Examples  (2)

Compute the mean of the RGB colors for every video frame and plot them:

Compute image distance between consecutive frames:

Plot the result, showing times with significant scene change:

Applications  (2)

Find portions of a video with constant images:

Define a function to detect whether an image has constant pixel values:

Apply the function to each frame and plot the result:

Count the number of cars in each frame:

Possible Issues  (1)

When the function returns a list, all lists should have similar dimensions:

Pad or trim the resulting lists to the same size to store them in the TimeSeries:

Results may also be wrapped into other containers before being stored in a TimeSeries:

Wolfram Research (2020), VideoTimeSeries, Wolfram Language function,


Wolfram Research (2020), VideoTimeSeries, Wolfram Language function,


Wolfram Language. 2020. "VideoTimeSeries." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2020). VideoTimeSeries. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_videotimeseries, author="Wolfram Research", title="{VideoTimeSeries}", year="2020", howpublished="\url{}", note=[Accessed: 23-July-2024 ]}


@online{reference.wolfram_2024_videotimeseries, organization={Wolfram Research}, title={VideoTimeSeries}, year={2020}, url={}, note=[Accessed: 23-July-2024 ]}