Skip to content

dfki-ric-underactuated-lab/double_pendulum

Repository files navigation

DOI Ubuntu20 Py3.8 Ubuntu22 Py3.10 Documentation

‼️ IROS 2024 Competition ‼️

We are hosting a competition at IROS 2024.

If you are interested in participating, check out our competition website: IROS 2024 Competition.

Dual Purpose Acrobot & Pendubot Platform

Introduction

This project offers an open-source and low-cost kit to test control algorithms for underactuated robots with strongly non-linear dynamics. It implements a double pendulum platform built using two quasi-direct drive actuators (QDDs). Due to low friction and high mechanical transparency offered by QDDs, one of the actuators can be kept passive and be used as an encoder. When the shoulder motor is passive and elbow motor is active, the system serves as an acrobot and when the shoulder is active and elbow is passive, the system serves as a pendubot setup. This project describes the offline and online control methods which can be studied using this dual purpose kit, lists its components, discusses best practices for implementation, presents results from experiments with the simulator and the real system. This repository describes the hardware (CAD, Bill Of Materials (BOM) etc.) required to build the physical system and provides the software (URDF models, simulation and controller) to control it.

Installation

Installation Instructions.

Documentation

Link to documentation.

The documentation can also be generated locally by doing

make doc

in the main directory. Afterwards you can open the file docs/build/_build/html/index.html in your browser.

Getting Started - Software

For getting started check out the scripts in the examples/ideal folder which simulate and control the double pendulum, acrobot and pendubot under ideal conditions.

Getting Started - Hardware

If you want to assemble your own physical double pendulum similar to the one used in this repository, you can have a look at the hardware documentation.

Repository Structure

The repository is organized in modules. The interplay of the modules is visualized in the figure below:

A minimal example showcasing the interfaces between the plant, a controller and the simulator is:

from double_pendulum.model.symbolic_plant import SymbolicDoublePendulum
from double_pendulum.simulation.simulation import Simulator
from double_pendulum.controller.pid.point_pid_controller import PointPIDController
from double_pendulum.utils.plotting import plot_timeseries

plant = SymbolicDoublePendulum(mass=[0.6, 0.5],
                               length=[0.3, 0.2])

sim = Simulator(plant=plant)

controller = PointPIDController(torque_limit=[5.0, 5.0])
controller.set_parameters(Kp=10, Ki=1, Kd=1)
controller.init()
T, X, U = sim.simulate_and_animate(t0=0.0, x0=[2.8, 1.2, 0., 0.],
                                   tf=5., dt=0.01, controller=controller)
plot_timeseries(T, X, U)

This code snippet uses a plant which is parsed to the simulator. The simulator is then used to simulate and animate the double pendulum motion by calling the

plant.rhs(t, x, tau)

with a time t = float, state x = [float, float, float, float] and torque tau = [float, float] and receiving the change in x in form of its derivative.

The simulation is performed for 5 seconds under the influence of a PID controller by at every time step calling the

controller.get_control_output(x, t)

method of the controller with a state x = [float, float, float, float] and a time t = float and receiving a torque tau.

More examples can be found in the examples folder.

For implementing your own controller, have a look at the controller class.

Benchmark Results

The following plot shows benchmark results obtained in simulation for the double pendulum design C.0 and model parameters h1.1. The results show the robustness of the controllers to

  • Inaccuracies in the model parameters
  • Noise in the velocity measurements
  • Noise in the applied motor torques
  • Imperfect step response from the motors
  • A time delay in the state measurements

The controllers achieve a score between 0 and 1 in each category which is the fraction of successful swing-up motions under varying conditions.

Leaderboards

On key feature of this project is the comparison of different control methods, may it be from classical control, optimal control to reinforcement learning. For this there is a leaderboard where the control methods are ranked with respect to various criteria.

This repository features three RealAIGym leaderboards to compare control methods:

Have a look at the instructions, if you want to submit a controller to the leaderboards.

Authors

Feel free to contact us if you have questions about the test bench. Enjoy!

Contributing

Contributions to this project, especially in the form of new controllers, are very welcome! See Contributing for more details.

Safety Notes

When working with a real system be careful and mind the following safety measures:

  • Brushless motors can be very powerful, moving with tremendous force and speed. Always limit the range of motion, power, force and speed using configurable parameters, current limited supplies, and mechanical design.

  • Stay away from the plane in which double pendulum is swinging. It is recommended to have a safety cage surrounding the double pendulum in case the parts of the pendulum get loose and fly away.

  • Make sure you have access to emergency stop while doing experiments. Be extra careful while operating in pure torque control loop.

Acknowledgements

This work has been performed in the M-RoCK project funded by the German Aerospace Center (DLR) with federal funds (Grant Number: FKZ 01IW21002) from the Federal Ministry of Education and Research (BMBF) and is additionally supported with project funds from the federal state of Bremen for setting up the Underactuated Robotics Lab (Grant Number: 201-001-10-3/2021-3-2).

License

This work has been released under the BSD 3-Clause License. Details and terms of use are specified in the LICENSE file within this repository. Note that we do not publish third-party software, hence software packages from other developers are released under their very own terms and conditions. If you install third-party software packages along with this repo ensure that you follow each individual license agreement.

Citation

  1. F. Wiebe, S. Kumar, L. J. Shala, S. Vyas, M. Javadi and F. Kirchner, "Open Source Dual-Purpose Acrobot and Pendubot Platform: Benchmarking Control Algorithms for Underactuated Robotics," in IEEE Robotics & Automation Magazine, vol. 31, no. 2, pp. 113-124, June 2024, doi: 10.1109/MRA.2023.3341257.
@ARTICLE{10375556,
  author={Wiebe, Felix and Kumar, Shivesh and Shala, Lasse J. and Vyas, Shubham and Javadi, Mahdi and Kirchner, Frank},
  journal={IEEE Robotics & Automation Magazine}, 
  title={Open Source Dual-Purpose Acrobot and Pendubot Platform: Benchmarking Control Algorithms for Underactuated Robotics}, 
  year={2024},
  volume={31},
  number={2},
  pages={113-124},
  doi={10.1109/MRA.2023.3341257}}