Open topic with navigation

# Recognize Faces

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

TIP:

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:

       [Analysis]
       AnalysisEngine0=FaceDetect
       AnalysisEngine1=FaceRecognize

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.
   `MaxFaces` | 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:

       [FaceRecognize]
       Type=FaceRecognize
       Input=FaceDetect.ResultWithSource
       RecognitionThreshold=60
       MaxRecognitionResults=1

   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.

© 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