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 Media Server by adding training images to the training database. For instructions that describe how to train Media Server, refer to the Media Server Administration Guide.

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.
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 recognize.
Input The image track to process.
MaxInputQueueLength Can be used to place a limit on latency.
MaxSize The maximum expected size of an object.
Metadata A metadata field name and value that specifies the objects to recognize.
MinimumMatchPercentage The (approximate) minimum proportion of the trained object that must be recognized.
MinSize The minimum expected size of an object.
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.
SampleInterval The interval at which frames are selected to be analyzed.
SegmentDuration The maximum duration of a record in the SegmentedResult or SegmentedResultWithSource track.
SyncDatabase Specifies whether to synchronize with the training database before beginning the analysis task.
Type The analysis engine to use. Set this parameter to ObjectRecognition.

Output Tracks

Output track Description Output1
Data Contains one record, describing the analysis results, per recognized object, per video frame. No
DataWithSource

The same as the Data track, but each record also includes the source frame.

No
Result Contains one record, describing the analysis results, for each recognized object. When the same object appears in many consecutive frames, Media Server produces a single result. Yes
ResultWithSource

The same as the Result track, but each record also includes the best source frame.

No
SegmentedResult

(Available only when processing video). The same as the Result track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID.

Yes
SegmentedResultWithSource

(Available only when processing video). The same as the ResultWithSource track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID.

No
Start

The same as the Data track, except it contains only the first record of each event.

No
End

The same as the Data track, except it contains only the last record of each event.

No

For more information see Object Recognition Results or use the action GetExampleRecord.