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 git@github.com: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 |
1 maintainer
Metadata
1 maintainer
Release files for dvis 0.9.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dvis-0.9.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / dvis-0.9.1.0-py3-none-any.whl
| Download URL | dvis-0.9.1.0-py3-none-any.whl |
|---|---|
| Size | 19.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a23a9e0b1cc0e1d51ceca35e79493d6f93203e1ebe36b57b754aeda185fd655e
|
|
BLAKE2b-256 checksum How to use checksums |
0c8386c42527abfc01207032d914e9c214d9671aa337ed089999f92aa27f1d3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.11.9
|
