Analyze Face

UiPath.AmazonRekognition.Activities.AnalyzeFace

Overview

The Analyze Face activity uses the Amazon Rekognition DetectFaces API to detect the 100 largest faces in the input image (ImagePath or ImageURL). For each face detected, the activity returns an array of face detail objects (FaceDetails).

The face detail objects include a bounding box of the face, a confidence value (that the bounding box contains a face), and a fixed set of attributes such as facial landmarks gender, presence of beard, and more. For a complete list of face detail objects are returned, see the FaceDetails property in the Output section below.

Summary

Dependencies

Dependency	Details
Packages	UiPath.Amazon.Rekognition.Activities
Activities	Amazon Scope

Attributes

Attributes	Details
Inputs (Variables)	String Applies to property: ImagePath and ImageURL
Outputs (Variables)	FaceDetails[] Applies to property: FacesDetails For a complete list of face detail objects that you can retrieve, see the FaceDetails property in the Output section below.
API used	Amazon Rekognition - DetectFaces
Examples	Quickstart

Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

Common

DisplayName

The display name of the activity.

Attributes	Details
Type	String
Required	Yes
Default value	Analyze Face
Allowed values	Enter a String or String variable.
Notes	N/A

Input

ImagePath

The path to a local image that you want to analyze.

Attributes	Details
Type	String
Required	Yes (if the ImageURL is empty)
Default value	Empty
Allowed values	Enter a String or String variable.
Notes	Either the ImagePath or ImageURL property is required. If you enter values for both the ImagePath and ImageURL, the Image Path value is used.

ImageURL

The URL of an image that you want to analyze.

Attributes	Details
Type	String
Required	Yes (if the ImagePath is empty)
Default value	Empty
Allowed values	Enter a String or String variable.
Notes	Either the ImagePath or ImageURL property is required. If you enter values for both the ImagePath and ImageURL, the Image Path value is used.

Misc

Private

If selected, the values of variables and arguments are no longer logged at Verbose level.

Attributes	Details
Type	Checkbox
Required	No
Default value	Not Selected
Allowed values	Selected or Not Selected
Notes	N/A

Output

FacesDetails

An array of the face details that were detected in the specified image.

Attributes	Details
Type	FaceDetails[]
Required	No (recommended if you plan to use the output data in subsequent activities)
Default value	Empty
Allowed values	Enter a FaceDetails[] variable.
Notes	The following is a list of the possible face detail objects this array can return. AgeRange Beard BoundingBox Emotions EyeGlasses EyesOpen Gender Landmarks MouthOpen Mustache Smile Sunglasses If you plan to use the For Each activity to process the array output, select UiPath.Amazon.Rekognition.Models.FaceDetail as the TypeArgument. The image below shows an example of the FaceDetails[] output, using the Beard datatype.