ObjectClassRecognition

Runs object class recognition on the file(s) associated with an IDOL document FlowFile, and adds information about any recognized objects to the IDOL document.

To run object class recognition you must have a recognizer. Micro Focus provides some pre-trained recognizers, and you can create your own. For more information about object class recognition, including how to train a recognizer, refer to the Media Server Administration Guide.

Properties

Name Default Value Description
IDOL License Service   An IdolLicenseServiceImpl that provides a way to communicate with an IDOL License Server.
Media Service   A MediaServiceImpl that manages media analysis resources.
Recognizer File   The path of a file that contains the recognizer to use. Set this property to use a recognizer that you exported from Media Server, using the action ExportObjectClassRecognizer.
Shared Recognizer   The name of the recognizer to use for object class recognition. Set this property to use a recognizer that is stored in the external database specified by the Media Service (see the "Media Service" property).

Relationships

Name Description
success Processing was successful.
failure Processing failed.

Example Output

The following example shows the metadata that can be added to an IDOL document, when object class recognition runs on an image:

<idol_media>
    <objectclasses>
        <objectclass page="1">
            <recognizer>ObjectClassRecognizer_Gen2_Surveillance</recognizer>
            <class>car</class>
            <region height="130" left="11" page="1" top="22" width="264"/>
        </objectclass>
        ...
    </objectclasses>
</idol_media>

The XML contains an objectclass element for each object that is recognized.

When you run object class recognition on a video, there can be multiple region elements because the object can be tracked across multiple video frames. The page attributes are replaced with start and duration attributes that provide video timestamps, in seconds. For example:

<idol_media>
    <objectclasses>
        <objectclass duration="2.335666" start="5.972633">
            <recognizer>ObjectClassRecognizer_Gen2_Surveillance</recognizer>
            <class>car</class>
            <region duration="0.033366" height="26" left="1058" start="5.972633" top="62" width="36"/>
            <region duration="0.033366" height="30" left="1060" start="6.072733" top="64" width="40"/>
            <region duration="0.033366" height="33" left="1063" start="6.172833" top="69" width="44"/>
            <region duration="0.033366" height="37" left="1066" start="6.272933" top="74" width="48"/>
            <region duration="0.033366" height="40" left="1069" start="6.373033" top="79" width="51"/>
            ...
        </objectclass>
        ....
    </objectclasses>
</idol_media>

In this example you can see that the car's height and width are increasing as the start time increases. This indicates that the car is moving towards the camera.