Skip to main content

The best web-based visualizer

Project description

DVIS: 3D Visualizations made easy

Visualize your data with just one line of code

Python -> Browser

💻 Usage

from dvis import dvis

dvis("mesh.obj") # load file
dvis(point_cloud, vs=0.03) # point cloud with specific voxel size
dvis(bboxes,'bbox', c=3, name='my_boxes') # show colored boxes 
dvis(np.array([0,0,0,1,2,3]), 'vec') # vector from origin to (1,2,3)
dvis(transform, 'transform') # display transformation
dvis(img, 'img') # display an image using visdom

Check out more examples in ./examples

python examples/meshes.py
python examples/point_clouds.py
python examples/...

News

  • 0.84.0: Label and range image support, auto-format for img
    dvis(label_img [fmt='xyl']) # visualizses img of labels
    dvis(depth_map [fmt='xyr', cm='jet']) # visualizes an image of continuous values using cv2 color map
    dvis(heat_map [fmt='xyr', cm='hot']) 
    

🚀 Getting started

Install the dvis package: Via pypi:

pip install dvis

or from source:

git clone git@github.com:SirWyver/dvis.git
cd dvis
pip install .

Install the 3d web server (it's the easiest to have a separate conda env for it)

cd server
conda env create -f environment.yml
conda activate dvis_server

Start the 3d web server

cd server
python server.py

Verify you can open http://localhost:5001/ and see something like this:

Optionally, also start visdom to display images/videos/charts:

visdom -p 4999

The visdom server should be accessible at http://localhost:4999/.

Try out the client

import numpy as np
from dvis import dvis
dvis(np.random.rand(1000,6), s=0.03) # sends randomly colored 1000x3 point cloud to the 3d server
dvis("static/icon.png","img") # sends an image to the 2d server

Verify you can see a colored point cloud

📖 Documentation

For an overview of available commands check out the documentation

Shotcuts

Shortcut Description
Editor
w Translate
e Rotate
r Scale
z Undo
f Focus
DVIS
v Show/hide selected object
1-5 Toggle layer 1-5
0 Toggle all layers
Shift + 0-5 Show layer 0-5 add.
g Show/hide grid & axes helper
n Next keyframe
b Previous keyframe
. Next frame
, Previous frame
t Switch camera
[ Download screenshot

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

dvis-0.8.5.1-py3-none-any.whl (16.9 kB view hashes)

Uploaded Python 3

Supported by

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