Skip to content

BREAK: use active convention for Lorentz boosts - #534

Draft
redeboer wants to merge 1 commit into
mainfrom
active-lorentz-boosts
Draft

redeboer wants to merge 1 commit into
mainfrom
active-lorentz-boosts

Conversation

@redeboer

Copy link
Copy Markdown
Member

⚠️ Interface changes

All Lorentz boost and rotation matrices in ampform.kinematics.lorentz now follow the active convention of the helicity formalism, and the module docstring documents it. The rotation matrices were already active, so only the boosts change sign.

Call Old meaning New meaning
BoostZMatrix(beta) boost into a frame moving with $\beta$ give the vector the velocity $\beta$
BoostMatrix(p) boost into the rest frame of $p$ give the vector the velocity of $p$

To reach the rest frame of $p$, use BoostZMatrix(-beta) or BoostMatrix(NegativeMomentum(p)). compute_helicity_angles(), compute_boost_chain(), compute_wigner_rotation_matrix() and the kinematics notebook are adapted, so helicity angles, Wigner angles, and amplitude models are unchanged.

@redeboer redeboer added the ⚠️ Interface Breaking changes to the API label Nov 12, 2026
@redeboer
redeboer force-pushed the active-lorentz-boosts branch from c82564b to 0c6d6b3 Compare November 13, 2026 15:14
@redeboer
redeboer force-pushed the active-lorentz-boosts branch from ceee4e0 to 3c2b39e Compare November 13, 2026 15:17

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

⚠️ Interface Breaking changes to the API

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Use one documented convention for Lorentz boost and rotation matrices

1 participant