• Stars
    star
    178
  • Rank 214,989 (Top 5 %)
  • Language
    Python
  • License
    BSD 3-Clause "New...
  • Created about 10 years ago
  • Updated about 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A robotics interface and visualization framework, with extensive applications for working with http://drake.mit.edu

Director

Introduction

This README describes how to download and build the Director source code and how to satisfy 3rd party dependencies.

Background

The Director is a robotics interface and visualization framework.

It includes applications for working with Drake, and includes the primary user interface used by Team MIT in the DARPA Robotics Challenge.

Team MIT DRC day-1 visualization

The Director is a collection of C++ and Python libraries and applications. Many components from this repository are usable out-of-the-box, but some require additional components from the greater MIT DRC codebase.

System Requirements

As of this writing, the software is tested on Ubuntu 14.04 and 16.04, and MacOSX 10.11. The build should work on Microsoft Windows with MSVC but it is not continuously tested. In theory it can run on any platform where VTK and Qt are supported.

Download Instructions

Install Git

The source code is stored in a Git repository. To download the source code you may need to first install Git on your system. On Mac, we recommend using Homebrew. On Windows, download the official git package from https://git-scm.com

Download the source code

Download the repository with the git clone command:

git clone https://github.com/RobotLocomotion/director.git

Dependencies

Required Dependencies

The required 3rd party dependencies are:

  • Qt4 or Qt5 (Qt 4.8.7 recommended)
  • VTK 6.2+ (VTK 7.1.1 recommended)
  • Python 3.4+ and NumPy

Additionally, you will need CMake 2.8 or greater to configure the source code.

The dependencies can be installed on Mac using Homebrew:

brew tap patmarion/director && brew tap-pin patmarion/director
brew install cmake glib libyaml numpy python scipy vtk7
pip2 install lxml PyYAML

The dependencies can be installed on Ubuntu using apt-get:

sudo apt-get install build-essential cmake libglib2.0-dev libqt4-dev \
  libx11-dev libxext-dev libxt-dev python-dev python-lxml python-numpy \
  python-scipy python-yaml

On Ubuntu the build does not require VTK to be installed. A compatible version of VTK will be downloaded (precompiled binaries) at build time.

Building

Compiling

make superbuild

This is an alias for:

mkdir build && cd build
cmake ../distro/superbuild
make

Documentation

A preliminary Online Help for the Director (currently in preparation) can be found here.

Citing

If you wish to cite the director, please use:

@misc{director,
  author = "Pat Marion",
  title = "Director: A robotics interface and visualization framework",
  year = 2015,
  url = "http://github.com/RobotLocomotion/director"
}

More Repositories

1

drake

Model-based design and verification for robotics.
C++
3,265
star
2

pytorch-dense-correspondence

Code for "Dense Object Nets: Learning Dense Visual Object Descriptors By and For Robotic Manipulation"
Python
557
star
3

LabelFusion

LabelFusion: A Pipeline for Generating Ground Truth Labels for Real RGBD Data of Cluttered Scenes
Python
385
star
4

gcs-science-robotics

Motion Planning around Obstacles with Convex Optimization by Marcucci et al, 2023
Python
155
star
5

drake-external-examples

Examples of how to use Drake in your own project.
C++
101
star
6

drake-ros

Experimental prototyping (for now)
Python
89
star
7

LittleDog

Example of quadruped planning and control in drake using LittleDog -- a small quadruped robot from Boston Dynamics.
MATLAB
67
star
8

spartan

A project repo for robotics research and applications using drake and director.
Python
31
star
9

models

Shareable model files (urdf/sdf + meshes, etc) for our robotics projects
Starlark
25
star
10

drake-iiwa-driver

C++
24
star
11

xfoil

Fork of Mark Drela's XFOIL software (http://raphael.mit.edu/xfoil) which builds using cmake.
Fortran
24
star
12

libbot

Deprecated git mirror of the svn repository formerly located at https://code.google.com/p/libbot. Please use the upstream https://github.com/libbot2/libbot2 or new fork https://github.com/RobotLocomotion/libbot2 instead.
C
23
star
13

drake-blender

Drake glTF Render Client-Server API using Blender
Python
14
star
14

meshConverters

simple wrapper on vcg to give small platform independent mesh converters
C++
12
star
15

RobotLocomotion.github.io

Automatically generated documentation for Drake.
HTML
11
star
16

Hubo

Humanoid robot from KAIST
MATLAB
11
star
17

avl

Fork of Mark Drela's AVL software (http://raphael.mit.edu/avl) which builds using cmake.
Fortran
10
star
18

robot-plan-runner

C++
10
star
19

6-881-examples

Python
7
star
20

realsense2-lcm-driver

Publishes RealSense data to LCM
C++
6
star
21

drake-ci

Continuous integration scripts for Drake.
CMake
6
star
22

cmake

some useful shared cmake utilities
CMake
5
star
23

manip_dataset

Repo with instructions on how to download the dataset
Python
5
star
24

drake-franka-driver

Driver software for the Franka robots.
C++
4
star
25

homebrew-director

Homebrew formulae for Drake.
Ruby
3
star
26

ros_drake

CMake
2
star
27

drake-schunk-driver

Driver software for the Schunk gripper.
C++
2
star
28

bazel-external-data

Handle external large files for use with Bazel.
Python
2
star
29

drake-python3.7

Work in progress. A fork of the Drake toolbox for model-based design and verification for robotics that uses Python 3.7 on Ubuntu 18.04 (Bionic Beaver) and pip to manage Python dependencies.
C++
2
star
30

ros-drake-vendor

Maintainer scripts that package Drake in the ROS build farm
CMake
1
star
31

ipopt-mirror

Fortran
1
star
32

eigen-mirror

C++
1
star
33

ros_drake-release

1
star
34

Pigeon

Full pigeon model w/ Harvard
MATLAB
1
star
35

pdc-ros

Simple wrapper for Kuka pytorch tools + ROS
Python
1
star