Scene Analysis

A Scene Analysis task detects objects or events in a scene that are deemed important to the user. These events might be a vehicle breaching a red light, the presence of an abandoned bag, or traffic congestion.

This section describes the parameters that you can use to configure a Scene Analysis task.

Configuration Parameter Description
BackgroundUpdateOnAlarm Specifies whether to update the background in areas that are generating alarms.
Input The image track to analyze.
IsasTuDataOption Specifies whether Media Server provides data required by the Scene Analysis Training Utility.
LearntSceneActivityThreshold The maximum amount that the live video can differ from its matching learned scene.
LearntSceneCompareProportion The proportion of a learnt scene to compare against other scenes.
LearntSceneDirectory The location of a directory containing learnt scene image files.
LearntSceneStem The file name prefix to identify learnt scene files.
MaskOverlay Specifies whether to attempt to mask areas of the view that remain static.
NumParallel The maximum number of CPU threads to use for scene analysis.
PtzFolder The location of a directory containing training configuration files for use with PTZ mode.
SampleInterval The interval at which frames are selected to be analyzed.
Type The analysis engine to use. Set this parameter to SceneAnalysis.
TallPixels Specifies whether the pixels in the video source have a 2:1 aspect ratio.
TimeBetweenAlarms The minimum interval between alarms.
TrainingCfg The path to the training configuration file to use to identify suspicious events.
TrainingCfgName The name of the training configuration file to use to identify suspicious events.

Output Tracks

Output track Type Description Output1This column indicates whether the information contained in the track is included by default in the output created by an output task (when you don't set the Input parameter for the output task).
Data SceneAnalysisResult Contains a record for each frame that contains an alarm object. No
DataWithSource SceneAnalysisResultAndImage Contains the same information as the Data track, but each record also includes the source frame. No
Event SceneAnalysisEvent The engine creates a record in the Event track whenever an event begins (an alarm occurs) or ends (the object leaves the scene or can no longer be tracked). No
Result SceneAnalysisResult Contains a record for each detected alarm object. Yes
ResultWithSource SceneAnalysisResultAndImage Contains the same information as the Result track, but each record also includes the first frame in which the alarm object caused an alarm. No
TrainingUtilAlarms   Contains alarm information that must be passed to the Scene Analysis Training Utility so that you can classify alarms and use them to improve the training. No
TrainingUtilData   Contains data that must be passed to the Scene Analysis Training Utility so that the Training Utility can display live video, the object tracking overlay, and show when objects cause alarms. No

SceneAnalysisResult

Field name Type Description
id UUIDData A universally unique identifier to identify the object
object ISAS_Object

Information about the alarm object. This includes information such as:

  • The size of the alarm object.
  • The bounding box that contains the alarm object.
  • The position of the center of the alarm object.
  • The velocity of the alarm object.
  • The amount of time that the object has been within the region of interest.

SceneAnalysisResultAndImage

Field name Type Description
id UUIDData A universally unique identifier to identify the object
object ISAS_Object

Information about the alarm object. This includes information such as:

  • The size of the alarm object.
  • The bounding box that contains the alarm object.
  • The position of the center of the alarm object.
  • The velocity of the alarm object.
  • The amount of time that the object has been within the region of interest.
image ImageData The source frame

SceneAnalysisEvent

Field name Type Description
id UUIDData A universally unique identifier to identify the object
event TrackingEventData The type of event (begin/end), and the elapsed time since the object first caused an alarm
category String The name of the category for which the alarm was generated

_HP_HTML5_bannerTitle.htm