Skip to main content

Trame, a framework to build applications in plain Python

Project description

Test and Release

trame - a web framework that weaves together open source components into customized visual analytics easily.

trame is French for

  • the core that ties things together

  • a guide providing the essence of a task

Welcome to trame and 3D visualization

With trame, create stunning, interactive web applications compactly and intuitively.

image_1 image_2 image_3

3D Visualization

With best-in-class VTK and ParaView platforms at its core, trame provides complete control of 3D visualizations and data movements. Developers benefit from a write-once environment while trame simply exposes both local and remote rendering through a single method.

Rich Features

trame leverages existing libraries and tools such as Vuetify, Altair, Vega, deck.gl, VTK, ParaView, and more, to create vivid content for visual analytics applications.

Problem Focused

By relying simply on Python, trame focuses on one’s data and associated analysis and visualizations while hiding the complications of web app development.

Desktop to cloud

The resulting trame applications can act as local desktop applications or remote cloud applications both accessed through a browser.

Installing

trame can be installed with pip:

pip install --upgrade trame --pre

Usage

The Trame Tutorial is the place to go to learn how to use the library and start building your own application.

The API Reference documentation provides API-level documentation.

License

trame is made available under the Apache License, Version 2.0. For more details, see LICENSE

Community

Trame | Discussions | Issues | RoadMap | Contact Us

https://zenodo.org/badge/410108340.svg

Enjoying trame?

Share your experience with a testimonial or with a brand approval.

Optional dependencies

When installing trame using pip (pip install trame) you will get the core infrastructure for any trame application to work but more advanced usage may require additional dependencies. The list below capture which may need to add depending on your usage:

  • pywebview : Needed for desktop usage (–app)

  • jupyterlab : Needed to run inside jupyter-lab

  • notebook : Needed to run inside jupyter-notebook

  • requests : Needed when using remote assets such as GDrive files

Environments variables

  • TRAME_LOG_NETWORK : Path to log file for capturing network exchange. (default: None)

  • TRAME_WS_MAX_MSG_SIZE : Maximum size in bytes of any ws message. (default: 10MB)

  • TRAME_WS_HEART_BEAT : Time in second before assuming the server is non-responsive. (default: 30s)

Life cycle callbacks

Life cycle events are directly managed on the application controller and are prefixed with on_*.

  • on_server_ready : All protocols initialized and available for client to connect

  • on_client_connected : Connection established to server

  • on_client_exited : Linked to browser “beforeunload” event

  • on_server_exited : Trame is exiting its event loop

  • on_server_reload : If callback registered it is use for reloading server side modules

Reserved state entries

The shared state allow us to synchronize the server with the client. Rather than creating another mechanism to handle similar needs throughout the application we purposely reuse that state for internal purpose. To prevent any conflict with any user we are prefixing our internal variable with trame__*. In general those state values should not be use or changed by the user except for the one listed below:

Read/Write:
  • trame__favicon: Update it to replace the displayed favicon in your browser. The content needs to be a image encoded url.

  • trame__title: Update it to replace your page title (tab name / window name).

Read-only:
  • trame__busy: Provide information if we have pending request waiting for the server to respond.

  • tts: Template Time Stamp to regenerate sub elements when a template gets updated. Usually used as :key=”tts” to force some component rebuild.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trame-2.2.0.tar.gz (16.4 kB view details)

Uploaded Source

Built Distribution

trame-2.2.0-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

File details

Details for the file trame-2.2.0.tar.gz.

File metadata

  • Download URL: trame-2.2.0.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.3 readme-renderer/37.0 requests/2.28.1 requests-toolbelt/0.9.1 urllib3/1.26.12 tqdm/4.64.0 importlib-metadata/4.12.0 keyring/23.8.2 rfc3986/2.0.0 colorama/0.4.5 CPython/3.9.13

File hashes

Hashes for trame-2.2.0.tar.gz
Algorithm Hash digest
SHA256 3b18073904478b2b62a1a090fab39a705562013cd44d43cdc8736a3cbc722f67
MD5 3b2d4e70a1e3d68675e9e9f679c98267
BLAKE2b-256 f10eeea53eb1b20d9111f03da75182cb550fccabcdaad89fd1d5e00738b3cf47

See more details on using hashes here.

Provenance

File details

Details for the file trame-2.2.0-py3-none-any.whl.

File metadata

  • Download URL: trame-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 18.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.3 readme-renderer/37.0 requests/2.28.1 requests-toolbelt/0.9.1 urllib3/1.26.12 tqdm/4.64.0 importlib-metadata/4.12.0 keyring/23.8.2 rfc3986/2.0.0 colorama/0.4.5 CPython/3.9.13

File hashes

Hashes for trame-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 80ef1688d5c3f1e64e26d30a1ee55612d2b1f2de1ecd7e45b28682ccaa861ae3
MD5 682229df5c308ac64ed01a9aa41b8812
BLAKE2b-256 ee797859be0078c890637c66eb3c4b6b78aad013918aea6f87ddb198157b508f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page