Robotic fabrication package for the COMPAS Framework
Project description
============================================================
compas_fab: Robotic Fabrication for COMPAS
============================================================
**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 <https://compas-dev.github.io/>`_,
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 <https://ros.org>`_)
* 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 <https://conda.io/docs/>`_:
::
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 line and run the following:
.. code-block:: python
>>> import compas_fab
First Steps
-----------
* `Documentation <https://gramaziokohler.github.io/compas_fab/>`_
* `Examples <https://gramaziokohler.github.io/compas_fab/latest/examples.html>`_
* `API Reference <https://gramaziokohler.github.io/compas_fab/latest/reference.html>`_
* `COMPAS Examples <https://compas-dev.github.io/main/examples.html>`_
* `COMPAS Tutorials <https://compas-dev.github.io/main/tutorial.html>`_
* `COMPAS API Reference <https://compas-dev.github.io/main/api.html>`_
Questions and feedback
----------------------
We encourage the use of the `COMPAS framework forum <https://forum.compas-framework.org/>`_
for questions and discussions.
Contributing
------------
We love contributions!
Check the `Contributor's Guide <CONTRIBUTING.rst>`_ for more details.
Releasing this project
----------------------
Ready to release a new version of **compas_fab**? Here's how to do it:
* We use `semver <https://semver.org/>`_, 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 <https://github.com/gramaziokohler>`_
and a long list of `contributors <AUTHORS.rst>`_
Changelog
=========
All notable changes to this project will be documented in this file.
The format is based on `Keep a Changelog <http://keepachangelog.com/en/1.0.0/>`_
and this project adheres to `Semantic Versioning <http://semver.org/spec/v2.0.0.html>`_.
Unreleased
----------
**Added**
* First open source release!
* V-REP and ROS clients
* Updated to COMPAS 0.3.2
Unreleased
----------
0.2.0
-----
----------
**Added**
* Initial version
compas_fab: Robotic Fabrication for COMPAS
============================================================
**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 <https://compas-dev.github.io/>`_,
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 <https://ros.org>`_)
* 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 <https://conda.io/docs/>`_:
::
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 line and run the following:
.. code-block:: python
>>> import compas_fab
First Steps
-----------
* `Documentation <https://gramaziokohler.github.io/compas_fab/>`_
* `Examples <https://gramaziokohler.github.io/compas_fab/latest/examples.html>`_
* `API Reference <https://gramaziokohler.github.io/compas_fab/latest/reference.html>`_
* `COMPAS Examples <https://compas-dev.github.io/main/examples.html>`_
* `COMPAS Tutorials <https://compas-dev.github.io/main/tutorial.html>`_
* `COMPAS API Reference <https://compas-dev.github.io/main/api.html>`_
Questions and feedback
----------------------
We encourage the use of the `COMPAS framework forum <https://forum.compas-framework.org/>`_
for questions and discussions.
Contributing
------------
We love contributions!
Check the `Contributor's Guide <CONTRIBUTING.rst>`_ for more details.
Releasing this project
----------------------
Ready to release a new version of **compas_fab**? Here's how to do it:
* We use `semver <https://semver.org/>`_, 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 <https://github.com/gramaziokohler>`_
and a long list of `contributors <AUTHORS.rst>`_
Changelog
=========
All notable changes to this project will be documented in this file.
The format is based on `Keep a Changelog <http://keepachangelog.com/en/1.0.0/>`_
and this project adheres to `Semantic Versioning <http://semver.org/spec/v2.0.0.html>`_.
Unreleased
----------
**Added**
* First open source release!
* V-REP and ROS clients
* Updated to COMPAS 0.3.2
Unreleased
----------
0.2.0
-----
----------
**Added**
* Initial version
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
compas_fab-0.2.0.tar.gz
(145.2 kB
view hashes)
Built Distribution
compas_fab-0.2.0-py2.py3-none-any.whl
(161.0 kB
view hashes)
Close
Hashes for compas_fab-0.2.0-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ec650e6df7ad4ed3cda924aa8b35a7971c9257e80aa6e7b7f4b3d079c5480435 |
|
| MD5 | 65e69861698489ebd4a7c39868999407 |
|
| BLAKE2b-256 | 034641e317ee6badd773bc377059bd04443e07b7b50996a883c86a7e08cdf581 |
