Python Template Matching Engine (PyTME)
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
- Installation
- Template matching Find your template of interest.
- Postprocessing Analyze template matching results and downstream integrations.
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.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pytme-0.3.6.tar.gz | 5.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pytme-0.3.6-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.6.tar.gz
| Download URL | pytme-0.3.6.tar.gz |
|---|---|
| Size | 5.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9b1d9bca8585798a63e4154083e3a9c4966d61e6484a6302a9fed2b3ccbed126
|
|
BLAKE2b-256 checksum How to use checksums |
6aee624b94a6d068a7f15dd684fb5a9be48076ccf2efbdba224cbcd69c538ebf
|
| 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.6-cp311-cp311-macosx_26_0_arm64.whl
| Download URL | pytme-0.3.6-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 |
46ac35753c400959d802cb1db7b485a28a8b8d44a8df269e1d450760124224c7
|
|
BLAKE2b-256 checksum How to use checksums |
0108e371f80354d898d49aa16b6fc9879485f35cc9b4f55a406ddf5fbfeabb77
|
| 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
|