Tangible is a Python library to convert data into tangible 3D models.
Python
Failed to load latest commit information.
docs
examples Python 2.6 passes all tests! Dec 16, 2013
tangible
tests
.coveragerc
.gitignore
.travis.yml
AUTHORS.rst
LICENSE.rst
MANIFEST.in
README.rst
example1.jpg
pytest.ini
requirements-dev.txt
setup.py

README.rst

Tangible

Travis-CI build status Coverage Status Downloads per Month Latest Version Wheel Availability

Tangible is a Python library to convert data into tangible 3D models. It generates code for different backends like OpenSCAD or ImplicitSCAD. It is inspired by projects like OpenSCAD and d3.js.

Example 1

Implementation

The difference from Projects like SolidPython is that Tangible is a modular system with an intermediate representation of objects that is capable of generating code for different backends, not just OpenSCAD. Additionally, its main focus is not general CAD, but printable 3D visualization of data.

The workflow to get a real object from data is as follows:

Python code => Intermediate representation (AST) => Programmatic CAD code
=> STL file => Slicer => G code => 3D printer => Tangible object

Of these, Tangible does the first three steps. The fourth step is handled by a programmatic CAD tool like OpenSCAD or ImplicitSCAD and the last four steps are handled by the specific 3D printer software.

Currently supported Python versions are 2.6 and 2.7. Support for 3.3+ is planned.

This library was my student research project thesis at HSR. You can find the thesis paper here: http://dbrgn.ch/sa-thesis.pdf

Contributions are very welcome! Please open an issue or a pull request.

Installation

You can install Tangible directly via PyPI:

pip install tangible

If you want the current development version:

pip install -e git+https://github.com/dbrgn/tangible#egg=tangible-dev

Documentation

Documentation can be found on ReadTheDocs: http://tangible.readthedocs.org/

If you want to know more about the architecture of the library, please refer to my thesis PDF.

Coding Guidelines

PEP8 via flake8 with max-line-width set to 99 and E126-E128,E266,E731 ignored.

All Python files must start with an UTF8 encoding declaration and some future-imports:

# -*- coding: utf-8 -*-
from __future__ import print_function, division, absolute_import, unicode_literals

Docstrings convention: Sphinx style.

Testing

Prepare:

pip install -r requirements-dev.txt --use-mirrors
pip install -e .

Run tests:

py.test

Violations of the PEP8 coding guidelines above will be counted as test fails.

Versioning

Tangible implements Semantic Versioning 2.0.

License

LGPLv3 or later http://www.gnu.org/licenses/lgpl.html