Home

Awesome

<img src="docs/images/choreo_logo.png" alt="drawing" width="100"/>

CHOREO: A robotic sequence and motion planning framework for spatial extrusion of 3D trusses

Build Status

With Choreo, you will be able to print the following cool structures (and many more!) with ease:

<a href="http://www.youtube.com/watch?feature=player_embedded&v=Vv7dEB8T_Jg" target="_blank"><img src="http://img.youtube.com/vi/Vv7dEB8T_Jg/0.jpg" alt="voronoi_extrusion"/></a>

Check out the the full workflow of Choreo here:

<a href="http://www.youtube.com/watch?feature=player_embedded&v=as4wro0Ty-M" target="_blank"><img src="http://img.youtube.com/vi/as4wro0Ty-M/0.jpg" alt="choreo_workflow"/></a>

Currently, Choreo only supports ROS-kinetic on Ubuntu 16.04.

Note: To increase the flexibility and usability of Choreo, we decided to shift our development and maintenance efforts to pychoreo, a python implementation based on the pybullet simulation engine. This python version implements exactly the same algorithm as its ROS counterpart, but is more flexible and usable (but of course, with some compromise on the computational efficiency). pychoreo is supported on all major platforms: Windows(!), OSX, Linux and has all the core components as the ROS version: collision checking, IKfast, motion planner, stiffness checker, all of which is ROS-free.

<img src="http://digitalstructures.mit.edu/theme/digistruct/images/digital-structures-logo-gray.svg" width="150">         <img src="http://web.mit.edu/files/images/homepage/default/mit_logo.gif?v=1530763211" width="80">

<img align="center" height="15" src="https://i.imgur.com/x1morBF.png"/> Installation

If you are new to Linux or ROS, you might find links in the references section handy.

Build from source

NameDescriptionInstall
ROS-kineticbase ROS system on Ubuntu 16.04follow instruction here
python_catkin_toolscatkin build toolsudo apt-get install python-catkin-tools
wstoolworkspace version controlsudo apt install python-wstool
moveit!The Moveit! motion planning frameworksudo apt-get install ros-kinetic-moveit
moveit visual toolsvisualization aids in rvizsudo apt-get install ros-kinetic-moveit-visual-tools

Docker image

Coming soon.

<img align="center" height="15" src="https://i.imgur.com/x1morBF.png"/> Quick start demo

Start playing with robotic spatial extrusion on a KUKA KR6R900 robot:

roslaunch framefab_kr6_r900_support kr6_r900_choreo.launch

<img src="https://i.imgur.com/hSdrgm8.png" alt="KR6R900_demo" width="500"/>

Or on an ABB robot mounted on a linear track:

roslaunch framefab_irb6600_support irb6600_choreo.launch

<img src="https://i.imgur.com/5K0raAY.png" alt="ABB_demo" width="500"/>

For a video demo on the topology optimized beam (details in the paper):

<a href="http://www.youtube.com/watch?feature=player_embedded&v=6_DLPjq-k5s" target="_blank"><img src="http://img.youtube.com/vi/6_DLPjq-k5s/0.jpg" alt="large_topopt"/></a>

First set up your print model by clicking the Parameters button and set up model file path in Model Input (you might need to set up the robot start pose too). Save it and click Next. Some test models for spatial extrusion can be found here.

More detailed instruction coming soon.

<img align="center" height="15" src="https://i.imgur.com/x1morBF.png"/> Code API

Coming soon.

<img align="center" height="15" src="https://i.imgur.com/dHQx91Q.png"/> Publications

If you use this work, please consider citing as follows:

@article{huang2018automated, title={Automated sequence and motion planning for robotic spatial extrusion of 3D trusses}, author={Huang, Yijiang and Garrett, Caelan R and Mueller, Caitlin T}, journal={Construction Robotics}, volume={2}, number={1-4}, pages={15--39}, year={2018}, publisher={Springer} }

Algorithms behind Choreo:

Applications of Choreo:

<img align="center" height="15" src="https://i.imgur.com/H4NwgMg.png"/> Bugs & Feature Requests

Please report bugs and request features using the Issue Tracker.

<img align="center" height="15" src="https://i.imgur.com/x1morBF.png"/> References<a name="references"></a>

If you are new to Linux: You may find it helpful to first do a quick tutorial on common command line tools for linux. A good one is here.

For researchers and developers who wants to dive deep into the system implementation but not familiar to ROS, you may find the official ROS tutorial here useful.