point-viz 0.1.0

A light-weight web point cloud visualizer based on Three.js

Introduction

Point_viz is a light-weight, out-of-box point cloud visualizer working in browser, it is built on Three.js and has python API. Bounding box (bbox) visualization is supported and here is an example. Point_viz does not need Internet connection to work (but the installation needs, of course), and it has been tested on Chrome and Safari with both python 2 and 3.

Usage

To install point_viz, simply run: pip install point_viz, and that's all. Below is the example of its python API:

# Import package.
from point_viz import PointvizConverter

# Initialize and setup output directory.
Converter = PointvizConverter(home)
# Pass data and create html files.
Converter.compile(task_name, coors, default_rgb, intensity, bbox_params, bbox_color)

Variables Explanation

The * means optional.

home: The directory where to put output html files, must be given.
task_name*: string, name of the output html file (can be overwritten if the name already exists; default value is "default").
coors*: 2-D float array, the x, y and z coordinates of each point in the point cloud.
default_rgb*: 2-D float/int array of the same length as coors, the R, G and B colors of each point. If not provided, the RGB will be automatically calculated based on intensity (if given) or point coordinates (when intensity is also missing).
intensity*: 1-D float array of the same length as coors, the intensity of each point. It only takes effect when default_rgb is not given.
bbox_params*: 2-D list, the geometry parameters of each bbox. Attributes of each row should be arranged as follows:

Attribute #	Description
0	Length (float, dimension along x-axis)
1	Height (float, dimension along y-axis)
2	Width (float, dimension along z-axis)
3	X coordinate of bbox centroid (float)
4	Y coordinate of bbox centroid (float)
5	Z coordinate of bbox centroid (float)
6	Horizontal rotation regarding the +x-axis in radians (float)
7*	Color of the bbox (string, optional; X11 color name is supported, default is "Magenta")
8*	Label text of the bbox (string, optional)

bbox_color*: boolean, default is True. If the color of bbox is missing while the label text is given, then bbox_color has to be explicitly set to False.