A light-weight web point cloud visualizer based on Three.js
Project description
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
.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for point_viz_test-0.0.3-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c16c459a136b1897e3132aa11ccacb9f5e641545ef37a2b4ee2c2c8da4e39506 |
|
MD5 | ece6e8b1e322947fa02533095f1d17ce |
|
BLAKE2b-256 | 957bc81b2f51d065f58bb6002bfde7cd9ad425f19e3c0487a6c4cd2e0bb98314 |