Skip to main content

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

point_viz-0.0.2.tar.gz (697.2 kB view details)

Uploaded Source

Built Distribution

point_viz-0.0.2-py3-none-any.whl (703.7 kB view details)

Uploaded Python 3

File details

Details for the file point_viz-0.0.2.tar.gz.

File metadata

  • Download URL: point_viz-0.0.2.tar.gz
  • Upload date:
  • Size: 697.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for point_viz-0.0.2.tar.gz
Algorithm Hash digest
SHA256 308972e9fe421fdb650cb3c322edd31f0e26001a21c4da247c910201ea114c21
MD5 913e4cbcd044cb57a0550300415a721a
BLAKE2b-256 1e06052c38ec13fe601348a3d0a7be3782062aa9baac8f5ec380f6aa6c6b45b3

See more details on using hashes here.

File details

Details for the file point_viz-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: point_viz-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 703.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for point_viz-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b87a3584d40d1cf38687f67d4c1359bdd60d0b6f2500a5a2a7aecfdc643d0506
MD5 62845ce62713b1ba5e152799b06744f2
BLAKE2b-256 11441c8e8fd19f1cdd10386faf596b93b6be8a264f910750ee3fa0089a89ba58

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page