WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

VideoIntervals
✖
VideoIntervals

[Experimental]

✖
VideoIntervals[video,crit]

returns time intervals of video for which the criterion crit is satisfied.

✖
VideoIntervals[video,crit,n]

evaluates criterion crit on partitions of n video frames.

✖
VideoIntervals[video,crit,n,d]

evaluates crit on partitions with offset d.

✖
VideoIntervals[{video1,video2,…},crit,…]

applies crit to a list of inputs extracted from each videoi.

Details and Options

  • VideoIntervals can be used to detect time intervals of interest in a video, such as constant frame, silent audio intervals, intervals containing a specific object, etc.
  • A criterion crit of a single argument gets applied to image frames or a list of image frames.
  • A pure function crit can access video and audio data as well as time using the following arguments:
  • #Imagevideo frames as Image objects
    #Audioa chunk of the audio as an Audio object
    #Timetime from the beginning of the video
    #TimeIntervalbeginning and end time stamps for the current partition
    #FrameIndexindex of the current output frame
    #InputFrameIndexindex of the current input frame
  • In VideoIntervals[{video1,video2,…},crit,…], data provided to each of the arguments is a list where the i^(th) element corresponds to the data extracted from videoi.
  • By default, partitions are offset by one frame.
  • VideoIntervals supports video containers and codecs specified by $VideoDecoders.
  • The following options can be given:
  • AlignmentCenteralignment of the time stamps with partitions
    MaxItems Infinitymaximum number of intervals to return
  • By default, measurements are returned at the center of each partition. Using the Alignment option, measurements can be returned at the beginning (Left) or end (Right) of each partition.

Examples

open allclose all

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

Find video intervals with constant frames:

In[2]:=2
✖
https://wolfram.com/xid/0g7lynvrock-w4zuyc
In[3]:=3
✖
https://wolfram.com/xid/0g7lynvrock-v149ey
Out[3]=3

Find video intervals with loud audio:

In[1]:=1
✖
https://wolfram.com/xid/0g7lynvrock-0rhvb1
In[2]:=2
✖
https://wolfram.com/xid/0g7lynvrock-inmknh
Out[2]=2

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

Specify the criterion as a pure function:

In[14]:=14
✖
https://wolfram.com/xid/0g7lynvrock-fhqbjz
In[17]:=17
✖
https://wolfram.com/xid/0g7lynvrock-6rbkd
Out[17]=17

Specify the criterion as a normal function:

In[18]:=18
✖
https://wolfram.com/xid/0g7lynvrock-k2rvme
In[19]:=19
✖
https://wolfram.com/xid/0g7lynvrock-p9lamk
Out[19]=19

The input to the criterion function is an association with keys "Time", "TimeInterval", "Image", "FrameIndex", "InputFrameIndex" and "Audio" (if present):

In[1]:=1
✖
https://wolfram.com/xid/0g7lynvrock-u6zedc
In[2]:=2
✖
https://wolfram.com/xid/0g7lynvrock-ii1j3z
Out[2]=2

Evaluate the criterion on a buffer of five frames:

In[1]:=1
✖
https://wolfram.com/xid/0g7lynvrock-tlw2k1
In[2]:=2
✖
https://wolfram.com/xid/0g7lynvrock-kx84zj
Out[2]=2

If the partition size is not Automatic, the value for "Image" will be a list of images:

In[3]:=3
✖
https://wolfram.com/xid/0g7lynvrock-vdx750
In[4]:=4
✖
https://wolfram.com/xid/0g7lynvrock-1vgxrc
Out[4]=4

The value for "Audio" is always a single Audio object of the appropriate duration:

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

Evaluate the criterion on non-overlapping partitions of five frames:

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

Specify partition size and offset using time quantities:

In[1]:=1
✖
https://wolfram.com/xid/0g7lynvrock-67naiy
Out[1]=1

Options  (1)Common values & functionality for each option

MaxItems  (1)

By default, using MaxItems∞, the whole input is evaluated for possible intervals of interest:

In[1]:=1
✖
https://wolfram.com/xid/0g7lynvrock-dq9geh
In[2]:=2
✖
https://wolfram.com/xid/0g7lynvrock-yvnbv5
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0g7lynvrock-uwghb9
Out[3]=3

Stop the computation once n complete intervals have been detected:

In[4]:=4
✖
https://wolfram.com/xid/0g7lynvrock-ffzrkb
Out[4]=4

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

Find the intervals that contain the most motion in a video:

In[20]:=20
✖
https://wolfram.com/xid/0g7lynvrock-lvcbwb
Out[20]=20

Extract the corresponding frames:

In[21]:=21
✖
https://wolfram.com/xid/0g7lynvrock-tx3tej
Out[21]=21

Find the intervals that contain constant frames:

In[1]:=1
✖
https://wolfram.com/xid/0g7lynvrock-va28jx
In[2]:=2
✖
https://wolfram.com/xid/0g7lynvrock-ysa594
Out[2]=2

Delete such intervals from the video:

In[3]:=3
✖
https://wolfram.com/xid/0g7lynvrock-7f6ht0
Out[3]=3

Compare the duration of the original and resulting videos:

In[4]:=4
✖
https://wolfram.com/xid/0g7lynvrock-xay5j2
Out[4]=4
Wolfram Research (2020), VideoIntervals, Wolfram Language function, https://reference.wolfram.com/language/ref/VideoIntervals.html.
✖
Wolfram Research (2020), VideoIntervals, Wolfram Language function, https://reference.wolfram.com/language/ref/VideoIntervals.html.

Text

Wolfram Research (2020), VideoIntervals, Wolfram Language function, https://reference.wolfram.com/language/ref/VideoIntervals.html.

✖
Wolfram Research (2020), VideoIntervals, Wolfram Language function, https://reference.wolfram.com/language/ref/VideoIntervals.html.

CMS

Wolfram Language. 2020. "VideoIntervals." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/VideoIntervals.html.

✖
Wolfram Language. 2020. "VideoIntervals." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/VideoIntervals.html.

APA

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

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

BibTeX

@misc{reference.wolfram_2025_videointervals, author="Wolfram Research", title="{VideoIntervals}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/VideoIntervals.html}", note=[Accessed: 16-April-2025 ]}

✖
@misc{reference.wolfram_2025_videointervals, author="Wolfram Research", title="{VideoIntervals}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/VideoIntervals.html}", note=[Accessed: 16-April-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_videointervals, organization={Wolfram Research}, title={VideoIntervals}, year={2020}, url={https://reference.wolfram.com/language/ref/VideoIntervals.html}, note=[Accessed: 16-April-2025 ]}

✖
@online{reference.wolfram_2025_videointervals, organization={Wolfram Research}, title={VideoIntervals}, year={2020}, url={https://reference.wolfram.com/language/ref/VideoIntervals.html}, note=[Accessed: 16-April-2025 ]}