*NAOqi Motion* - Overview | *API*

The goal of this function is enabling the robot to become aware of his body. You can program motion without worrying about taking in account his anatomy. The robot always knows where are his head, torso, legs and arms, so he avoids limbs collision during motion.

This section presents how collisions are modelled, detected and avoided.

For reason of CPU consumption, we simplify the robot’s geometry, approximating it with simple 3D shapes: spheres (in green in the image below) and capsules (in red). Typically, spheres are used for the head, hips and torso, and capsules for the arms and legs.

A sphere is simply characterized by its center and radius: it is the set of all points which are at the radius distance of the sphere center.

A capsule is a cylinder, capped by two half spheres, one at each extremity, with the same radius as the cylinder. The capsule is characterized by its center, its length of the cylinder (L), and its radius (R), which is the same for the capping spheres and the cylinder.

To detect if two spheres collide, we measure the distance D between the two sphere centers. If D - (r1 + r2) > 0, where r1 is the radius of the first sphere and r2 is the radius of the second one, then the spheres are not colliding. Else, they are colliding.

To detect collision between a capsule and a sphere, we project the sphere center on the axis of the capsule. Again, there are two cases:

- case 1: the projection of the sphere center is inside the capsule cylinder. Here, we consider the distance D between the sphere center and its projection on the capsule axis.
- case 2: the projection of the center is outside the capsule cylinder. Here, we consider the distance D between the sphere center and the closest capsule cylinder extremity.

In both cases, if D - (rC + rS) > 0, where rC is the radius of the capsule and rS the radius of the sphere, there is no collision.

To detect collision between two capsules, the capsules are reduced to two axes. Two cases are then possible:

- case 1: the intersection of the axes is inside the first capsule. Here, the distance between the closest points is D, indicated on the drawing: if it is greater than r1 + r2, then there is no collision.
- case 2: the intersection of the axes is outside the capsules. Here, the closest points are the extremities of the capsules. If the distance D between them is greater than r1 + r2, then there is no collision.

This section presents how the algorithm avoids collision between the protected chains and the rest of the robot’s body. The aim of the algorithm is to prevent collisions from happening, but also finding an alternate way of satisfying the command, if possible.

To try to satisfy the command, we must minimize the distance between the current state and the desired one. We also have a given constraint: no collision must take place. To solve this, we can formalize the problem as a minimization problem under a linear inequality constraint.

We are going to illustrate this problem with a arm / torso collision, but the following equations are general. The following illustration shows the left arm chain near the torso.

In the case of a command affecting the arm, what we want to minimize is the difference between the desired state and the final one, which gives the following equation:

Note

This equation is valid for a T14 (Academics model) robot. In the case of a H21 robot model (Robocup model), the last angle is not present since the robot does not have this degree of freedom. However, the equations are unchanged.

We now have to express the fact that we do not want the arm to collide with the rest of the body. We will consider here only the torso for simplicity, but the reasoning is strictly the same for any other body part.

We consider the speed of the extremity of the arm. Since the interpolation is discretized, to ensure that there will be no collision, we have to ensure that at the next movement step, the distance covered will be less than the distance separating the arm and the torso. The distance is computed using the models described in the previous section.

To predict the distance covered, we first compute the Cartesian speed vector along the contact normal. The Cartesian speed vector can be obtained with the following formula (Jchain is the Jacobian of the nearest point to the torso):

If we project this Cartesian speed along the contact normal n, and multiply this by the time step, the non collision can be expressed as follows:

Note

The time step is at least equal to the threading time of motion.

We can then rewrite the above expression to obtain a classical inequality constraint:

We have then formalized the problem as a minimization with an inequality constraint. This problem is now a classical optimization problem with the linear inequality constraint:

With this algorithm, the robot can avoid collisions with itself. When the desired position is unreachable, it tries to find the nearest solution, while still guaranteeing the absence of collision.

Collision detection and avoidance can be activated on the following chains: “Arms”, “LArm” or “RArm”. It detects and avoids collisions between these chains and the rest of the body.

