Robotic fabrication package for the COMPAS Framework
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
src/compas_fab
temp
tests
.bumpversion.cfg
.editorconfig
.gitignore
AUTHORS.rst
CHANGELOG.rst
CONTRIBUTING.rst
ISSUE_TEMPLATE.md
LICENSE
MANIFEST.in
README.rst
pytest.ini
requirements-dev.txt
setup.cfg
setup.py
tasks.py

README.rst

compas_fab: Robotic Fabrication for COMPAS

Travis-CI Build Status License PyPI Package latest release PyPI Wheel Supported versions Supported implementations

Robotic fabrication package for the COMPAS Framework that facilitates the planning and execution of robotic fabrication processes. It provides interfaces to existing software libraries and tools available in the field of robotics (e.g. OMPL, ROS) and makes them accessible from within the parametric design environment. The package builds upon COMPAS, an open-source Python-based framework for collaboration and research in architecture, engineering and digital fabrication.

Main features

  • Multiple backends for simulation and execution (e.g. ROS: Robot Operating System)
  • Planning tools: kinematic solvers, path planning, etc.
  • Execution tools: feedback loops, robot control, etc.

compas_fab runs on Python 2.x, 3.x and IronPython 2.7.

Getting Started

The recommended way to install compas_fab is to use Anaconda/conda:

conda config --add channels conda-forge
conda install COMPAS
pip install compas_fab

Once installed, you can verify your setup. Start Python from the command prompt and run the following:

>>> import compas_fab

First Steps

Questions and feedback

We encourage the use of the COMPAS framework forum for questions and discussions.

Contributing

We love contributions!

Check the Contributor's Guide for more details.

Releasing this project

Ready to release a new version of compas_fab? Here's how to do it:

  • We use semver, i.e. we bump versions as follows:
    • patch: bugfixes.
    • minor: backwards-compatible features added.
    • major: backwards-incompatible changes.
  • Update the CHANGELOG.rst with all novelty!
  • Ready? Release everything in one command:
invoke release [patch|minor|major]
  • Celebrate! 💃

Credits

This package is maintained by Gramazio Kohler Research @gramaziokohler and a long list of contributors