Skip to main content

trame-slicer library

Project description

trame-slicer

Welcome to trame-slicer

trame-slicer is a Python library bringing 3DSlicer components in trame as a composable library.

It uses 3D Slicer's python wrapping and adds a thin wrapping to make it available with the trame framework.

Test and Release PyPI PyPI - Downloads GitHub stars Documentation Status codecov

Usage

The API Reference documentation provides API-level documentation.

Warning

The API has not been stabilized / reviewed by the 3D Slicer core developers so please use this library with caution.

Installing

The library can be installed in a Python environment as follows:

  • Setup a Python 3.10-3.13 (included) virtualenv and activate it
  • From PyPI
    • Use pip install "trame-slicer[standalone]" to install the latest release
  • From GitHub
    • Git clone the library
    • cd into the library
    • Use the pip install -e ".[standalone]" command to install the library along it's dependencies
  • For optimal performances, you should install turbo-jpeg

Getting started

To get started using trame, please have a look at the introductory trame course.

To start using the trame-slicer library, have a look and run the medical viewer app:

python examples/medical_viewer_app.py

Features

The following subset of 3D Slicer features are currently supported :

  • (limited) file loading
  • Volume files (DCM, NRRD, NIFTI, ...)
  • Model files (STL, OBJ)
  • MRML / MRB files
  • Segmentations (NRRD, NIFTI, ...)
  • Display
    • 2D/3D with 3D Slicer UI manipulation
    • Volume Rendering preset / shift
  • Bare bone access to 3D Slicer MRML scene and Core logic components

Work in progress

To make it easier for users to use trame-slicer, the following work are in progress :

  • Slicer wheel generation merge into 3D Slicer's preview release
  • CI changes to build the Slicer wheel along 3D Slicer's release
  • 3D Slicer extension to install trame-slicer and launch a trame-slicer server directly from 3D Slicer

Troubleshooting

ERROR: No matching distribution found for slicer-core

slicer-core is only supported on specific platforms, please check that your OS and Python version are listed on pypi

Contributing

Contributions are welcomed, please follow the CONTRIBUTING.md file for more information.

License

The library is distributed with a permissive license. Please look at the LICENSE file for more information.

Acknowledgments

This library was funded by the following projects :

This library was created from the trame-cookicutter library.

Contact

If you are interested in learning how you can use trame-slicer for your use case in the near future, or want to get an early start using the framework, don't hesitate to contact us. Or reach out in the issue tracker and 3DSlicer discourse community.

Project details


Download files

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

Source Distribution

trame_slicer-1.10.0.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

trame_slicer-1.10.0-py3-none-any.whl (997.5 kB view details)

Uploaded Python 3

File details

Details for the file trame_slicer-1.10.0.tar.gz.

File metadata

  • Download URL: trame_slicer-1.10.0.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for trame_slicer-1.10.0.tar.gz
Algorithm Hash digest
SHA256 9c5575706585b22feae779fa419b375a9ddca2cce93a2d8c0bd699fda42fb519
MD5 3f0b58d3c7ebf406de57695683bc483b
BLAKE2b-256 e0e4f385ba457d5f56ad46b4c3de6605fcc9be7204228d6061f0d4f0a9526908

See more details on using hashes here.

Provenance

The following attestation bundles were made for trame_slicer-1.10.0.tar.gz:

Publisher: release.yml on KitwareMedical/trame-slicer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file trame_slicer-1.10.0-py3-none-any.whl.

File metadata

  • Download URL: trame_slicer-1.10.0-py3-none-any.whl
  • Upload date:
  • Size: 997.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for trame_slicer-1.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 83bc8e71b460fbdbbae22d50b6d45919d62c4c11d403eb51b2bb039a73ad8224
MD5 1b91867409c3125ce11cd850925e4c42
BLAKE2b-256 b9d07d73d456cd1f77839e8f6924a1ced963724b07a9263fad0dc4007acf633a

See more details on using hashes here.

Provenance

The following attestation bundles were made for trame_slicer-1.10.0-py3-none-any.whl:

Publisher: release.yml on KitwareMedical/trame-slicer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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