Open topic with navigation

# Detect Faces

To detect faces that appear in media, follow these steps.

To detect faces in media

1. Create a new configuration to send to HPE 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

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 `FaceDetect`.
   `Input` | (Optional) The image track to process. If you do not set this parameter, HPE Media Server processes the first track of the correct type.
   `Region` | (Optional) The region that you want to search for faces.
   `RegionUnit` | (Optional) The units to use for specifying the region (default `pixel`). To specify the position and size of the region as a percentage of the media size, set this parameter to `percent`.
   `FaceDirection` | (Optional) HPE Media Server can detect faces looking in any direction, but if you know that all faces will look directly at the camera you can set `FaceDirection=Front`. This is faster and might produce fewer false detections.
   `ColorAnalysis` | (Optional) A Boolean value that specifies whether to perform color analysis on detected faces. This can reduce the number of false detections.
   `MinSize` | (Optional) The minimum expected size of faces in the video (in pixels unless you set the `SizeUnit` parameter). Increasing the minimum size can increase processing speed.
   `SizeUnit` | (Optional) The units to use for setting the `MinSize` parameter (default `pixel`). To specify the size as a percentage of the smallest image side, set this parameter to `percent`.

   For example:

       [FaceDetect]
       Type=FaceDetect
       FaceDirection=Front
       ColorAnalysis=TRUE
       MinSize=200
       SizeUnit=pixel

   For more information about the parameters that you can use to configure Face Detection, refer to the HPE 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