Skip to main content

Streamlit PyVista

PyPI version Read the Docs

A Streamlit component that allow support for new pyvista viewer backend : Trame.

Installation instructions

pip install streamlit-pyvista

Usage Instructions

import streamlit as st
from streamlit_pyvista.mesh_viewer_component import MeshViewerComponent


def main():
    st.title("Simple Streamlit App With Pyvista Viewer")

    mesh_viewer = MeshViewerComponent(
        "https://gitlab.com/dcsm/streamlit-pyvista/-/raw/main/examples/assets/plate_hole.vtu")
    mesh_viewer2 = MeshViewerComponent("assets/plate_hole.vtu")

    mesh_viewer.show()
    mesh_viewer2.show()


if __name__ == "__main__":
    main()

Note that instead of a file path or a url it's also possible to pass an array of link or path to display a sequence of files.

This viewer leverage the capabilities of the new pyvista backend Trame, beyond the nice design revamp, it also supports remote rendering.

Package documentation

You can find the automatic documentation generated with sphinx here

Workflow overview

This package has 3 different components:

  • The Streamlit component
  • The Trame viewers
  • A "Server manager"

Streamlit component

This pyvista new backend requires now to have its own server for each instance of a pyvista plotter. This means that the streamlit component can be as simple as an iframe and displayed in the app and can use a simple api to communicate with the trame server and the server manager

Trame viewers

The Trame viewers are the servers that are embedded in the streamlit app, it has exposed api endpoints that allow the component to communicate with the server for action such as loading a mesh in the viewer.

Server manager

As said earlier, the trame viewers can only display one plotter at a time which means that if we want to display multiple plotters we need multiple servers. The job of the Server manager is to control how many trame viewers exists, if they need to killed or if they can be reused for other viewers

Workflow

These 3 components interact the following manner:

  1. A MeshViewerComponent is created and notify a ServerManager that it needs a viewer.
  2. The ServerManager look if he have idling trame viewer anf if not, it start a new server.
  3. The ServerManager specify the endpoints of the server that can be used to the MeshViewerComponent
  4. The MeshViewerComponent directly communicate with the api of the trame viewer via the endpoints specified by the ServerManager

Metadata

Release files for streamlit-pyvista 0.0.22

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for streamlit-pyvista 0.0.22
File Size Uploaded Provenance
streamlit_pyvista-0.0.22.tar.gz 4.9 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for streamlit-pyvista 0.0.22
File Interpreter ABI Platform
streamlit_pyvista-0.0.22-py3-none-any.whl Python 3 none any Details

Total release size: 4.9 MB

Release files / streamlit_pyvista-0.0.22.tar.gz

Download URL streamlit_pyvista-0.0.22.tar.gz
Size 4.9 MB
Tags Source
SHA-256 checksum
How to use checksums
58a44db122ddb73d24e12346967e1e7f2712ca89b9fa0d02dc7173e7d40802c2
BLAKE2b-256 checksum
How to use checksums
9a92f652de8a0a744a9622905124b6ed1a423261166a78497c78442e52c6aa16
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release files / streamlit_pyvista-0.0.22-py3-none-any.whl

Download URL streamlit_pyvista-0.0.22-py3-none-any.whl
Size 61.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9dcad57e42020a3a87c005f01eb44a5edc525cf96dd37a68709c824f302e6a90
BLAKE2b-256 checksum
How to use checksums
bc8255bb7da430985b3d4193664c1928db9f750bdff454a287e954153086800a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Security for streamlit-pyvista 0.0.22

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page