Open topic with navigation

# Object Recognition

Object Recognition recognizes known objects that appear in media. Object recognition identifies specific objects, not classes of objects.

Before using object recognition, you must train HPE Media Server by adding training images to the training database. For instructions that describe how to train HPE Media Server, refer to the HPE Media Server Administration Guide.

This section describes the parameters that you can use to configure object recognition.

Configuration Parameter | Description
--- | ---
ColorAnalysis | Whether to perform color analysis on detected objects to reduce false detections.
Database | An object database to use to recognize objects in an image.
Geometry | The analysis mode to use when comparing the source media to 2-D objects in the training database.
Geometry3 | The analysis mode to use when comparing the source media to 3-D objects in the training database.
Identifier | A comma-separated list of identifiers that specifies the objects to match against.
Input | The image track to process.
Metadata | A metadata field name and value to specify the objects to recognize.
NumParallel | The maximum number of video frames to analyze simultaneously.
ObjectEnvironment | The type of background that a partially or completely transparent object is superimposed on.
Occlusion | Whether the object might be partially hidden in images.
Region | A region of the frame to restrict processing to.
RegionUnit | The units that the Region parameter uses to specify the size and position of a region.
RestrictToInputRegion | Specifies whether to analyze a region of the input image or video frame that is specified in the input record, instead of the entire image.
SampleInterval | The interval at which frames are selected to be analyzed.
SyncDatabase | Specifies whether to synchronize with the training database before beginning the analysis task.
Type | The analysis engine to use. Set this parameter to `Object`.

## 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` | ObjectResult | Contains a record for every frame in which an object is detected. | No
`DataWithSource` | ObjectResultAndImage | Contains the same information as the `Data` track, but each record also includes the source frame. | No
`Event` | ObjectEvent | HPE Media Server creates a record in the `Event` track when an object appears or disappears. | Yes
`Result` | ObjectResult | Contains a single record for each detected object (a detected object might appear in many consecutive frames). This track only contains the best result from running analysis on an object. | Yes
`ResultWithSource` | ObjectResultAndImage | Contains the same information as the `Result` track, but each record also includes the best source frame. | No

ObjectResult

Field name | Type | Description
--- | --- | ---
id | UUIDData | A universally unique identifier to identify the object
identity | IdentityData | The identity of the model in the database that matches the detected object
boundary | PolygonData | A polygon to indicate the location of the object in the frame

ObjectResultAndImage

Field name | Type | Description
--- | --- | ---
id | UUIDData | A universally unique identifier to identify the object
identity | IdentityData | The identity of the model in the database that matches the detected object
boundary | PolygonData | A polygon to indicate the location of the object in the frame
image | ImageData | The source frame

ObjectEvent

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 appeared
identity | IdentityData | The identity of the model in the database that matches the detected object

© 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