/drake_periscope_tutorial

Primary LanguageJupyter NotebookMIT LicenseMIT

Drake Concepts Tutorial

Build Status

(Build tested both on Drake binaries from 20180604 and latest Drake binaries).

This repo contains tutorial info for Drake (see http://drake.mit.edu). It's a sort of code equivalent or companion to this guide.

PREREQS

You'll have to install Drake (from binaries or source, your choice) following the instructions on the Drake website, or in this guide.

You'll also need to use jupyter to view the notebook (.ipynb) files, graphviz, and meshcat-python to view the 3D visualizations in some of the examples. You'll also need some more standard libraries (e.g. numpy). You can install all of these with

apt-get install graphviz
pip install jupyter graphviz meshcat numpy matplotlib

And finally, you'll need to have the Drake textbook example code available and on your PYTHONPATH. You can pull it down with

git clone https://github.com/RussTedrake/underactuated ~/underactuated

and add it to your PYTHONPATH with

export PYTHONPATH=~/underactuated/src:$PYTHONPATH

(you probably want to add that to the end of your ~/.bashrc).

USE

To view the notebook files, use the command jupyter notebook from a terminal in the same directory (or a parent directory) as the notebook files. Then use the web-browser-based notebook browser to open up the notebook files, and use the notebook interface to play with the notebook. See a guide like this one for info on how to use the Jupyter notebook. Be sure to have both Drake and the textbook code on your PYTHONPATH before launching jupyter!

To run the Kuka simulation, first run meshcat-server in a new terminal. It should report a web-url -- something like 127.0.0.1:7000/static/. Open that in a browser -- this is your 3D viewer. Then run python kuka_pydrake_sim.py and you should see the arm spawn in the viewer before doing some movements.