# ALGazeAnalysis ¶

NAOqi People Perception - Overview | API

## What it does ¶

ALGazeAnalysis allows you to analyze the direction of the gaze of a detected person, in order to know if he/she is looking at the robot. It also detects whether the person’s eyes are open or closed.

## How it works ¶

By detecting the face of a person and studying its orientation, it is possible to detect whether or not this person is looking at the robot.

First a scoring value, called LookingAtRobotScore , is computed for each person in the detected population. This score, between 0 and 1, describes the confidence in the fact that the person is looking at the robot. It is stored in the memory key  PeoplePerception/Person/<ID>/LookingAtRobotScore  . Then this score is compared to a threshold value:

• if the score is greater than the threshold value, the person is characterized as looking at the robot.
• if the score is smaller than the threshold value, the person is characterized as not looking at the robot.

It is possible to change the threshold value by changing the Tolerance of the gaze analysis, using the function  ALGazeAnalysisProxy::setTolerance  (Threshold = 1-Tolerance). The current value of the Tolerance can be retrieved with function  ALGazeAnalysisProxy::getTolerance  .

This result is added to the description of the people in the ALMemory by filling the key  PeoplePerception/Person/<ID>/IsLookingAtRobot  .

The raw head angles are also available through the key  PeoplePerception/Person/<ID>/HeadAngles  . The gaze direction relative to the face plane are available through  PeoplePerception/Person/<ID>/GazeDirection  . The “opening degree” of both eyes is given by  PeoplePerception/Person/<ID>/EyeOpeningDegree  .