Robotic Manipulation

Perception, Planning, and Control

Russ Tedrake

© Russ Tedrake, 2020-2022
Last modified .
How to cite these notes, use annotations, and give feedback.

Note: These are working notes used for a course being taught at MIT. They will be updated throughout the Fall 2022 semester.

Previous Chapter Table of contents Next Chapter

Drake

is the main software toolbox that we use for this text, which in fact originated in a large part due to the MIT Underactuated Robotics course. The website is the main source for information and documentation. The goal of this chapter is to provide any additional information that can help you get up and running with the examples and exercises provided in these notes.

Pydrake

is primarily a C++ library, with rigorous coding standards and a maturity level intended to support even professional applications in industry. In order to provide a gentler introduction, and to facilitate rapid prototyping, I've written these notes exclusively in python, using Drake's python bindings (pydrake). These bindings are less mature than the C++ backend; your feedback (and even contributions) are very welcome. It is still improving rapidly.

In particular, while the C++ API documentation is excellent, the autogenerated python docs are still a work in progress. I currently recommend using the C++ documentation to find what you need, then checking the Python documentation only if you need to understand how the class or method is spelled in pydrake.

There are also a number of tutorials in that can help you get started.

Online Jupyter Notebooks

I will provide nearly all examples and exercises in the form of a Jupyter Notebook so that we can leverage the fantastic and relatively recent availability of (free) cloud resources.

Running on Deepnote

We'll use Deepnote as the primary platform for the course. After following any of the links from the chapters, you should:

  1. Log in (the free account will be sufficient for this class)
  2. "Duplicate" the document. Icon is in the top right next to Login.
  3. Run all of the cells (can use the "Run notebook" icon just above this cell)
  4. Many of the notebooks use MeshCat for interactive visualizations. Click on the url printed just below "StartMeshcat" (often the second code cell of the notebook) to see the MeshCat window.

Running on Google Colab

As of now, Drake no longer supports Google Colab, which is stuck on Ubuntu 18.04 and Python 3.7. We will try to support it again if/when they upgrade.

Enabling licensed solvers

You can enabled more powerful solvers for MathematicalProgram if you have a license (most are free for academics). Please see this tutorial for instructions.

Running on your own machine

As you get more advanced, you will likely want to run (and extend) these examples on your own machine. On platforms that Drake supports (the latest two releases of Mac and Ubuntu), it should be as simple as running

pip install manipulation
In general, I would strongly recommend running pip commands in a virtualenv.

The website also has a number of alternative installation options, including precompiled binaries and Docker instances. If you build from source (awesome!), then make sure you also build the python bindings. Finally, make sure you have the Drake installation in your PYTHONPATH.

You'll likely want to start from the manipulation root directory. Then launch your notebook with:

jupyter notebook

The examples for each chapter that has them will be in a .ipynb file right alongside the chapter's html file, and the notebook exercises are all located in the exercises subdirectory.

Getting help

If you have trouble with , please follow the advice here. If you have trouble with the manipulation repo, you can check for known issues (and potentially file a new one) here.

Previous Chapter Table of contents Next Chapter