diff options
author | CoprDistGit <infra@openeuler.org> | 2023-05-10 09:40:50 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-05-10 09:40:50 +0000 |
commit | ae0890366b739fa372cdeefd8eeeb5b7d6a02b68 (patch) | |
tree | 8733d86c895ad617a29c0862e9f499b11eb56fc3 | |
parent | b0bd4a943ca6e1a03be980d4d9ba6865593130ad (diff) |
automatic import of python-dash-vtk
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-dash-vtk.spec | 740 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 742 insertions, 0 deletions
@@ -0,0 +1 @@ +/dash_vtk-0.0.9.tar.gz diff --git a/python-dash-vtk.spec b/python-dash-vtk.spec new file mode 100644 index 0000000..6109633 --- /dev/null +++ b/python-dash-vtk.spec @@ -0,0 +1,740 @@ +%global _empty_manifest_terminate_build 0 +Name: python-dash-vtk +Version: 0.0.9 +Release: 1 +Summary: React based declarative usage of vtk.js for Dash +License: MIT +URL: https://github.com/plotly/dash-vtk +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/e9/56/2489ae0e422c201baa12adbd331f8d2408063fc156a405f86617a4147aef/dash_vtk-0.0.9.tar.gz +BuildArch: noarch + +Requires: python3-dash +Requires: python3-vtk + +%description +# Dash VTK + +*Dash VTK lets you integrate the `vtk.js` visualization pipeline directly into your Dash app. It is powered by [`react-vtk-js`](https://github.com/Kitware/react-vtk-js/).* + + +| ![][usage-algorithm] | ![][pyvista-point-cloud] | ![][terrain-deformation] | +| --- | --- | --- | +| ![][volume-rendering] | ![][vtk-cfd] | ![][synthetic-volume] | + +* [Docs](https://github.com/plotly/dash-vtk/tree/master/docs) +* [Demo Explorer](https://dash-gallery.plotly.host/dash-vtk-explorer/) +* [Repository](https://github.com/plotly/dash-vtk) +* [Webinar](https://go.plotly.com/dash-vtk) + +## Getting started + +### Quickstart (Python) + +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`. + +### Quickstart (R) + +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](./docs/CONTRIBUTING.md) to learn about: + +* Setting up the environment +* Coding Style +* Code quality & design +* Tests +* Publishing + + +## Running the demos + +First clone the project (replace `<name>` with the desired demo): + +``` bash +git clone https://github.com/plotly/dash-vtk.git +cd dash-vtk/demos/<name>/ +``` + +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 +``` + +### Python environments + +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 <module> + 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 <module> + from .vtkOpenGLKit import * + File ".../python3.7/site-packages/vtk/vtkOpenGLKit.py", line 9, in <module> + 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](https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-apt) 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](https://github.com/plotly/dash-sample-apps/blob/master/apps/dash-vtk-explorer/apt-packages) as an example. + +## References + +You can find the complete API reference in [`docs/REFERENCES.md`](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md) for each of the following components: +- [Algorithm](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Algorithm) +- [Calculator](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Calculator) +- [CellData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#CellData) +- [DataArray](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#DataArray) +- [FieldData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#FieldData) +- [GeometryRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#GeometryRepresentation) +- [ImageData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#ImageData) +- [PointCloudRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PointCloudRepresentation) +- [PointData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PointData) +- [PolyData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PolyData) +- [Reader](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Reader) +- [ShareDataSet](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#ShareDataSet) +- [SliceRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#SliceRepresentation) +- [View](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#View) +- [VolumeController](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeController) +- [VolumeDataRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeDataRepresentation) +- [VolumeRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeRepresentation) + +## Demos + +### Usage for `dash_vtk.Algorithm` + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/usage-algorithm) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/usage-algorithm) + +![][usage-algorithm] + +### Point Cloud with PyVista + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/pyvista-point-cloud) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/pyvista-point-cloud) + +![][pyvista-point-cloud] + +### Terrain deformation using PyVista and dash-vtk + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/pyvista-terrain-following-mesh) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/pyvista-terrain-following-mesh) + +![][terrain-deformation] + + +### Volume Rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/volume-rendering) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/volume-rendering) + +![A demo of the volume-rendering app][volume-rendering] + +### VTK for data processing and dash-vtk for rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/usage-vtk-cfd) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/usage-vtk-cfd) + +![A demo of the usage-vtk-cfd app][vtk-cfd] + +### Synthetic Volume Rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/synthetic-volume-rendering) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/synthetic-volume-rendering) + +![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 + + + + + +%package -n python3-dash-vtk +Summary: React based declarative usage of vtk.js for Dash +Provides: python-dash-vtk +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-dash-vtk +# Dash VTK + +*Dash VTK lets you integrate the `vtk.js` visualization pipeline directly into your Dash app. It is powered by [`react-vtk-js`](https://github.com/Kitware/react-vtk-js/).* + + +| ![][usage-algorithm] | ![][pyvista-point-cloud] | ![][terrain-deformation] | +| --- | --- | --- | +| ![][volume-rendering] | ![][vtk-cfd] | ![][synthetic-volume] | + +* [Docs](https://github.com/plotly/dash-vtk/tree/master/docs) +* [Demo Explorer](https://dash-gallery.plotly.host/dash-vtk-explorer/) +* [Repository](https://github.com/plotly/dash-vtk) +* [Webinar](https://go.plotly.com/dash-vtk) + +## Getting started + +### Quickstart (Python) + +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`. + +### Quickstart (R) + +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](./docs/CONTRIBUTING.md) to learn about: + +* Setting up the environment +* Coding Style +* Code quality & design +* Tests +* Publishing + + +## Running the demos + +First clone the project (replace `<name>` with the desired demo): + +``` bash +git clone https://github.com/plotly/dash-vtk.git +cd dash-vtk/demos/<name>/ +``` + +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 +``` + +### Python environments + +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 <module> + 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 <module> + from .vtkOpenGLKit import * + File ".../python3.7/site-packages/vtk/vtkOpenGLKit.py", line 9, in <module> + 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](https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-apt) 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](https://github.com/plotly/dash-sample-apps/blob/master/apps/dash-vtk-explorer/apt-packages) as an example. + +## References + +You can find the complete API reference in [`docs/REFERENCES.md`](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md) for each of the following components: +- [Algorithm](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Algorithm) +- [Calculator](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Calculator) +- [CellData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#CellData) +- [DataArray](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#DataArray) +- [FieldData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#FieldData) +- [GeometryRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#GeometryRepresentation) +- [ImageData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#ImageData) +- [PointCloudRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PointCloudRepresentation) +- [PointData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PointData) +- [PolyData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PolyData) +- [Reader](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Reader) +- [ShareDataSet](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#ShareDataSet) +- [SliceRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#SliceRepresentation) +- [View](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#View) +- [VolumeController](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeController) +- [VolumeDataRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeDataRepresentation) +- [VolumeRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeRepresentation) + +## Demos + +### Usage for `dash_vtk.Algorithm` + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/usage-algorithm) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/usage-algorithm) + +![][usage-algorithm] + +### Point Cloud with PyVista + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/pyvista-point-cloud) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/pyvista-point-cloud) + +![][pyvista-point-cloud] + +### Terrain deformation using PyVista and dash-vtk + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/pyvista-terrain-following-mesh) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/pyvista-terrain-following-mesh) + +![][terrain-deformation] + + +### Volume Rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/volume-rendering) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/volume-rendering) + +![A demo of the volume-rendering app][volume-rendering] + +### VTK for data processing and dash-vtk for rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/usage-vtk-cfd) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/usage-vtk-cfd) + +![A demo of the usage-vtk-cfd app][vtk-cfd] + +### Synthetic Volume Rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/synthetic-volume-rendering) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/synthetic-volume-rendering) + +![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 + + + + + +%package help +Summary: Development documents and examples for dash-vtk +Provides: python3-dash-vtk-doc +%description help +# Dash VTK + +*Dash VTK lets you integrate the `vtk.js` visualization pipeline directly into your Dash app. It is powered by [`react-vtk-js`](https://github.com/Kitware/react-vtk-js/).* + + +| ![][usage-algorithm] | ![][pyvista-point-cloud] | ![][terrain-deformation] | +| --- | --- | --- | +| ![][volume-rendering] | ![][vtk-cfd] | ![][synthetic-volume] | + +* [Docs](https://github.com/plotly/dash-vtk/tree/master/docs) +* [Demo Explorer](https://dash-gallery.plotly.host/dash-vtk-explorer/) +* [Repository](https://github.com/plotly/dash-vtk) +* [Webinar](https://go.plotly.com/dash-vtk) + +## Getting started + +### Quickstart (Python) + +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`. + +### Quickstart (R) + +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](./docs/CONTRIBUTING.md) to learn about: + +* Setting up the environment +* Coding Style +* Code quality & design +* Tests +* Publishing + + +## Running the demos + +First clone the project (replace `<name>` with the desired demo): + +``` bash +git clone https://github.com/plotly/dash-vtk.git +cd dash-vtk/demos/<name>/ +``` + +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 +``` + +### Python environments + +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 <module> + 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 <module> + from .vtkOpenGLKit import * + File ".../python3.7/site-packages/vtk/vtkOpenGLKit.py", line 9, in <module> + 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](https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-apt) 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](https://github.com/plotly/dash-sample-apps/blob/master/apps/dash-vtk-explorer/apt-packages) as an example. + +## References + +You can find the complete API reference in [`docs/REFERENCES.md`](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md) for each of the following components: +- [Algorithm](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Algorithm) +- [Calculator](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Calculator) +- [CellData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#CellData) +- [DataArray](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#DataArray) +- [FieldData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#FieldData) +- [GeometryRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#GeometryRepresentation) +- [ImageData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#ImageData) +- [PointCloudRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PointCloudRepresentation) +- [PointData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PointData) +- [PolyData](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#PolyData) +- [Reader](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#Reader) +- [ShareDataSet](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#ShareDataSet) +- [SliceRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#SliceRepresentation) +- [View](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#View) +- [VolumeController](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeController) +- [VolumeDataRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeDataRepresentation) +- [VolumeRepresentation](https://github.com/plotly/dash-vtk/blob/master/docs/REFERENCES.md#VolumeRepresentation) + +## Demos + +### Usage for `dash_vtk.Algorithm` + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/usage-algorithm) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/usage-algorithm) + +![][usage-algorithm] + +### Point Cloud with PyVista + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/pyvista-point-cloud) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/pyvista-point-cloud) + +![][pyvista-point-cloud] + +### Terrain deformation using PyVista and dash-vtk + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/pyvista-terrain-following-mesh) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/pyvista-terrain-following-mesh) + +![][terrain-deformation] + + +### Volume Rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/volume-rendering) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/volume-rendering) + +![A demo of the volume-rendering app][volume-rendering] + +### VTK for data processing and dash-vtk for rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/usage-vtk-cfd) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/usage-vtk-cfd) + +![A demo of the usage-vtk-cfd app][vtk-cfd] + +### Synthetic Volume Rendering + +* [Code](https://github.com/plotly/dash-vtk/tree/master/demos/synthetic-volume-rendering) +* [Online Demo](https://dash-gallery.plotly.host/dash-vtk-explorer/synthetic-volume-rendering) + +![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 + + + + + +%prep +%autosetup -n dash-vtk-0.0.9 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-dash-vtk -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed May 10 2023 Python_Bot <Python_Bot@openeuler.org> - 0.0.9-1 +- Package Spec generated @@ -0,0 +1 @@ +bdbdaf825f2afb433616316454343dbb dash_vtk-0.0.9.tar.gz |