This section contains examples showing various possibilities of Whole Body Motion.
Control NAO’s effectors, separately or simultaneously.
almotion_wbEffectorControlHead.py
# -*- encoding: UTF-8 -*-
''' Whole Body Motion: Head orientation control '''
''' This example is only compatible with NAO '''
import argparse
import time
import math
from naoqi import ALProxy
def main(robotIP, PORT=9559):
''' Example of a whole body head orientation control
Warning: Needs a PoseInit before executing
Whole body balancer must be inactivated at the end of the script
'''
motionProxy = ALProxy("ALMotion", robotIP, PORT)
postureProxy = ALProxy("ALRobotPosture", robotIP, PORT)
# Wake up robot
motionProxy.wakeUp()
# Send robot to Stand Init
postureProxy.goToPosture("StandInit", 0.5)
effectorName = "Head"
# Active Head tracking
isEnabled = True
motionProxy.wbEnableEffectorControl(effectorName, isEnabled)
# Example showing how to set orientation target for Head tracking
# The 3 coordinates are absolute head orientation in NAO_SPACE
# Rotation in RAD in x, y and z axis
# X Axis Head Orientation feasible movement = [-20.0, +20.0] degree
# Y Axis Head Orientation feasible movement = [-75.0, +70.0] degree
# Z Axis Head Orientation feasible movement = [-30.0, +30.0] degree
targetCoordinateList = [
[+20.0, 00.0, 00.0], # target 0
[-20.0, 00.0, 00.0], # target 1
[ 00.0, +70.0, 00.0], # target 2
[ 00.0, +70.0, +30.0], # target 3
[ 00.0, +70.0, -30.0], # target 4
[ 00.0, -75.0, 00.0], # target 5
[ 00.0, -75.0, +30.0], # target 6
[ 00.0, -75.0, -30.0], # target 7
[ 00.0, 00.0, 00.0], # target 8
]
# wbSetEffectorControl is a non blocking function
# time.sleep allow head go to his target
# The recommended minimum period between two successives set commands is
# 0.2 s.
for targetCoordinate in targetCoordinateList:
targetCoordinate = [target*math.pi/180.0 for target in targetCoordinate]
motionProxy.wbSetEffectorControl(effectorName, targetCoordinate)
time.sleep(3.0)
# Deactivate Head tracking
isEnabled = False
motionProxy.wbEnableEffectorControl(effectorName, isEnabled)
# Go to rest position
motionProxy.rest()
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)
almotion_wbEffectorControlLArm.py
# -*- encoding: UTF-8 -*-
''' Whole Body Motion: Left or Right Arm position control '''
''' This example is only compatible with NAO '''
import argparse
import motion
import time
from naoqi import ALProxy
def main(robotIP, PORT, chainName):
''' Example of a whole body Left or Right Arm position control
Warning: Needs a PoseInit before executing
Whole body balancer must be inactivated at the end of the script
'''
motionProxy = ALProxy("ALMotion", robotIP, PORT)
postureProxy = ALProxy("ALRobotPosture", robotIP, PORT)
# Wake up robot
motionProxy.wakeUp()
# Send robot to Stand Init
#postureProxy.goToPosture("StandInit", 0.5)
frame = motion.FRAME_ROBOT
useSensor = False
effectorInit = motionProxy.getPosition(chainName, frame, useSensor)
# Active LArm tracking
isEnabled = True
motionProxy.wbEnableEffectorControl(chainName, isEnabled)
# Example showing how to set position target for LArm
# The 3 coordinates are absolute LArm position in FRAME_ROBOT
# Position in meter in x, y and z axis.
# X Axis LArm Position feasible movement = [ +0.00, +0.12] meter
# Y Axis LArm Position feasible movement = [ -0.05, +0.10] meter
# Y Axis RArm Position feasible movement = [ -0.10, +0.05] meter
# Z Axis LArm Position feasible movement = [ -0.10, +0.10] meter
coef = 1.0
if chainName == "LArm":
coef = +1.0
elif chainName == "RArm":
coef = -1.0
targetCoordinateList = [
[ +0.12, +0.00*coef, +0.00], # target 0
[ +0.12, +0.00*coef, -0.10], # target 1
[ +0.12, +0.05*coef, -0.10], # target 1
[ +0.12, +0.05*coef, +0.10], # target 2
[ +0.12, -0.10*coef, +0.10], # target 3
[ +0.12, -0.10*coef, -0.10], # target 4
[ +0.12, +0.00*coef, -0.10], # target 5
[ +0.12, +0.00*coef, +0.00], # target 6
[ +0.00, +0.00*coef, +0.00], # target 7
]
# wbSetEffectorControl is a non blocking function
# time.sleep allow head go to his target
# The recommended minimum period between two successives set commands is
# 0.2 s.
for targetCoordinate in targetCoordinateList:
targetCoordinate = [targetCoordinate[i] + effectorInit[i] for i in range(3)]
motionProxy.wbSetEffectorControl(chainName, targetCoordinate)
time.sleep(4.0)
# Deactivate Head tracking
isEnabled = False
motionProxy.wbEnableEffectorControl(chainName, isEnabled)
# Go to rest position
motionProxy.rest()
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")
parser.add_argument("--chain", type=str, default="LArm",
choices=["LArm", "RArm"], help="Chain name")
args = parser.parse_args()
main(args.ip, args.port, args.chain)
Control arms and torso simultaneously.
almotion_wbMultipleEffectors.py
# -*- encoding: UTF-8 -*-
''' Whole Body Motion: Multiple Effectors control '''
import argparse
import motion
import almath
import time
from naoqi import ALProxy
def main(robotIP, PORT=9559):
'''
Example of a whole body multiple effectors control "LArm", "RArm" and "Torso"
Warning: Needs a PoseInit before executing
Whole body balancer must be inactivated at the end of the script
'''
motionProxy = ALProxy("ALMotion", robotIP, PORT)
postureProxy = ALProxy("ALRobotPosture", robotIP, PORT)
# end initialize proxy, begin go to Stand Init
# Wake up robot
motionProxy.wakeUp()
# Send robot to Stand Init
postureProxy.goToPosture("StandInit", 0.5)
# end go to Stand Init, begin initialize whole body
# Enable Whole Body Balancer
isEnabled = True
motionProxy.wbEnable(isEnabled)
# Legs are constrained fixed
stateName = "Fixed"
supportLeg = "Legs"
motionProxy.wbFootState(stateName, supportLeg)
# Constraint Balance Motion
isEnable = True
supportLeg = "Legs"
motionProxy.wbEnableBalanceConstraint(isEnable, supportLeg)
# end initialize whole body, define arms motions
useSensorValues = False
# Arms motion
effectorList = ["LArm", "RArm"]
frame = motion.FRAME_ROBOT
# pathLArm
pathLArm = []
currentTf = motionProxy.getTransform("LArm", frame, useSensorValues)
# 1
target1Tf = almath.Transform(currentTf)
target1Tf.r2_c4 += 0.08 # y
target1Tf.r3_c4 += 0.14 # z
# 2
target2Tf = almath.Transform(currentTf)
target2Tf.r2_c4 -= 0.05 # y
target2Tf.r3_c4 -= 0.07 # z
pathLArm.append(list(target1Tf.toVector()))
pathLArm.append(list(target2Tf.toVector()))
pathLArm.append(list(target1Tf.toVector()))
pathLArm.append(list(target2Tf.toVector()))
pathLArm.append(list(target1Tf.toVector()))
# pathRArm
pathRArm = []
currentTf = motionProxy.getTransform("RArm", frame, useSensorValues)
# 1
target1Tf = almath.Transform(currentTf)
target1Tf.r2_c4 += 0.05 # y
target1Tf.r3_c4 -= 0.07 # z
# 2
target2Tf = almath.Transform(currentTf)
target2Tf.r2_c4 -= 0.08 # y
target2Tf.r3_c4 += 0.14 # z
pathRArm.append(list(target1Tf.toVector()))
pathRArm.append(list(target2Tf.toVector()))
pathRArm.append(list(target1Tf.toVector()))
pathRArm.append(list(target2Tf.toVector()))
pathRArm.append(list(target1Tf.toVector()))
pathRArm.append(list(target2Tf.toVector()))
pathList = [pathLArm, pathRArm]
axisMaskList = [almath.AXIS_MASK_VEL, # for "LArm"
almath.AXIS_MASK_VEL] # for "RArm"
coef = 1.5
timesList = [ [coef*(i+1) for i in range(5)], # for "LArm" in seconds
[coef*(i+1) for i in range(6)] ] # for "RArm" in seconds
# called cartesian interpolation
motionProxy.transformInterpolations(effectorList, frame, pathList, axisMaskList, timesList)
# end define arms motions, define torso motion
# Torso Motion
effectorList = ["Torso", "LArm", "RArm"]
dy = 0.06
dz = 0.06
# pathTorso
currentTf = motionProxy.getTransform("Torso", frame, useSensorValues)
# 1
target1Tf = almath.Transform(currentTf)
target1Tf.r2_c4 += dy
target1Tf.r3_c4 -= dz
# 2
target2Tf = almath.Transform(currentTf)
target2Tf.r2_c4 -= dy
target2Tf.r3_c4 -= dz
pathTorso = []
for i in range(3):
pathTorso.append(list(target1Tf.toVector()))
pathTorso.append(currentTf)
pathTorso.append(list(target2Tf.toVector()))
pathTorso.append(currentTf)
pathLArm = [motionProxy.getTransform("LArm", frame, useSensorValues)]
pathRArm = [motionProxy.getTransform("RArm", frame, useSensorValues)]
pathList = [pathTorso, pathLArm, pathRArm]
axisMaskList = [almath.AXIS_MASK_ALL, # for "Torso"
almath.AXIS_MASK_VEL, # for "LArm"
almath.AXIS_MASK_VEL] # for "RArm"
coef = 0.5
timesList = [
[coef*(i+1) for i in range(12)], # for "Torso" in seconds
[coef*12], # for "LArm" in seconds
[coef*12] # for "RArm" in seconds
]
motionProxy.transformInterpolations(
effectorList, frame, pathList, axisMaskList, timesList)
# end define torso motion, disable whole body
# Deactivate whole body
isEnabled = False
motionProxy.wbEnable(isEnabled)
# Send robot to Pose Init
postureProxy.goToPosture("StandInit", 0.3)
# Go to rest position
motionProxy.rest()
# end script
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)
Balance constraints in whole body motion.
Enable a balance constraint.
almotion_wbEnableBalanceConstraint.py
# -*- encoding: UTF-8 -*-
''' Whole Body Motion: Enable Balance Constraint '''
''' This example is only compatible with NAO '''
import argparse
import math
from naoqi import ALProxy
def main(robotIP, PORT=9559):
''' Example of a whole body Enable Balance Constraint
Warning: Needs a PoseInit before executing
Whole body balancer must be inactivated at the end of the script
'''
motionProxy = ALProxy("ALMotion", robotIP, PORT)
postureProxy = ALProxy("ALRobotPosture", robotIP, PORT)
# Wake up robot
motionProxy.wakeUp()
# Send robot to Stand Init
postureProxy.goToPosture("StandInit", 0.5)
# Activate Whole Body Balancer
isEnabled = True
motionProxy.wbEnable(isEnabled)
# Legs are constrained in a plane
stateName = "Fixed"
supportLeg = "Legs"
motionProxy.wbFootState(stateName, supportLeg)
# Constraint Balance Motion
isEnable = True
supportLeg = "Legs"
motionProxy.wbEnableBalanceConstraint(isEnable, supportLeg)
# KneePitch angleInterpolation
# Without Whole Body balancer, foot will fall down
names = ["LKneePitch", "RKneePitch"]
angleLists = [ [0.0, 40.0*math.pi/180.0], [0.0, 40.0*math.pi/180.0]]
timeLists = [ [5.0, 10.0], [5.0, 10.0]]
isAbsolute = True
try:
motionProxy.angleInterpolation(names, angleLists, timeLists, isAbsolute)
except Exception, errorMsg:
print str(errorMsg)
print "This example is not allowed on this robot."
exit()
# Deactivate Whole Body Balancer
isEnabled = False
motionProxy.wbEnable(isEnabled)
# Go to rest position
motionProxy.rest()
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)
Make NAO kick the air with its foot.
# -*- encoding: UTF-8 -*-
''' Whole Body Motion: kick '''
''' This example is only compatible with NAO '''
import argparse
import motion
import time
import almath
from naoqi import ALProxy
def computePath(proxy, effector, frame):
dx = 0.05 # translation axis X (meters)
dz = 0.05 # translation axis Z (meters)
dwy = 5.0*almath.TO_RAD # rotation axis Y (radian)
useSensorValues = False
path = []
currentTf = []
try:
currentTf = proxy.getTransform(effector, frame, useSensorValues)
except Exception, errorMsg:
print str(errorMsg)
print "This example is not allowed on this robot."
exit()
# 1
targetTf = almath.Transform(currentTf)
targetTf *= almath.Transform(-dx, 0.0, dz)
targetTf *= almath.Transform().fromRotY(dwy)
path.append(list(targetTf.toVector()))
# 2
targetTf = almath.Transform(currentTf)
targetTf *= almath.Transform(dx, 0.0, dz)
path.append(list(targetTf.toVector()))
# 3
path.append(currentTf)
return path
def main(robotIP, PORT=9559):
''' Example of a whole body kick
Warning: Needs a PoseInit before executing
Whole body balancer must be inactivated at the end of the script
'''
motionProxy = ALProxy("ALMotion", robotIP, PORT)
postureProxy = ALProxy("ALRobotPosture", robotIP, PORT)
# Wake up robot
motionProxy.wakeUp()
# Send robot to Stand Init
postureProxy.goToPosture("StandInit", 0.5)
# Activate Whole Body Balancer
isEnabled = True
motionProxy.wbEnable(isEnabled)
# Legs are constrained fixed
stateName = "Fixed"
supportLeg = "Legs"
motionProxy.wbFootState(stateName, supportLeg)
# Constraint Balance Motion
isEnable = True
supportLeg = "Legs"
motionProxy.wbEnableBalanceConstraint(isEnable, supportLeg)
# Com go to LLeg
supportLeg = "LLeg"
duration = 2.0
motionProxy.wbGoToBalance(supportLeg, duration)
# RLeg is free
stateName = "Free"
supportLeg = "RLeg"
motionProxy.wbFootState(stateName, supportLeg)
# RLeg is optimized
effector = "RLeg"
axisMask = 63
frame = motion.FRAME_WORLD
# Motion of the RLeg
times = [2.0, 2.7, 4.5]
path = computePath(motionProxy, effector, frame)
motionProxy.transformInterpolations(effector, frame, path, axisMask, times)
# Example showing how to Enable Effector Control as an Optimization
isActive = False
motionProxy.wbEnableEffectorOptimization(effector, isActive)
# Com go to LLeg
supportLeg = "RLeg"
duration = 2.0
motionProxy.wbGoToBalance(supportLeg, duration)
# RLeg is free
stateName = "Free"
supportLeg = "LLeg"
motionProxy.wbFootState(stateName, supportLeg)
effector = "LLeg"
path = computePath(motionProxy, effector, frame)
motionProxy.transformInterpolations(effector, frame, path, axisMask, times)
time.sleep(1.0)
# Deactivate Head tracking
isEnabled = False
motionProxy.wbEnable(isEnabled)
# send robot to Pose Init
postureProxy.goToPosture("StandInit", 0.3)
# Go to rest position
motionProxy.rest()
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)
Constrain whole body balancer with foot state.
# -*- encoding: UTF-8 -*-
''' Whole Body Motion: Foot State '''
''' This example is only compatible with NAO '''
import argparse
import math
from naoqi import ALProxy
def main(robotIP, PORT=9559):
''' Example of a whole body FootState
Warning: Needs a PoseInit before executing
Whole body balancer must be inactivated at the end of the script
'''
motionProxy = ALProxy("ALMotion", robotIP, PORT)
postureProxy = ALProxy("ALRobotPosture", robotIP, PORT)
# Wake up robot
motionProxy.wakeUp()
# Send robot to Stand Init
postureProxy.goToPosture("StandInit", 0.5)
# Activate Whole Body Balancer.
isEnabled = True
motionProxy.wbEnable(isEnabled)
# Legs are constrained in a plane
stateName = "Plane"
supportLeg = "Legs"
motionProxy.wbFootState(stateName, supportLeg)
# HipYawPitch angleInterpolation
# Without Whole Body balancer, foot will not be keeped plane.
names = "LHipYawPitch"
angleLists = [-45.0, 10.0, 0.0]
timeLists = [3.0, 6.0, 9.0]
isAbsolute = True
angleLists = [angle*math.pi/180.0 for angle in angleLists]
try:
motionProxy.angleInterpolation(names, angleLists, timeLists, isAbsolute)
except Exception, errorMsg:
print str(errorMsg)
print "This example is not allowed on this robot."
exit()
# Deactivate Whole Body Balancer.
isEnabled = False
motionProxy.wbEnable(isEnabled)
# Go to rest position
motionProxy.rest()
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)