Convert images of beads into XYZ positions
Project description
MagTrack is a free open-source Python library for tracking symmetric beads in single-molecule magnetic tweezers experiments.
- Sub-pixel XYZ coordinates
- GPU accelerated (optional, requires a CUDA-capable GPU)
- Python notebook included with examples
- Documented, tested, and benchmarked
- Only depends on NumPy, SciPy, and CuPy
- Runs on Windows, macOS, and Linux
- Easy installation with pip
Try a demo in a Google Colab notebook
⏳ Install
Get started with MagTrack by following the installation instructions.
⚒ Usage
import magtrack
# Run the full default XYZ pipeline
x, y, z, profiles = magtrack.stack_to_xyzp(stack)
# Or make your own pipeline from algorithms you prefer
x, y = magtrack.center_of_mass(stack)
x, y = magtrack.auto_conv_sub_pixel(stack, x, y)
profiles = magtrack.fft_profile(stack)
...
More Examples
You can see more examples of how to use MagTrack in this notebook.
Try it out with Google Colab.
Or you can download it and run it on your computer with Jupyter Notebook.
📖 Documentation
View the full guide to MagTrack at magtrack.readthedocs.io
🔬 Live Microscope Control and Acquisition
You can use MagTrack for live video processes using our sister project MagScope.
💬 Support
Report issues and make requests on the GitHub issue tracker.
Having trouble? Need help? Have suggestions? Want to contribute?
Email us at magtrackandmagscope@gmail.com
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file magtrack-0.7.7.tar.gz.
File metadata
- Download URL: magtrack-0.7.7.tar.gz
- Upload date:
- Size: 70.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
775c2331862a9bf0b7fc26f971785cedc989c51fdfd6f5b9295129e3a7b598ca
|
|
| MD5 |
c0003d9141dea563b79ec579be5f32ab
|
|
| BLAKE2b-256 |
8b7cf91a43cc397de049c2b371f72107569f18d8ccb2e5a64824a99fe940ad0f
|
Provenance
The following attestation bundles were made for magtrack-0.7.7.tar.gz:
Publisher:
publish-to-pypi.yml on 7jameslondon/MagTrack
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
magtrack-0.7.7.tar.gz -
Subject digest:
775c2331862a9bf0b7fc26f971785cedc989c51fdfd6f5b9295129e3a7b598ca - Sigstore transparency entry: 1258126106
- Sigstore integration time:
-
Permalink:
7jameslondon/MagTrack@5d4076d90d6bb19a4ccb91b91f1d6b63486493c3 -
Branch / Tag:
refs/tags/v0.7.7 - Owner: https://github.com/7jameslondon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@5d4076d90d6bb19a4ccb91b91f1d6b63486493c3 -
Trigger Event:
release
-
Statement type:
File details
Details for the file magtrack-0.7.7-py3-none-any.whl.
File metadata
- Download URL: magtrack-0.7.7-py3-none-any.whl
- Upload date:
- Size: 80.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
472dc3bb4e38ebaeb7b7441a1ca7259725d80d96c3d92965f5cdda80c9781056
|
|
| MD5 |
53bd33df76ad2e0cd450e8e93786072b
|
|
| BLAKE2b-256 |
a1b9d1135a4a551404264f80260d41aaea06e3040c0cc3d9c699e8c2281aac4d
|
Provenance
The following attestation bundles were made for magtrack-0.7.7-py3-none-any.whl:
Publisher:
publish-to-pypi.yml on 7jameslondon/MagTrack
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
magtrack-0.7.7-py3-none-any.whl -
Subject digest:
472dc3bb4e38ebaeb7b7441a1ca7259725d80d96c3d92965f5cdda80c9781056 - Sigstore transparency entry: 1258126270
- Sigstore integration time:
-
Permalink:
7jameslondon/MagTrack@5d4076d90d6bb19a4ccb91b91f1d6b63486493c3 -
Branch / Tag:
refs/tags/v0.7.7 - Owner: https://github.com/7jameslondon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@5d4076d90d6bb19a4ccb91b91f1d6b63486493c3 -
Trigger Event:
release
-
Statement type: