Metadata-Version: 1.1
Name: tangible
Version: 0.2.1
Summary: A Python library to convert data into tangible 3D models.
Home-page: https://github.com/dbrgn/tangible
Author: Danilo Bargen
Author-email: mail@dbrgn.ch
License: LGPLv3
Description: Tangible
        ========
        
        .. image:: https://secure.travis-ci.org/dbrgn/tangible.png?branch=master
            :alt: Travis-CI build status
            :target: http://travis-ci.org/dbrgn/tangible
        
        .. image:: https://coveralls.io/repos/dbrgn/tangible/badge.png?branch=master
            :target: https://coveralls.io/r/dbrgn/tangible
            :alt: 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*.
        
        .. image:: https://raw.github.com/dbrgn/tangible/master/example1.jpg
            :alt: 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 <http://hsr.ch/>`_.
        You can find the thesis paper here: http://dbrgn.ch/sa-thesis.pdf
        
        
        Documentation
        -------------
        
        Documentation can be found on ReadTheDocs: `http://tangible.readthedocs.org/
        <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 <http://www.python.org/dev/peps/pep-0008/>`__ via `flake8
        <https://pypi.python.org/pypi/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 <http://stackful-dev.com/quick-tips-on-making-your-code-python-3-ready.html>`_:
        
        .. sourcecode:: python
        
            # -*- coding: utf-8 -*-
            from __future__ import print_function, division, absolute_import, unicode_literals
        
        Docstrings convention: `Sphinx style <http://stackoverflow.com/q/4547849/284318>`__.
        
        
        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
        <http://semver.org/spec/v2.0.0.html>`_.
        
        
        License
        -------
        
        LGPLv3 or later `http://www.gnu.org/licenses/lgpl.html
        <http://www.gnu.org/licenses/lgpl.html>`_
        
Keywords: tangible visualization 3d printing
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2 :: Only
Classifier: Topic :: Artistic Software
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
