Skip to content

ARC-OPT/orogen-wbc

Repository files navigation

WBC - Whole-Body Control

Code API | Full Documentation

This task library provides a Rock interface for the Whole-Body Control library. It facilitates intuitive specification and execution of reactive robot control problems that involve multiple simultaneously running tasks.

WBC was initiated and is currently developed at the Robotics Innovation Center of the German Research Center for Artificial Intelligence (DFKI) in Bremen.

drawing

Motivation

WBC is a framework for optimization-based control of redundant robots. It contains various implementations of whole-body feedback control approaches on velocity-, acceleration- and force/torque-level. WBC is meant for controlling robots with redundant degrees of freedom, like humanoids or other legged robots with floating base, but also fixed-base systems like mobile manipulators, dual-arm systems or even simple manipulators. It is also meant for controlling multiple tasks simultaneously while taking into account the physical constraints of the robot. E.g., on a humanoid robot do ... (1) keep balance (2) Grasp an object with one arm (3) maintaining an upright body posture (4) Consider the joint torque limits, etc... WBC is a purely reactive approach, i.e., it does not involve any motion planning or trajectory optimization. However, it can be used to stabilize trajectories coming from a motion planner or trajectory optimizer and integrate them with other objectives and physical constraints of the robot.

The general idea of optimization-based robot control is to formulate simultaneously running robot tasks as constraints or within the cost function of an instantaneous optimization problem. Now, in each control cycle ...

  • The constraints/cost functions are updated with the current robot state/control reference
  • The optimization problem is solved
  • The solution is applied to the actuators of the robot

The online solution of this problem is the robot joint control signal that complies with all tasks, while integrating physical constraints like actuator limits. An advantage of this approach is that complex tasks can be composed from low-dimensional descriptors, which are typically easier to specify and control than the complete task are once. Also, the redundancy of the robot is nicely exploited utilizing all the dof of the system (whole body).

Getting Started

  • Please check out the tutorials section in the documentation for examples of usage.

Requirements / Dependencies

Currently supported OS: Ubuntu20.04, Ubuntu22.04

This task library is for sole use within the Rock framework. I.e., you require a full Rock installation to use it. In addition, it has the following 1st order dependencies:

  • WBC library
  • Optional: Hyrodyn library. In order to use the HyRoDyn-based robot model including the feature of modeling and controlling series-parallel hybrid robots, you currently require access to the DFKI git server.

Installation

  • New Bootstrap: See here
  • Existing Rock Installation: Add the wbc package set to your autoproj/manifest file:
    package_sets:
    - github: ARC-OPT/package_set
    
    followed by aup control/orogen/wbc and then amake control/orogen/wbc. To install the control library, you can do aup control/orogen/ctrl_lib and then amake control/orogen/ctrl_lib.

Testing

Please check the unit tests here, as well as the tutorials.

Contributing

Please use the issue tracker to submit bug reports and feature requests.

Please use merge requests as described here to add/adapt functionality.

License

orogen-wbc is distributed under the 3-clause BSD license.

Acknowledge WBC

If you use WBC within your scientific work, please cite the following publication:

@INPROCEEDINGS{mronga2022,
author = "D. Mronga and S.Kumar and F.Kirchner",
title = "Whole-Body Control of Series-Parallel Hybrid Robots",
year = "2022",
note = "{2022 IEEE International Conference on Robotics and Automation (ICRA)}, Accepted for publication",
}

Funding

WBC has been developed in the research projects TransFit (Grant number 50RA1701) and BesMan (Grant number 50RA1216) funded by the German Aerospace Center (DLR) with funds from the German Federal Ministry for Economic Affairs and Climate Action (BMWK). It is further developed in the M-Rock (Grant number 01IW21002) and VeryHuman (Grant number 01IW20004) projects funded by the German Aerospace Center (DLR) with federal funds from the German Federal Ministry of Education and Research (BMBF).

Maintainer / Authors / Contributers

Dennis Mronga, [email protected]

Copyright 2017, DFKI GmbH / Robotics Innovation Center