Skip to content

SirWyver/dvis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.8.8.0: Bumped dependencies version, custom port support
dvis(port=<PORT>) # set port the client is sending on
dvis(vis_port=<PORT>) # set the port for visdom
  • 0.8.7.0: CLI for server: To start the server, use run

    dvis-server [--no_visdom]
    
  • 0.8.6.0: Histogram support using plotly

    dvis(array, "hist", mi=0.1,ma=0.8, nbins=10, name="Example histogram")
    
  • 0.8.4.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

1. Install the dvis package:

Via pypi:

pip install dvis

or from source:

git clone [email protected]:SirWyver/dvis.git
cd dvis
pip install .

2. Start the web server

# From the dvis repository folder:
dvis-server 

or manually

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

About

3D Visualizations made easy

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •