VTK/ParaView widgets for trame
===========================================================
.. image:: https://github.com/Kitware/trame-vtk/actions/workflows/test_and_release.yml/badge.svg
:target: https://github.com/Kitware/trame-vtk/actions/workflows/test_and_release.yml
:alt: Test and Release
trame-vtk extend trame **widgets** with components that can interface with VTK and/or ParaView.
VTK integration in trame allows you to create rich visualization and data processing applications by leveraging the Python wrapping of the VTK library.
Several components are available so you can leverage VTK either for its data processing and/or rendering.
trame lets you choose if you want to leverage Remote Rendering or if the client should do the rendering by leveraging vtk.js under the hood.
Installing
-----------------------------------------------------------
trame-vtk can be installed with `pip <https://pypi.org/project/trame-vtk/>`_:
.. code-block:: bash
pip install --upgrade trame-vtk
Usage
-----------------------------------------------------------
The `Trame Tutorial <https://kitware.github.io/trame/guide/tutorial/>`_ is the place to go to learn how to use the library and start building your own application.
The `API Reference <https://trame.readthedocs.io/en/latest/index.html>`_ documentation provides API-level documentation.
License
-----------------------------------------------------------
trame-vtk is made available under the BSD-3-Clause License. For more details, see `LICENSE <https://github.com/Kitware/trame-vtk/blob/master/LICENSE>`_
This license has been chosen to match the one use by `VTK <https://github.com/Kitware/VTK/blob/master/Copyright.txt>`_ and `ParaView <https://github.com/Kitware/ParaView/blob/master/Copyright.txt>`_ which can be exposed via this library.
Community
-----------------------------------------------------------
`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `RoadMap <https://github.com/Kitware/trame/projects/1>`_ | `Contact Us <https://www.kitware.com/contact-us/>`_
.. image:: https://zenodo.org/badge/410108340.svg
:target: https://zenodo.org/badge/latestdoi/410108340
Enjoying trame?
-----------------------------------------------------------
Share your experience `with a testimonial <https://github.com/Kitware/trame/issues/18>`_ or `with a brand approval <https://github.com/Kitware/trame/issues/19>`_.
Development: Grabbing client before push to PyPI
-----------------------------------------------------------
To update the client code, run the following command line while updating the targeted version
.. code-block:: console
bash .fetch_externals.sh
Trame widgets
-----------------------------------------------------------
VtkRemoteView
-----------------------------------------------------------
The VtkRemoteView component relies on the server for rendering by sending images to the client by simply binding your vtkRenderWindow to it.
This component gives you controls to the image size reduction and quality to reduce latency while interacting.
How to use it?
```````````````````````````````````````````````````````````
The component allows you to directly tap into a vtk.js interactor's events so you can bind your own method from Python to them.
The list of available events can be found `here <https://github.com/Kitware/vtk-js/blob/b92ad5463150b88514fcb5020c1fa6c7fcfe2a4f/Sources/Rendering/Core/RenderWindowInteractor/index.js#L23-L60>`_.
The component also provides a convenient method for pushing a new image to the client when you're modifying your scene on the Python side.
.. code-block:: python
from trame.widgets import vtk
def end():
pass
remote_view = vtk.vtkRemoteView(
view=..., # Instance of vtkRenderWindow (required)
ref=..., # Identifier for this component
interactive_quality=60, # [0, 100] 0 for fastest render, 100 for best quality
interactive_ratio=..., # [0.1, 1] Image size scale factor while interacting
interactor_events=( # Enable vtk.js interactor events for method binding
"events",
["EndAnimation"],
),
EndAnimation=end, # Bind method to the enabled event
)
remote_view.update() # Force image to be pushed to client
Examples
```````````````````````````````````````````````````````````
- `VTK/SimpleCone/RemoteRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/SimpleCone/RemoteRendering.py>`_
- `VTK/ContourGeometry/RemoteRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/ContourGeometry/RemoteRendering.py>`_
- `VTK/Applications/ZarrContourViewer <https://github.com/Kitware/trame/blob/master/examples/VTK/Applications/ZarrContourViewer/app.py>`_
VtkLocalView
-----------------------------------------------------------
The VtkLocalView component relies on the server for defining the vtkRenderWindow but then only the geometry is exchanged with the client.
The server does not need a GPU as no rendering is happening on the server.
The vtkRenderWindow is only used to retrieve the scene data and parameters (coloring by, representations, ...).
By relying on the same vtkRenderWindow, you can easily switch from a `VtkRemoteView` to a `VtkLocalView` or vice-versa.
This component gives you controls on how you want to map mouse interaction with the camera.
The default setting mimic default VTK interactor style so you will rarely have to override to the `interactor_settings`.
How to use it?
```````````````````````````````````````````````````````````
The component allows you to directly tap into a vtk.js interactor events so you can bind your own method from python to them.
The list of available events can be found `here <https://github.com/Kitware/vtk-js/blob/b92ad5463150b88514fcb5020c1fa6c7fcfe2a4f/Sources/Rendering/Core/RenderWindowInteractor/index.js#L23-L60>`_.
The component also provides a convenient method to push the scene to the client when you're modifying your scene on the python side.
.. code-block:: python
from trame.widgets import vtk
def end():
pass
local_view = vtk.VtkLocalView(
view=..., # Instance of vtkRenderWindow (required)
ref=..., # Identifier for this component
context_name=..., # Namespace for geometry cache
interactor_settings=..., # Options for camera controls. See below.
interactor_events=( # Enable vtk.js interactor events for method binding
"events",
['EndAnimation'],
),
EndAnimation=end, # Bind method to the enabled event
)
local_view.update() # Force geometry to be pushed
Interactor Settings
```````````````````````````````````````````````````````````
For the `interactor_settings` we expect a list of mouse event type linked to an action. The example below is what is used as default:
.. code-block:: javascript
interactor_settings=[
{
button: 1,
action: 'Rotate',
}, {
button: 2,
action: 'Pan',
}, {
button: 3,
action: 'Zoom',
scrollEnabled: true,
}, {
button: 1,
action: 'Pan',
shift: true,
}, {
button: 1,
action: 'Zoom',
alt: true,
}, {
button: 1,
action: 'ZoomToMouse',
control: true,
}, {
button: 1,
action: 'Roll',
alt: true,
shift: true,
}
]
A mouse event can be identified with the following set of properties:
.. list-table::
:widths: 20 20 60
:header-rows: 1
* - Attribute
- Value
- Description
* - button
- 1, 2, 3
- Which button should be down
* - shift
- true/false
- Is the Shift key down
* - alt
- true/false
- Is the Alt key down
* - control
- true/false
- Is the Ctrl key down
* - scrollEnabled
- true/false
- Some action could also be triggered by scroll
* - dragEnabled
- true/false
- Mostly used to disable default drag behavior
And the action could be one of the following:
.. list-table::
:widths: 25 75
:header-rows: 1
* - Action
- Description
* - Pan
- Will pan the object on the plane normal to the camera
* - Zoom
- Will zoom closer or further from the object based on the drag direction
* - Roll
- Will rotate the object around the view direction
* - ZoomToMouse
- Will zoom while keeping the location that was initially under the mouse at the same spot
Examples
```````````````````````````````````````````````````````````
- `VTK/SimpleCone/LocalRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/SimpleCone/LocalRendering.py>`_
- `VTK/ContourGeometry/LocalRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/ContourGeometry/LocalRendering.py>`_
- `Tutorial/VTK/CarotidFlow <https://github.com/Kitware/trame/blob/master/examples/Tutorial/VTK/CarotidFlow.py>`_
VtkRemoteLocalView
-----------------------------------------------------------
The VtkRemoteLocalView component is a blend of `VtkLocalView` and `VtkRemoteView` where the user can choose dynamically which mode they want to be in.
When instantiating a `VtkRemoteLocalView` several variables and triggers will be created for you to more easily control your view.
How to use it?
```````````````````````````````````````````````````````````
.. code-block:: python
from trame.html import vtk
rl_view = vtk.VtkRemoteLocalView(
view=..., # Instance of vtkRenderWindow (required)
# Just VtkRemoteLocalView params
namespace=..., # Prefix for variables and triggers. See below. (required)
mode="local", # Decide between local or remote. See below.
# VtkRemoteView params
**remote_view_params,
# VtkLocalView params
**local_view_params,
)
rl_view.update_geometry() # Force update to geometry
rl_view.update_image() # Force update to image
rl_view.view() # Get linked vtkRenderWindow instance
Namespace parameter
```````````````````````````````````````````````````````````
Constructing a VtkRemoteLocalView will set several variables, prefixed by a namespace. In the example below we used `namespace="view"`.
.. list-table::
:widths: 25 75
:header-rows: 1
* - Variable
- Description
* - viewId
- `str` representing the vtkRenderWindow id
* - viewMode
- `local`or `remote` to control which View is displayed to the user
Constructing a VtkRemoteLocalView will also set several trame triggers.
.. list-table::
:widths: 25 75
:header-rows: 1
* - Trigger
- Description
* - viewCamera
- When call with no arguments, the server will push its camera to the client
* - viewAnimateStart
- Start the animation loop for constantly rendering
* - viewAnimateStop
- Stop the animation loop
The `namespace` will also be used as `ref=` unless provided by the user.
Mode parameter
```````````````````````````````````````````````````````````
The mode is driven by the variable `{namespace}Mode` but can be provided when instantiated so the default can be overridden and a JavaScript expression can be used instead of the default variable. This attribute behaves the same way as any trame one except, we won't register the left side as a state entry since we already have one under `{namespace}Mode`. This means we will evaluate the left side of the expression assuming a tuple is provided and the right side of the tuple is used to set its initial value.
Examples
```````````````````````````````````````````````````````````
- `API <https://trame.readthedocs.io/en/latest/trame.html.vtk.html>`_
- `VTK/ContourGeometry/DynamicLocalRemoteRendering <https://github.com/Kitware/trame/blob/f6594a02ed7e1ecc24058ffac527e010e8181e22/examples/VTK/ContourGeometry/DynamicLocalRemoteRendering.py>`_
Raw data
{
"_id": null,
"home_page": null,
"name": "trame-vtk",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Python, Interactive, Web, Application, Framework",
"author": "Kitware Inc.",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f8/5d/e2c8f2af2fbd8b1fae3c896d6ad90767054a3bcaebb2ec75b9228ae25284/trame-vtk-2.8.7.tar.gz",
"platform": null,
"description": "VTK/ParaView widgets for trame\n===========================================================\n\n.. image:: https://github.com/Kitware/trame-vtk/actions/workflows/test_and_release.yml/badge.svg\n :target: https://github.com/Kitware/trame-vtk/actions/workflows/test_and_release.yml\n :alt: Test and Release\n\ntrame-vtk extend trame **widgets** with components that can interface with VTK and/or ParaView.\n\nVTK integration in trame allows you to create rich visualization and data processing applications by leveraging the Python wrapping of the VTK library.\nSeveral components are available so you can leverage VTK either for its data processing and/or rendering.\ntrame lets you choose if you want to leverage Remote Rendering or if the client should do the rendering by leveraging vtk.js under the hood.\n\n\nInstalling\n-----------------------------------------------------------\n\ntrame-vtk can be installed with `pip <https://pypi.org/project/trame-vtk/>`_:\n\n.. code-block:: bash\n\n pip install --upgrade trame-vtk\n\n\nUsage\n-----------------------------------------------------------\n\nThe `Trame Tutorial <https://kitware.github.io/trame/guide/tutorial/>`_ is the place to go to learn how to use the library and start building your own application.\n\nThe `API Reference <https://trame.readthedocs.io/en/latest/index.html>`_ documentation provides API-level documentation.\n\n\nLicense\n-----------------------------------------------------------\n\ntrame-vtk is made available under the BSD-3-Clause License. For more details, see `LICENSE <https://github.com/Kitware/trame-vtk/blob/master/LICENSE>`_\nThis license has been chosen to match the one use by `VTK <https://github.com/Kitware/VTK/blob/master/Copyright.txt>`_ and `ParaView <https://github.com/Kitware/ParaView/blob/master/Copyright.txt>`_ which can be exposed via this library.\n\n\nCommunity\n-----------------------------------------------------------\n\n`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `RoadMap <https://github.com/Kitware/trame/projects/1>`_ | `Contact Us <https://www.kitware.com/contact-us/>`_\n\n.. image:: https://zenodo.org/badge/410108340.svg\n :target: https://zenodo.org/badge/latestdoi/410108340\n\n\nEnjoying trame?\n-----------------------------------------------------------\n\nShare your experience `with a testimonial <https://github.com/Kitware/trame/issues/18>`_ or `with a brand approval <https://github.com/Kitware/trame/issues/19>`_.\n\n\nDevelopment: Grabbing client before push to PyPI\n-----------------------------------------------------------\n\nTo update the client code, run the following command line while updating the targeted version\n\n.. code-block:: console\n\n bash .fetch_externals.sh\n\n\nTrame widgets\n-----------------------------------------------------------\n\nVtkRemoteView\n-----------------------------------------------------------\n\nThe VtkRemoteView component relies on the server for rendering by sending images to the client by simply binding your vtkRenderWindow to it.\nThis component gives you controls to the image size reduction and quality to reduce latency while interacting.\n\n\nHow to use it?\n```````````````````````````````````````````````````````````\n\nThe component allows you to directly tap into a vtk.js interactor's events so you can bind your own method from Python to them.\nThe list of available events can be found `here <https://github.com/Kitware/vtk-js/blob/b92ad5463150b88514fcb5020c1fa6c7fcfe2a4f/Sources/Rendering/Core/RenderWindowInteractor/index.js#L23-L60>`_.\n\nThe component also provides a convenient method for pushing a new image to the client when you're modifying your scene on the Python side.\n\n.. code-block:: python\n\n from trame.widgets import vtk\n\n def end():\n pass\n\n remote_view = vtk.vtkRemoteView(\n view=..., # Instance of vtkRenderWindow (required)\n ref=..., # Identifier for this component\n interactive_quality=60, # [0, 100] 0 for fastest render, 100 for best quality\n interactive_ratio=..., # [0.1, 1] Image size scale factor while interacting\n interactor_events=( # Enable vtk.js interactor events for method binding\n \"events\",\n [\"EndAnimation\"],\n ),\n EndAnimation=end, # Bind method to the enabled event\n )\n\n remote_view.update() # Force image to be pushed to client\n\n\nExamples\n```````````````````````````````````````````````````````````\n\n- `VTK/SimpleCone/RemoteRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/SimpleCone/RemoteRendering.py>`_\n- `VTK/ContourGeometry/RemoteRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/ContourGeometry/RemoteRendering.py>`_\n- `VTK/Applications/ZarrContourViewer <https://github.com/Kitware/trame/blob/master/examples/VTK/Applications/ZarrContourViewer/app.py>`_\n\n\nVtkLocalView\n-----------------------------------------------------------\n\nThe VtkLocalView component relies on the server for defining the vtkRenderWindow but then only the geometry is exchanged with the client.\nThe server does not need a GPU as no rendering is happening on the server.\nThe vtkRenderWindow is only used to retrieve the scene data and parameters (coloring by, representations, ...).\nBy relying on the same vtkRenderWindow, you can easily switch from a `VtkRemoteView` to a `VtkLocalView` or vice-versa.\nThis component gives you controls on how you want to map mouse interaction with the camera.\nThe default setting mimic default VTK interactor style so you will rarely have to override to the `interactor_settings`.\n\nHow to use it?\n```````````````````````````````````````````````````````````\n\nThe component allows you to directly tap into a vtk.js interactor events so you can bind your own method from python to them.\nThe list of available events can be found `here <https://github.com/Kitware/vtk-js/blob/b92ad5463150b88514fcb5020c1fa6c7fcfe2a4f/Sources/Rendering/Core/RenderWindowInteractor/index.js#L23-L60>`_.\n\nThe component also provides a convenient method to push the scene to the client when you're modifying your scene on the python side.\n\n.. code-block:: python\n\n from trame.widgets import vtk\n\n def end():\n pass\n\n local_view = vtk.VtkLocalView(\n view=..., # Instance of vtkRenderWindow (required)\n ref=..., # Identifier for this component\n context_name=..., # Namespace for geometry cache\n interactor_settings=..., # Options for camera controls. See below.\n interactor_events=( # Enable vtk.js interactor events for method binding\n \"events\",\n ['EndAnimation'],\n ),\n EndAnimation=end, # Bind method to the enabled event\n )\n\n local_view.update() # Force geometry to be pushed\n\n\n\nInteractor Settings\n```````````````````````````````````````````````````````````\n\nFor the `interactor_settings` we expect a list of mouse event type linked to an action. The example below is what is used as default:\n\n.. code-block:: javascript\n\n interactor_settings=[\n {\n button: 1,\n action: 'Rotate',\n }, {\n button: 2,\n action: 'Pan',\n }, {\n button: 3,\n action: 'Zoom',\n scrollEnabled: true,\n }, {\n button: 1,\n action: 'Pan',\n shift: true,\n }, {\n button: 1,\n action: 'Zoom',\n alt: true,\n }, {\n button: 1,\n action: 'ZoomToMouse',\n control: true,\n }, {\n button: 1,\n action: 'Roll',\n alt: true,\n shift: true,\n }\n ]\n\nA mouse event can be identified with the following set of properties:\n\n.. list-table::\n :widths: 20 20 60\n :header-rows: 1\n\n * - Attribute\n - Value\n - Description\n * - button\n - 1, 2, 3\n - Which button should be down\n * - shift\n - true/false\n - Is the Shift key down\n * - alt\n - true/false\n - Is the Alt key down\n * - control\n - true/false\n - Is the Ctrl key down\n * - scrollEnabled\n - true/false\n - Some action could also be triggered by scroll\n * - dragEnabled\n - true/false\n - Mostly used to disable default drag behavior\n\nAnd the action could be one of the following:\n\n.. list-table::\n :widths: 25 75\n :header-rows: 1\n\n * - Action\n - Description\n * - Pan\n - Will pan the object on the plane normal to the camera\n * - Zoom\n - Will zoom closer or further from the object based on the drag direction\n * - Roll\n - Will rotate the object around the view direction\n * - ZoomToMouse\n - Will zoom while keeping the location that was initially under the mouse at the same spot\n\n\nExamples\n```````````````````````````````````````````````````````````\n\n- `VTK/SimpleCone/LocalRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/SimpleCone/LocalRendering.py>`_\n- `VTK/ContourGeometry/LocalRendering <https://github.com/Kitware/trame/blob/master/examples/VTK/ContourGeometry/LocalRendering.py>`_\n- `Tutorial/VTK/CarotidFlow <https://github.com/Kitware/trame/blob/master/examples/Tutorial/VTK/CarotidFlow.py>`_\n\n\nVtkRemoteLocalView\n-----------------------------------------------------------\n\nThe VtkRemoteLocalView component is a blend of `VtkLocalView` and `VtkRemoteView` where the user can choose dynamically which mode they want to be in.\nWhen instantiating a `VtkRemoteLocalView` several variables and triggers will be created for you to more easily control your view.\n\nHow to use it?\n```````````````````````````````````````````````````````````\n\n.. code-block:: python\n\n from trame.html import vtk\n\n rl_view = vtk.VtkRemoteLocalView(\n view=..., # Instance of vtkRenderWindow (required)\n\n # Just VtkRemoteLocalView params\n namespace=..., # Prefix for variables and triggers. See below. (required)\n mode=\"local\", # Decide between local or remote. See below.\n\n # VtkRemoteView params\n **remote_view_params,\n\n # VtkLocalView params\n **local_view_params,\n )\n\n rl_view.update_geometry() # Force update to geometry\n rl_view.update_image() # Force update to image\n rl_view.view() # Get linked vtkRenderWindow instance\n\n\nNamespace parameter\n```````````````````````````````````````````````````````````\n\nConstructing a VtkRemoteLocalView will set several variables, prefixed by a namespace. In the example below we used `namespace=\"view\"`.\n\n.. list-table::\n :widths: 25 75\n :header-rows: 1\n\n * - Variable\n - Description\n * - viewId\n - `str` representing the vtkRenderWindow id\n * - viewMode\n - `local`or `remote` to control which View is displayed to the user\n\nConstructing a VtkRemoteLocalView will also set several trame triggers.\n\n.. list-table::\n :widths: 25 75\n :header-rows: 1\n\n * - Trigger\n - Description\n * - viewCamera\n - When call with no arguments, the server will push its camera to the client\n * - viewAnimateStart\n - Start the animation loop for constantly rendering\n * - viewAnimateStop\n - Stop the animation loop\n\nThe `namespace` will also be used as `ref=` unless provided by the user.\n\nMode parameter\n```````````````````````````````````````````````````````````\n\nThe mode is driven by the variable `{namespace}Mode` but can be provided when instantiated so the default can be overridden and a JavaScript expression can be used instead of the default variable. This attribute behaves the same way as any trame one except, we won't register the left side as a state entry since we already have one under `{namespace}Mode`. This means we will evaluate the left side of the expression assuming a tuple is provided and the right side of the tuple is used to set its initial value.\n\nExamples\n```````````````````````````````````````````````````````````\n\n- `API <https://trame.readthedocs.io/en/latest/trame.html.vtk.html>`_\n- `VTK/ContourGeometry/DynamicLocalRemoteRendering <https://github.com/Kitware/trame/blob/f6594a02ed7e1ecc24058ffac527e010e8181e22/examples/VTK/ContourGeometry/DynamicLocalRemoteRendering.py>`_\n",
"bugtrack_url": null,
"license": "BSD License",
"summary": "VTK widgets for trame",
"version": "2.8.7",
"project_urls": null,
"split_keywords": [
"python",
" interactive",
" web",
" application",
" framework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f6f94bdcd7a9f41b35824f117b82ff306c581fb464008d2042c8b58c48972daa",
"md5": "c3df4fa42c7812d9d7322d435f8052f8",
"sha256": "54abf5c638352290230ea447ca116ca58d25011d0cd5ee30aa5ab52f32d734d1"
},
"downloads": -1,
"filename": "trame_vtk-2.8.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c3df4fa42c7812d9d7322d435f8052f8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 743764,
"upload_time": "2024-05-02T14:02:58",
"upload_time_iso_8601": "2024-05-02T14:02:58.489648Z",
"url": "https://files.pythonhosted.org/packages/f6/f9/4bdcd7a9f41b35824f117b82ff306c581fb464008d2042c8b58c48972daa/trame_vtk-2.8.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f85de2c8f2af2fbd8b1fae3c896d6ad90767054a3bcaebb2ec75b9228ae25284",
"md5": "61c4307655216d41921e7e617d46cbb3",
"sha256": "16f48634f420e1dfff2d662e588995e352e203f8558ac5d648a542da8f9fa70e"
},
"downloads": -1,
"filename": "trame-vtk-2.8.7.tar.gz",
"has_sig": false,
"md5_digest": "61c4307655216d41921e7e617d46cbb3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 728238,
"upload_time": "2024-05-02T14:03:00",
"upload_time_iso_8601": "2024-05-02T14:03:00.711313Z",
"url": "https://files.pythonhosted.org/packages/f8/5d/e2c8f2af2fbd8b1fae3c896d6ad90767054a3bcaebb2ec75b9228ae25284/trame-vtk-2.8.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-02 14:03:00",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "trame-vtk"
}
JSON