React based declarative usage of vtk.js for Dash
npm install dash_vtkDash VTK lets you integrate the vtk.js visualization pipeline directly into your Dash app. It is powered by react-vtk-js.
| ![][usage-algorithm] | ![][pyvista-point-cloud] | ![][terrain-deformation] |
| --- | --- | --- |
| ![][volume-rendering] | ![][vtk-cfd] | ![][synthetic-volume] |
* Docs
* Demo Explorer
* Repository
* Webinar
First, install the library through pip:
``
pip install dash-vtk
Then, create a file called app.py and add the following example:
`python
import dash
import dash_vtk
import dash_html_components as html
app = dash.Dash(__name__)
app.layout = html.Div(
style={"width": "100%", "height": "calc(100vh - 16px)"},
children=dash_vtk.View([
dash_vtk.GeometryRepresentation([
dash_vtk.Algorithm(
vtkClass="vtkConeSource",
state={"resolution": 64, "capping": False},
)
]),
]),
)
if __name__ == "__main__":
app.run_server(debug=True)
`
Now, simply run the app:
`
python app.py
For a more detailed example, see usage.py.
First, install the package from GitHub (the package is not yet available via CRAN):
`
remotes::install_github("plotly/dash-vtk")
then, create your component and add it to your layout:
`r
library(dash)
library(dashVtk)
library(dashHtmlComponents)
app <- Dash$new()
app$layout(htmlDiv(
style = list("width" = "100%", "height" = "calc(100vh - 16px)"),
children = vtkView(list(
vtkGeometryRepresentation(
vtkAlgorithm(
vtkClass = "vtkConeSource",
state = list("resolution" = 64, "capping" = FALSE),
)
)
)
)
app$run_server()
`Contributing
See docs/CONTRIBUTING.md to learn about:
* Setting up the environment
* Coding Style
* Code quality & design
* Tests
* Publishing
First clone the project (replace with the desired demo):
` bash`
git clone https://github.com/plotly/dash-vtk.git
cd dash-vtk/demos/
Create a venv and install the requirements:
`bash`
python -m venv venv
source venv/bin/activate # for Windows, use venv\Scripts\activate.bat
pip install -e ../../ # IMPORTANT! If you skip you will get the pip version of dash-vtk
pip install -r requirements.txt
Run the demo:
`bash`
python app.py
Depending on your Python environment, you may run into deployment issue related to the vtk version that get pulled in.
Ideally we want a version of vtk equal or newer than 9. When using such version of VTK, dash-vtk won't even try to load the rendering module of VTK and if OpenGL is not available on your system everything will still be fine.
On the other hand, if you are running python-3.6 and/or pip-18 or less and you don't upgrade your pip version, you will only be able to use vtk<=8.1.2. With vtk 8, there is no way to prevent the loading of the GL library which means that you will have to install libGL on your system, or you will run into errors like this:
`
File ".../python/lib/python3.6/site-packages/vtkmodules/all.py", line 29, in
from .vtkRenderingOpenGL2 import *
ImportError: libGL.so.1: cannot open shared object file: No such file or directory
[2021-02-08 18:36:15 +0000] [10] [INFO] Worker exiting (pid: 10)
or this:
`
File ".../python3.7/site-packages/vtk/__init__.py", line 12, in
from .vtkOpenGLKit import *
File ".../python3.7/site-packages/vtk/vtkOpenGLKit.py", line 9, in
from vtkOpenGLKitPython import *
ModuleNotFoundError: No module named 'vtkOpenGLKitPython'
Heroku and Dash Enterprise handle it is slightly different because you will have to install libgl1-mesa-glx via some apt files. In the case of Heroku, you will have to use a buildpack and add libgl1-mesa-glx to a Aptfile located in the root of your project. In the case of Dash Enterprise, you do not need to change the buildpack (it is handled automatically) but you will need to add libgl1-mesa-glx to a apt-packages file instead of Aptfile; see this app as an example.
You can find the complete API reference in docs/REFERENCES.md` for each of the following components:
- Algorithm
- Calculator
- CellData
- DataArray
- FieldData
- GeometryRepresentation
- ImageData
- PointCloudRepresentation
- PointData
- PolyData
- Reader
- ShareDataSet
- SliceRepresentation
- View
- VolumeController
- VolumeDataRepresentation
- VolumeRepresentation
* Code
* Online Demo
![][usage-algorithm]
* Code
* Online Demo
![][pyvista-point-cloud]
* Code
* Online Demo
![][terrain-deformation]
* Code
* Online Demo
![A demo of the volume-rendering app][volume-rendering]
* Code
* Online Demo
![A demo of the usage-vtk-cfd app][vtk-cfd]
* Code
* Online Demo
![A demo of the synthetic-volume-rendering app][synthetic-volume]
[pyvista-point-cloud]: https://github.com/plotly/dash-vtk/blob/master/demos/pyvista-point-cloud/demo.jpg?raw=true
[usage-algorithm]: https://github.com/plotly/dash-vtk/blob/master/demos/usage-algorithm/demo.jpg?raw=true
[terrain-deformation]: https://github.com/plotly/dash-vtk/blob/master/demos/pyvista-terrain-following-mesh/demo.jpg?raw=true
[volume-rendering]: https://github.com/plotly/dash-vtk/blob/master/demos/volume-rendering/demo.jpg?raw=true
[vtk-cfd]: https://github.com/plotly/dash-vtk/blob/master/demos/usage-vtk-cfd/demo.jpg?raw=true
[synthetic-volume]: https://github.com/plotly/dash-vtk/blob/master/demos/synthetic-volume-rendering/demo.jpg?raw=true
[dicom-ct-lung]: https://github.com/plotly/dash-vtk/blob/master/demos/dicom-ct-lung/demo.jpg?raw=true
[dicom-mri-brain]: https://github.com/plotly/dash-vtk/blob/master/demos/dicom-mri-brain/demo.jpg?raw=true
[dicom-mri-pancreas]: https://github.com/plotly/dash-vtk/blob/master/demos/dicom-mri-pancreas/demo.jpg?raw=true