ALEngagementZones¶
NAOqi PeoplePerception - 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.