ALEngagementZones¶
NAOqi People Perception - Overview | API
What it does¶
ALEngagementZones allows you to classify detected people and/or movements using their position in space with respect to the robot and the Concept of engagement zones.
Concept of engagement zones¶
The space in front of the robot is divided in configurable zones. Thus, you can adapt the behavior of the robot depending on the zone a person or a movement is detected in.
How it works¶
Zone definition¶
The Engagement zones are defined by the following parameters:
| Name | Defines... | Settings |
|---|---|---|
| FirstDistance | “near” | ALEngagementZonesProxy::setFirstLimitDistance |
| SecondDistance | “farther” | ALEngagementZonesProxy::setSecondLimitDistance |
| LimitAngle | “in front” | ALEngagementZonesProxy::setLimitAngle |
From these parameters are deduced 3 zones:
- Zone1 is near, in front,
- Zone2 is far in front and also near but on the sides,
- Zone3 is far on the side and also “very far” i.e. beyond SecondDistance.
Other example¶
Getting started¶
ALEngagementZones allows you to compute the engagement zone of any other object
from its position in FRAME_ROBOT, using:
ALEngagementZonesProxy::computeEngagementZone.
ALEngagementZones can also be used jointly with other modules. For further details, see:
In Choregraphe, the Robot View allows you to see the engagement zones and also the people detected by ALPeoplePerception.
UseCases¶
EngagementZones with PeoplePerception¶
The module ALEngagementZones can be used to compute the engagement zone for each person in the population detected by the module ALPeoplePerception.
Warning
It will only work if ALPeoplePerception has also been subscribed to.
The engagement zone of each person is added to the description of this person in the ALMemory
by filling the key PeoplePerception/Person/<ID>/EngagementZone.
The people are then classified depending on their engagement zone. The memory keys
EngagementZones/PeopleInZone1, EngagementZones/PeopleInZone2
and EngagementZones/PeopleInZone3 store the list of the IDs of the people
in each zone. Each time at least one of these lists is updated, the event
EngagementZones/PeopleInZonesUpdated() is raised.
Besides, using ALEngagementZones with ALPeoplePerception also allows you to detect if someone is approaching the robot or moving away:
- When a person moves from one zone to a closer one, the event
EngagementZones/PersonApproached()is raised. - When a person moves from one zone to a further one, the event
EngagementZones/PersonMovedAway()is raised.
In order to be able to trigger some behaviors when people enter a specific zone,
the events EngagementZones/PersonEnteredZone1(),
EngagementZones/PersonEnteredZone2() and
EngagementZones/PersonEnteredZone3() are also raised each time when
a person leaves one zone to enter another one.
EngagementZones with MovementDetection¶
The module ALEngagementZones can be used to compute the engagement zone for each movement detected by the module ALMovementDetection.
Warning
It will only work if ALMovementDetection has also been subscribed to.
The people are then classified depending on their engagement zone. The memory keys
EngagementZones/LastMovementsInZone1, EngagementZones/LastMovementsInZone2
and EngagementZones/LastMovementsInZone3 store the list of movements
in each zone. These movement lists have exactly the same structure as the memory key
MovementDetection/MovementInfo, described in ALMovementDetection.
Each time at least one of these lists is updated, the event
EngagementZones/MovementsInZonesUpdated() is raised.
When no movement has been detected, the event EngagementZones/MovementsInZonesUpdated()
is not raised and the movement lists in the previous memory keys stay the same.
Warning
If the robot is not equipped with a 3D sensor, it is not possible to detect the distance
of a movement with respect to the robot, thus to determine which engagement zone it
belongs to. Therefore, the movements are all stored in each of the memory keys
EngagementZones/LastMovementsInZone1, EngagementZones/LastMovementsInZone2
and EngagementZones/LastMovementsInZone3.
