centroidal_control_collection

Collection of centroidal control for legged robots

CI-standalone CI-catkin Documentation

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

  1. (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
  2. (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

  1. 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
  2. Install dependent packages.
    $ source /opt/ros/${ROS_DISTRO}/setup.bash
    $ rosdep install -y -r --from-paths src --ignore-src
  3. 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.

PreviewControlZmp

  • 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

DdpZmp

  • 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

DcmTracking

  • 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

FootGuidedControl

  • 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

StepMpc

  • 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

LinearMpcZmp

  • 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

IntrinsicallyStableMpc

  • 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

SingularPreviewControlZmp

  • 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.

LinearMpcZ

$ rosrun centroidal_control_collection TestLinearMpcZ

LinearMpcXY

  • 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

PreviewControlCentroidal

  • 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

DdpCentroidal

$ rosrun centroidal_control_collection TestDdpCentroidal --gtest_filter=*.PlanOnce

DdpSingleRigidBody

$ 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.