semvec/pypi-packages huggingface dataset:
supershape 1.1.1
Python code to efficiently generate 3D supershapes with optional Blender support.

# 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.