======== pychoreo

.. start-badges

.. image:: https://img.shields.io/badge/License-MIT-blue.svg :target: https://github.com/yijiangh/pychoreo/blob/master/LICENSE :alt: License MIT

.. image:: https://travis-ci.com/yijiangh/pychoreo.svg?branch=dev :target: https://travis-ci.com/yijiangh/pychoreo :alt: Travis CI

.. image:: https://coveralls.io/repos/github/yijiangh/pychoreo/badge.svg?branch=dev :target: https://coveralls.io/github/yijiangh/pychoreo?branch=dev :alt: Coveralls

.. end-badges

.. Write project description

pychoreo is a sequence and motion planning engine that allow you to print the following cool structures (and many more!) with ease:

.. image:: http://img.youtube.com/vi/Vv7dEB8T_Jg/0.jpg :target: http://www.youtube.com/watch?feature=player_embedded&v=Vv7dEB8T_Jg :alt: Voronoi extrusion video

Note :pushpin:

• In the summer of 2019, pychoreo will be integrated into the compas_fab <https://github.com/compas-dev/compas_fab>_ infrastructure. Stay tuned! :beers:
• The ROS implementation of choreo can be found here: choreo <https://github.com/yijiangh/choreo>_.

Main features

• feature

Documentation

Coming soon!

.. Explain how to access documentation: API, examples, etc.

.. .. optional sections:

Requirements

.. Write requirements instructions here

Installation

.. Write installation instructions here

Credits

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:

- Automated sequence and motion planning for robotic spatial extrusion of 3D trusses, Constr Robot (2018) 2:15-39, `Arxiv-1810.00998 <https://arxiv.org/abs/1810.00998>`_

Applications of Choreo: - Robotic extrusion of architectural structures with nonstandard topology, RobArch 2018, RobArch paper link <http://web.mit.edu/yijiangh/www/papers/Huang2019_RobArch.pdf>_ - Spatial extrusion of Topology Optimized 3D Trusses, IASS 2018, IASS paper link <http://web.mit.edu/yijiangh/www//papers/HuangCarstensenMueller_IASS2018.pdf>_

Related repos

Task and Motion Planning - https://github.com/caelan/pb-construction - https://github.com/caelan/pddlstream

Computational design and digital fabrication - https://github.com/compas-dev/compas_fab