Recognize Faces

This section describes how to create an analysis task to recognize faces that appear in media.


To run face recognition, you must first detect faces by setting up a face detection task. For information about how to do this, see Detect Faces.

To recognize faces in media

  1. Create a new configuration to send to Media Server with the process action, or open an existing configuration that you want to modify.

  2. In the [Analysis] section, add a new analysis task by setting the AnalysisEngineN parameter. You can give the task any name, for example:

  3. Create a new configuration section to contain the task settings, and set the following parameters:

    Type The analysis engine to use. Set this parameter to FaceRecognize.
    Input The track that contains detected faces that you want to recognize. Set this parameter to the ResultWithSource output track from your face detection task. For example, if your face detection task is named FaceDetect, set this parameter to FaceDetect.ResultWithSource.
    Database (Optional) The database to use for recognizing the detected faces. By default, Media Server uses all available data. Database names are case-sensitive.

    If you are creating a configuration to run under a surveillance license, and you want to recognize more than 250 faces, set the MaxFaces parameter to the total number of faces that you want to recognize. For example if there are 600 faces in your face database, set MaxFaces=600. The value of this parameter determines how many surveillance channels are required to run the face recognition task.

    Alternatively, you can set MaxFaces=Unlimited, in which case Media Server uses a single visual channel for running the process action. The number of faces that you can recognize using a visual channel is not limited.

    RecognitionThreshold (Optional) The minimum confidence score required to recognize a face.
    MaxRecognitionResults (Optional) The maximum number of results to return, if the face matches more than one entry in the training database(s).

    For example:


    For a complete list of parameters that you can use to configure a face recognition task, and more information about these parameters, refer to the Media Server Reference.

  4. Save and close the configuration file. HPE recommends that you save your configuration files in the location specified by the ConfigDirectory parameter.