Open topic with navigation

# 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 HPE 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

© 2017 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm