Skip to main content

A Python library to convert data into tangible 3D models.

Project description

Travis-CI build status Coverage Status

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

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 <http://dbrgn.ch/sa-thesis.pdf>.

Coding Guidelines

PEP8 via flake8 with max-line-width set to 99 and E126-E128 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tangible-0.2.1.tar.gz (9.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page