Media Server 25.4
Media Server Help

# SampleInterval

Analysis tasks usually do not process every frame of a video.

This parameter specifies the minimum interval between frames that are selected to be analyzed. For example, if you set `SampleInterval=125ms` then any two frames analyzed by the task will be separated by at least 125 milliseconds. This means that at most eight frames are analyzed for every second of video.

If the parameter IngestRate is set to `0`, the interval between the frames selected for analysis will be as close as possible to `SampleInterval`.

If the parameter IngestRate is set to `1`, the interval between the frames selected for analysis will also be as close as possible to `SampleInterval`. However, if the analysis task cannot process frames at this rate, it will increase the sample interval. For example, if you set `SampleInterval=125ms` but the task is not able to analyze eight frames per second, it increases the sample interval and processes fewer frames than you requested.

In most cases OpenText recommends that you use the default value of `SampleInterval`. If you have set `IngestRate=1` and a task significantly increases the sample interval, or if you have set `IngestRate=0` and processing takes a long time, it might be due to the server having insufficient resources.

NOTE: When the input for the analysis task is provided by another analysis task, the `SampleInterval` parameter is ignored. Media Server attempts to analyze all of the input frames. If this is not possible, for example due to the server having insufficient resources, Media Server increases the sample interval of the first analysis task.

Type: | Time duration The value of this parameter is a time duration. Specify a value using one or more of the following units:
         days          d
         hours         h
         minutes       m
         seconds       s
         milliseconds  ms
         microseconds  us
For example, all of the following are equivalent:
         1minute 3seconds
         1m 3s
         63s
Default: | 1000ms
Required: | No
Configuration Section: | TaskName
Example: | `SampleInterval=250ms`
See Also: | IngestRate NumParallel

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.4

Topic Title: SampleInterval