torch-refine-tilt-axis-angle

Tilt-axis angle optimization for tilt series using common lines.

Overview

torch-refine-tilt-axis-angle provides an implementation for finding the in plane rotation for a tilt-series that aligns the tilt axis with the y-axis. This is done by extracting lines from the 2D Fourier transform of the tilt-series images and minimizing the mean squared error between them, i.e. the common lines. It makes use of the pytorch LBFGS optimizer to find the minimum.

Installation

pip install torch-refine-tilt-axis-angle

Usage

import torch
from torch_refine_tilt_axis_angle import refine_tilt_axis_angle

# Load or create your tilt series
# tilt_series shape: (batch, height, width) - batch is number of tilt images
# Example: tilt_series with shape (61, 512, 512) - 61 tilt images of 512x512 pixels
tilt_series = torch.randn(61, 512, 512)

# Specify an initial guess for the tilt axis angle (the default is 0.0)
# This can be the value from an MDOC file.
initial_tilt_axis_angle = 50.0

# Run tilt axis angle refinement.
new_tilt_axis_angle = refine_tilt_axis_angle(
    tilt_series=tilt_series,
    tilt_axis_angle=initial_tilt_axis_angle,
    # grid_points=1,  # optionally increase the spline grid points (default 1)
    # return_single_angle=False,  # optionally write out an angle for each image 
)

Use uv to run an example with simulated data and visualize the results.

uv run examples/simulate_tilt_axis_refinement.py

License

This package is distributed under the BSD 3-Clause License.

Download files

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

Source Distribution

torch_refine_tilt_axis_angle-0.6.3rc3.tar.gz (7.0 kB view details)

Uploaded Mar 19, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

torch_refine_tilt_axis_angle-0.6.3rc3-py3-none-any.whl (5.8 kB view details)

Uploaded Mar 19, 2026 Python 3

File details

Details for the file torch_refine_tilt_axis_angle-0.6.3rc3.tar.gz.

File metadata

Download URL: torch_refine_tilt_axis_angle-0.6.3rc3.tar.gz
Upload date: Mar 19, 2026
Size: 7.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for torch_refine_tilt_axis_angle-0.6.3rc3.tar.gz
Algorithm	Hash digest
SHA256	`f3b38196553f94454ff8f11c2f52a9181df838222d1cfbabf0b55d42f7ac11fa`
MD5	`dd32fdf049ebc3fe01a868e8c54d8c40`
BLAKE2b-256	`eaa91c2ed16908d679dd6c5167f5c0aecf5dc5e189c77557e9c2d61e0b402c4a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for torch_refine_tilt_axis_angle-0.6.3rc3.tar.gz:

Publisher: deploy.yml on teamtomo/teamtomo

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: torch_refine_tilt_axis_angle-0.6.3rc3.tar.gz
- Subject digest: f3b38196553f94454ff8f11c2f52a9181df838222d1cfbabf0b55d42f7ac11fa
- Sigstore transparency entry: 1137084379
- Sigstore integration time: Mar 19, 2026
Source repository:
- Permalink: teamtomo/teamtomo@594abe5bba4453f706086d2ae22cd0f20bcbf74e
- Branch / Tag: refs/tags/torch-refine-tilt-axis-angle@v0.6.3rc3
- Owner: https://github.com/teamtomo
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: deploy.yml@594abe5bba4453f706086d2ae22cd0f20bcbf74e
- Trigger Event: release