Collection of centroidal control for legged robots
CI-standalone CI-catkin
Install
Requirements
Compiler supporting C++17
Tested on Ubuntu 20.04 / ROS Noetic
and Ubuntu 18.04 / ROS Melodic
Dependencies
This package depends on
This package also depends on the following packages. However, manual installation is unnecessary when this package is installed using wstool
as described in Installation procedure .
Preparation
(Skip if ROS is already installed.) Install ROS. See here for details. $ export ROS_DISTRO=melodic
$ sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'
$ wget http://packages.ros.org/ros.key -O - | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install ros-${ROS_DISTRO}-ros-base python-catkin-tools python-rosdep
(Skip if mc_rtc is already installed.) Install mc_rtc. See here for details. $ curl -1sLf 'https://dl.cloudsmith.io/public/mc-rtc/stable/setup.deb.sh' | sudo -E bash
$ sudo apt-get install libmc-rtc-dev mc-rtc-utils ros-${ROS_DISTRO}-mc-rtc-plugin ros-${ROS_DISTRO}-mc-rtc-rviz-panel libeigen-qld-dev
Installation procedure
Setup catkin workspace. $ mkdir -p ~/ros/ws_ccc/src
$ cd ~/ros/ws_ccc
$ wstool init src
$ wstool set -t src isri-aist/QpSolverCollection git@github.com:isri-aist/QpSolverCollection.git --git -y
$ wstool set -t src isri-aist/ForceControlCollection git@github.com:isri-aist/ForceControlCollection.git --git -y
$ wstool set -t src isri-aist/NMPC git@github.com:isri-aist/NMPC.git --git -y
$ wstool set -t src isri-aist/CentroidalControlCollection git@github.com:isri-aist/CentroidalControlCollection.git --git -y
$ wstool update -t src
Install dependent packages. $ source /opt/ros/${ROS_DISTRO}/setup.bash
$ rosdep install -y -r --from-paths src --ignore-src
Build a package. $ catkin build centroidal_control_collection -DCMAKE_BUILD_TYPE=RelWithDebInfo --catkin-make-args all tests
Examples
Make sure that it is built with --catkin-make-args tests
option.
Methods based on bipedal dynamics
The CoM and ZMP trajectories are planned according to the ZMP reference trajectory and the ZMP region boundaries as inputs, which are determined from a given footstep sequence (i.e., the position and timing of the foot landings). The CoM velocity is jumped by emulating a disturbance during motion.
Shuuji Kajita, et al. Biped walking pattern generation by using preview control of zero-moment point. ICRA, 2003.
$ rosrun centroidal_control_collection TestPreviewControlZmp
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method PreviewControlZmp
PreviewControlZmp
S Feng, et al. Optimization‐based full body control for the darpa robotics challenge. Journal of field robotics, 2015.
$ rosrun centroidal_control_collection TestDdpZmp
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method DdpZmp
DdpZmp
J Englsberger, et al. Three-dimensional bipedal walking control using divergent component of motion. IROS, 2013.
$ rosrun centroidal_control_collection TestDcmTracking
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method DcmTracking
DcmTracking
T Sugihara, et al. Foot-guided agile control of a biped robot through ZMP manipulation. IROS, 2017.
Y Kojio, et al. Unified balance control for biped robots including modification of footsteps with angular momentum and falling detection based on capturability. IROS, 2019.
$ rosrun centroidal_control_collection TestFootGuidedControl
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method FootGuidedControl
FootGuidedControl
S Xin, et al. Online relative footstep optimization for legged robots dynamic walking using discrete-time model predictive control. IROS, 2019.
$ rosrun centroidal_control_collection TestStepMpc
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method StepMpc
StepMpc
PB Wieber. Trajectory Free Linear Model Predictive Control for Stable Walking in the Presence of Strong Perturbations. Humanoids, 2006.
$ rosrun centroidal_control_collection TestLinearMpcZmp
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method LinearMpcZmp
LinearMpcZmp
N Scianca, et al. Intrinsically Stable MPC for Humanoid Gait Generation. Humanoids, 2016.
$ rosrun centroidal_control_collection TestIntrinsicallyStableMpc
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method IntrinsicallyStableMpc
IntrinsicallyStableMpc
J Urata, et al. Online Decision of Foot Placement using Singular LQ Preview Regulation. Humanoids, 2011.
$ rosrun centroidal_control_collection TestSingularPreviewControlZmp
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method SingularPreviewControlZmp
SingularPreviewControlZmp
Plotting all methods
$ roscd centroidal_control_collection
$ catkin bt --no-deps --catkin-make-args run_tests
$ rosrun centroidal_control_collection plotTestZmpBasedMethodResults.py --method All --plot-comp-time
You will get a plot like this one that shows all the methods in one sheet.
Methods based on centroidal dynamics
Centroidal trajectories (i.e., CoM and linear/angular momentum trajectories) are planned from the contact sequence.
$ rosrun centroidal_control_collection TestLinearMpcZ
H Audren, et al. Model preview control in multi-contact motion-application to a humanoid robot. IROS, 2014.
長阪憲一郎, et al. 接触拘束を考慮可能なマルチコンタクト対応スタビライザと一般化逆動力学による人型ロボットの全身制御. ロボティクスシンポジア予稿集, 2012.
$ rosrun centroidal_control_collection TestLinearMpcXY
M Murooka, et al. Centroidal trajectory generation and stabilization based on preview control for humanoid multi-contact motion. RA-Letters, 2022.
$ rosrun centroidal_control_collection TestPreviewControlCentroidal
$ rosrun centroidal_control_collection TestDdpCentroidal --gtest_filter=*.PlanOnce
$ rosrun centroidal_control_collection TestDdpSingleRigidBody --gtest_filter=*.PlanOnce
If you catkin build with -DENABLE_PYBULLET_TEST=ON
option, you can run the test by simulation on the GUI. pybullet
is required to be installed.
# In terminal 1
$ rostest centroidal_control_collection TestSimDdpSingleRigidBody.test -t -r
# In terminal 2
$ rosrun rqt_service_caller rqt_service_caller
https://github.com/isri-aist/CentroidalControlCollection/assets/6636600/7f70f728-f76d-49b3-a885-d6e2ab5d8594
Integration into controller
Some of the methods implemented in this library are available in the humanoid controller BaselineWalkingController and MultiContactController .