<p align="center"><img width="40%" src="docs/img/pyviz3d-logo.png" /></p>

---

PyViz3D is a python package to visualize 3D scenes directly in your browser, and create beautiful renderings with blender.

Links

• Install: python -m pip install pyviz3d
• Examples (start here)
• Deployment (if you want to contribute code)

Examples

Scene graph example, including blender rendering. [Show Code] [Show Demo]

<p align="center"> <img width="45%" src="docs/img/example_graph.png" /> <img width="45%" src="docs/img/example_graph_blender.png" /> </p>

Blender example, including blender rendering. [Show Code] [Show Demo]

<p align="center"> <img width="45%" src="docs/img/example_blender.png" /> <img width="45%" src="docs/img/example_blender_blender.png" /> </p>

Arrow example. [Show Code] [Show Demo] <p align="center"><img width="60%" src="docs/img/example_arrows.png" /></p>

Bounding boxes example. [Show Code] [Show Demo] <p align="center"><img width="60%" src="docs/img/example_bounding_boxes.png" /></p>

Polygon meshes (.obj and .ply). [Show Code] [Show Demo] <p align="center"><img width="60%" src="docs/img/example_meshes.png" /></p>

Point clouds, segments and normals. [Show Code] [Show Demo] <p align="center"><img width="60%" src="docs/img/example_normals.png" /></p>

Polylines. [Show Code] [Show Demo] <p align="center"><img width="60%" src="docs/img/example_polylines.png" /></p>

Superquadrics. [Show Code] [Show Demo] <p align="center"><img width="60%" src="docs/img/example_superquadrics.png" /></p>

Text Labels. [Show Code] [Show Demo] <p align="center"><img width="60%" src="docs/img/example_text.png" /></p>

<!-- # Blender To create beautiful illustrations with blender consider the following points: - Install Blender from https://www.blender.org/ (tested version 4.0). - Calling `v.save(..., show_in_blender=True)` creates a `.blend` file which you can open in blender. - Check `examples/examples_graph.py` for a complete example. --> <!-- 2. Set up alias in you ~/.bashrc or ~/.zshrc etc. --> <!-- `alias blender="/Applications/Blender.app/Contents/MacOS/Blender"` --> <!-- then `source ~/.zshrc` --> <!-- 2. `blender myscene.blend --background --python blender.py` --> <!-- currently there is no myscene.blend to remove that: `blender --background --python blender.py` --> <!-- Select camera: View/Cameras/Active Camera --> <!-- Lock camera to view: --> <!-- Press N to show sidebar. --> <!-- Under View, lock camera to view. --> <!-- Control the camera with the small coordinate frame on the top right. --> <!-- 5. This will render an `output.png` --> <!-- 6. The scene can also be opened in blender `bunny.blend` --> <!-- 7. Need to install ffmpeg and convert (on mac via brew) --> <!-- brew install ffmpeg -->

Deployment

Instructions for PyPi and API Token.

One time setup:

vim ~/.pypirc  # put __token__ as username 
python3 -m pip install build twine
python3 -m pip install --upgrade build

Upload latest version to pypi:

vim pyproject.toml  # update version
rm -rf dist
rm -rf examples_output
python3 -m build
python3 -m twine upload dist/*

BibTeX

Please consider citing PyViz3D in your publications if it helps your research.

@misc{engelmann2019pyviz3d,
  title={PyViz3D},
  author={Francis Engelmann},
  year={2019},
  howpublished={\url{https://github.com/francisengelmann/PyViz3D}},
}