In the case where the protected chain has no stiffness, the algorithm will try to move the parts of the robot’s body which are stiff. If the chain is stiff, the algorithm will modify its movement.

Warning

Collision detection and avoidance only works for
*Joint* methods but not for
*Cartesian* and *Whole body*
methods. It also works when making the robot move from Choregraphe
using the Timeline, or the sliders (when clicking on a body part of
the robot).

Example showing the effect of collision detection: the robot bumps his chest with his left arm with collision detection enabled or disabled.

`almotion_reflexesCollisionAvoidance.py`

```
# -*- encoding: UTF-8 -*-
# -*- encoding: UTF-8 -*-
''' Reflexes: LArm Collision Avoidance '''
import motion
import time
import argparse
from naoqi import ALProxy
def main(robotIP, PORT=9559):
''' Example showing the effect of collision detection
Nao bumps his chest with his left arm with collision detection enabled
or disabled.
'''
motionProxy = ALProxy("ALMotion", robotIP, PORT)
# Get the robot configuration.
robotConfig = motionProxy.getRobotConfig()
robotName = ""
for i in range(len(robotConfig[0])):
if (robotConfig[0][i] == "Model Type"):
robotName = robotConfig[1][i]
##################
# Initialization #
##################
pChainName = "LArm"
# Send robot to Pose Init.
moveLArm(motionProxy, robotName, "Init")
# Disable collision detection on LArm chain.
pEnable = False
success = motionProxy.setCollisionProtectionEnabled(pChainName, pEnable)
if (not success):
print("Failed to disable collision protection")
time.sleep(1.0)
# Make NAO's arm move so that it bumps its torso.
moveLArm(motionProxy, robotName, "Final")
time.sleep(1.0)
# Go back to pose init.
moveLArm(motionProxy, robotName, "Init")
# Enable collision detection on chainName.
pEnable = True
success = motionProxy.setCollisionProtectionEnabled(pChainName, pEnable)
if (not success):
print("Failed to enable collision protection")
# Make NAO's arm move and see that it does not bump on the torso.
moveLArm(motionProxy, robotName, "Final")
time.sleep(1.0)
# Go back to pose init.
moveLArm(motionProxy, robotName, "Init")
def moveLArm(motionProxy, pRobotName, pPose):
''' Function to make NAO bump on his Torso with his left arm '''
# Define the name of the chain controlled
pChainName = "LArm"
# Define the final position.
if (pPose == "Init"):
pTargetAngles = [
80, # LShoulderPitch
20, # LShoulderRoll
-80, # LElbowYaw
-60] # LElbowRoll
elif (pPose == "Final"):
pTargetAngles = [
50, # LShoulderPitch
6, # LShoulderRoll
0, # LElbowYaw
-150] # LElbowRoll
else:
print "ERROR: Your pose is unknown"
print "---------------------"
exit(1)
# Set the target angles according to the robot version.
if (pRobotName == "naoH25") or\
(pRobotName == "naoAcademics") or\
(pRobotName == "naoT14"):
pTargetAngles += [0.0, 0.0]
elif (pRobotName == "naoH21"):
pass
elif (pRobotName == "naoT2"):
pTargetAngles = []
else:
print "ERROR: Your robot is unknown"
print "This test is not available for your Robot"
print "---------------------"
exit(1)
# Convert to radians.
pTargetAngles = [x * motion.TO_RAD for x in pTargetAngles]
# Set the fraction of max speed for the arm movement.
pMaxSpeedFraction = 0.5
# Set NAO in stiffness On.
motionProxy.setStiffnesses("LArm", 1.0)
# Move the arm to the final position.
motionProxy.angleInterpolationWithSpeed(pChainName, pTargetAngles, pMaxSpeedFraction)
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("--ip", type=str, default="127.0.0.1",
help="Robot ip address")
parser.add_argument("--port", type=int, default=9559,
help="Robot port number")
args = parser.parse_args()
main(args.ip, args.port)
```