There is a list of targets that Nao can track using the Naoqi Tracker API, which works well under good lighting conditions. Here is a walkthrough on how to track a face with its head and a red ball with its arms.
Track a face with Nao’s head
First, import the necessary functions from the SIC framework:
from sic_framework.devices import Nao from sic_framework.devices.common_naoqi.naoqi_stiffness import Stiffness from sic_framework.devices.common_naoqi.naoqi_tracker import ( RemoveTargetRequest, StartTrackRequest, StopAllTrackRequest, )
Connect to the Nao (computer must be connected to the same network)
nao = Nao(ip="NAO_IP_HERE")
Set a tracking target, a list of available targets can be found here: http://doc.aldebaran.com/2-5/naoqi/trackers/index.html#target-names
target_name = "Face"
Since we want to use the head to track a face, we need to set the stiffness to 1 to enable the motors to control the head joint
nao.stiffness.request(Stiffness(stiffness=1.0, joints=["Head"]))
Start tracking, the size is the diameter of the target and a list of available modes can be found here: http://doc.aldebaran.com/2-5/naoqi/trackers/index.html#tracking-modes
nao.tracker.request(StartTrackRequest(target_name, size=0.2, mode="Head", effector="None"))
Unregister a target
nao.tracker.request(RemoveTargetRequest(target_name))
Track a red ball with Nao’s arms
Set a new target
target_name = "RedBall"
Set a robot position relative to target. This is only needed in Move mode. The parameters represent [coordX, coordY, coordWz, thresholdX, thresholdY, thresholdWz]. In this case, it sets the target ball to be 30 cm away along the x-axis with a 10 cm threshold. The XYZ frame reference for the robot can be found here position-identification
move_rel_position = [-0.3, 0.0, 0.0, 0.1, 0.1, 0.1]
Track a red ball
nao.tracker.request( StartTrackRequest( target_name=target_name, size=0.06, mode="Move", effector="Arms", move_rel_position=move_rel_position, ) )
4. Stop all tracking. This will put the robot into rest mode, unlocking all joints and setting stiffness to 0
nao.tracker.request(StopAllTrackRequest())
A complete script for this tutorial can be found here: demo_nao_tracker.py