Skip to main content

Python Template Matching Engine (PyTME)

Build Status PyPI

Documentation | Installation | API

PyTME is a Python library for data-intensive n-dimensional template matching using CPUs and GPUs.

With its backend-agnostic design, the same code can be run on diverse hardware platforms using a best-of-breed approach. The underyling abstract backend specification allows for adding new backends to benefit from gains in performance and capabilities without modifying the library's core routines. The implementation of template matching scores is modular and provides developers with a flexible framework for rapid prototyping. Furthermore, pyTME supports a unique callback capability through analyzers, which allows for injection of custom code, enabling real-time processing and manipulation of results.

PyTME includes a graphical user interface that provides simplified mask creation, interactive filter exploration, result visualization, and manual refinement capabilities. This GUI serves as an accessible entry point to the library's core functionalities, allowing users to efficiently interact with and analyze their data.

Finally, pyTME offers specialized tools for cryogenic electron microscopy data, such as wedge masks, CTF correction, as well as means for handling structural data.

Running into bugs or missing a feature? Help us improve the project by opening an issue.

Installation

We recommend installation using one of the following methods

Method Command
PyPi pip install pytme
Source pip install git+https://github.com/KosinskiLab/pyTME
Docker docker build -t pytme -f docker/Dockerfile_GPU .

You can find alternative installation methods in the documentation.

User Guide

Learn how to get started with

How to Cite

If you used PyTME in your research, please cite the corresponding publication.

@article{Maurer:2024aa,
    author = {Maurer, Valentin J. and Siggel, Marc and Kosinski, Jan},
    journal = {SoftwareX},
    pages = {101636},
    title = {PyTME (Python Template Matching Engine): A fast, flexible, and multi-purpose template matching library for cryogenic electron microscopy data},
    volume = {25},
    year = {2024}
}

Metadata

Release files for pytme 0.3.5

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

Source distribution (sdist)

Source distribution for pytme 0.3.5
File Size Uploaded
pytme-0.3.5.tar.gz 5.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for pytme 0.3.5
File Interpreter ABI Platform
pytme-0.3.5-cp311-cp311-macosx_26_0_arm64.whl CPython 3.11 CPython 3.11 macOS 26.0+ ARM64 Details

Total release size: 13.0 MB

Release files / pytme-0.3.5.tar.gz

Download URL pytme-0.3.5.tar.gz
Size 5.9 MB
Tags Source
SHA-256 checksum
How to use checksums
0387fb13c11c7a4e00dbe69033ec4b8b291e59ce49f7e67a49863d0708c75d85
BLAKE2b-256 checksum
How to use checksums
f6f322f02e18f7436cff1e1103eacbbc5df928aaf79acbd830e6f94f7266c442
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.11.12 Darwin/25.5.0

Release files / pytme-0.3.5-cp311-cp311-macosx_26_0_arm64.whl

Download URL pytme-0.3.5-cp311-cp311-macosx_26_0_arm64.whl
Size 7.1 MB
Tags CPython 3.11 macOS 26.0+ ARM64
SHA-256 checksum
How to use checksums
efa6ff9b0f3b0a5e1b241fab709f168541e69c1ce26eebaa6ca4ce5b238f8f35
BLAKE2b-256 checksum
How to use checksums
406911f93520492f4af5f4371cf0bb2018d9680bec09bed833dc0c48e631d096
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.11.12 Darwin/25.5.0

Release history Release notifications | RSS feed

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