Metadata-Version: 2.1
Name: supershape
Version: 1.1.1
Summary: Python code to efficiently generate 3D supershapes with optional Blender support.
Home-page: https://github.com/cheind/supershape
Author: Christoph Heindl
License: UNKNOWN
Description: # supershape
        Python code to efficiently generate  [3D SuperShapes](https://en.wikipedia.org/wiki/Superformula).
        
        3D SuperShapes are a family of parametric surfaces that can take on a variety of shapes depending on the parametrization. The following snippet creates 3D coordinates of a flower-like object
        ```python
        import supershape as sshape
        
        x,y,z = sshape.supercoords(
            # m, a, b, n1, n2, n3 (1x6 or 2x6)
            [7, 1, 1, 0.2, 1.7, 1.7], 
            # u,v resolution
            shape=(50,50)
        )
        ```
        
        <p align="center">
          <img  src="etc/flower.png">
        </p>
        
        To reproduce the above result, run
        ```
        python -m supershape
        ```
        
        ## Install
        Via `pip`
        
        ```
        pip install supershape
        ```
        
        ## Blender support
        Add the cloned folder path to your `PYTONPATH`, then launch Blender (>=v2.8) as follows
        ```
        blender --python-use-system-env --python scripts\blender_demo.py
        ```
        to get 
        <p align="center">
          <img  src="etc/flower_blender.png">
        </p>
        
        To avoid modifying your `PYTHONPATH`, you can may install `supershape` into the Blender Python environment. See [this script](https://github.com/cheind/pytorch-blender/blob/eb2793e4ad90d3dd8210724feec5021d773f6beb/scripts/install_btb.py) for example.
        
        ## Releases
        Tags on master are pushed as releases to PyPi. 
        1. Version bump
        1. Commit push and await build result.
        1. `git tag <tagname> -a`
        1. `git push origin --tags`
        Or create the tag throuh the `Releases` page in github.
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
