Skip to content

warpem/miss-alignment

Repository files navigation

miss-alignment

License PyPI Python Version CI

260_etomo_vs_3x3

Better alignment = cleaner tomograms. GIF shows a denoised reconstruction after patch tracking alignment and miss-alignment.

Installation

Installation is limited at the moment to a specific python, CUDA, and torch version. This might be fixed at some point in the future. For now, its easiest to set everything up in a conda environment.

First create an environment called miss-alignment with cuda-toolkit 12.9 and activate it:

conda create -n miss-alignment -c conda-forge python=3.11 cuda-toolkit=12.9 -y
conda activate miss-alignment

We need to fix some GPU dependencies for accelerated reconstruction:

python -m pip install torch==2.8.0 numpy
python -m pip install torch-projectors --index-url https://warpem.github.io/torch-projectors/cu129/simple/

Important

If your GPU's have the Blackwell-architecture make sure to install at least v0.11 of torch-projectors.

Finally install miss-alignment with this command:

python -m pip install miss-alignment

Check that the CLI shows up with:

miss-alignment --help

How to run?

See the docs/ folder for some barebones instructions. This will be improved soon.

Changelog

A full list of changes per release is available on the GitHub Releases page.

Citation

Chaillet, M.L., van Loenhout, J., Leung, M.R., Burt, A., and Tegunov, D. (2026) MissAlignment Teaches Itself Better Cryo-ET Tilt-Series Alignment by Making It Worse. bioRxiv. https://doi.org/10.64898/2026.04.29.721716

About

She knows a good alignment when she sees one

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors