PyViz3D is a Python package to visualize 3D point clouds.
Project description
PyViz3D is a Python package to visualize 3D point clouds.
Installation
Using pip:
pip install pyviz3d
Getting started
Minimal example:
import numpy as np
import pyviz3d as viz
points = np.array([[2.0, 0.0, 0.0], [0.0, 2.0, 0.0], [0.0, 0.0, 2.0]]) # Define 3D points
colors = np.array([[255, 0, 0], [0, 255, 0], [0, 0, 255]]) # Define corresponding colors
viz.show_pointclouds([points], [colors]) # Display point cloud
Contributing
You are more then welcome to contribute your own changes via github pull requests.
We recommend developing in a conda environment. From your console, create a new conda environment (using python <=3.7, required for VTK) and activate it:
$ conda create --name <environment_name> python=3.7
$ conda activate <environment_name>
Distributing
The maintainers of the package keep the recent version of the pyviz3d
package available on PyPy and Anaconda.
The anaconda package is created from the pypi package.
PyPi
Loosely following the instructions from [1]
$ pip install twine
To test the release without messing around with the public PyPi release:
$ python setup.py sdist bdist_wheel
$ twine upload --repository-url https://test.pypi.org/legacy/ dist/*
When happy, prepare a new release on github:
https://github.com/francisengelmann/pyviz3d/releases
When done, we can upload the release to the public PyPi repository:
$ python setup.py sdist bdist_wheel
$ twine upload dist/*
Anaconda
We rely on Anaconda Cloud to host the pyviz3d package [2]
$ conda install anaconda-client conda-build conda-verify
$ conda config --set anaconda_upload no
$ conda skeleton pypi pyviz3d
$ conda build pyviz3d
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.