Skip to content

FEAT: formulate serialized coordinate maps - #223

Open
redeboer wants to merge 1 commit into
feat/213-complete-deserializationfrom
feat/214-kinematic-map
Open

FEAT: formulate serialized coordinate maps#223
redeboer wants to merge 1 commit into
feat/213-complete-deserializationfrom
feat/214-kinematic-map

Conversation

@redeboer

@redeboer redeboer commented Aug 5, 2026

Copy link
Copy Markdown
Member

Closes #214

✨ New features

  • Add formulate_kinematic_map(), which converts a serialized invariant-mass/helicity-angle coordinate into a complete symbolic mapping for sigma1, sigma2, and sigma3.
  • Derive the mapping in closed form from the Kallen function without invoking sympy.solve() during evaluation.
  • Return an immutable mapping and require explicit distribution selection when a workspace contains multiple distributions.
  • Reject ambiguous coordinate definitions and helicity-angle orientations outside the supported cyclic convention.

formulate_kinematic_map is re-exported from ampform_dpd.io.serialization and remains independent of numerical backends.

🖱️ Developer experience

  • Cover forward/inverse consistency at a serialized reference point, multi-distribution selection, and invalid coordinate metadata.

📝 Documentation

  • Document that the helicity angle is measured between particle i and spectator k in the (ij) isobar rest frame for cyclic pairs (1, 2), (2, 3), and (3, 1).

Squash commit messages

* DOC: document cyclic helicity-angle convention
* DX: test kinematic map against scattering angle

@redeboer redeboer added this to the 0.4.2 milestone Aug 5, 2026
@redeboer redeboer added the ✨ Feature New feature added to the package label Aug 5, 2026
@redeboer
redeboer force-pushed the feat/214-kinematic-map branch from 480b703 to a267412 Compare August 5, 2026 20:29
@redeboer
redeboer force-pushed the feat/214-kinematic-map branch from a267412 to da696d9 Compare August 5, 2026 20:36
@redeboer redeboer self-assigned this Aug 5, 2026
@redeboer redeboer added 🖱️ DX Improvements to the Developer Experience 📝 Docs Improvements or additions to documentation labels Aug 5, 2026
@redeboer
redeboer force-pushed the feat/214-kinematic-map branch from da696d9 to 7d786c6 Compare August 6, 2026 04:50
@redeboer
redeboer force-pushed the feat/214-kinematic-map branch from 7d786c6 to 833547f Compare August 6, 2026 04:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📝 Docs Improvements or additions to documentation 🖱️ DX Improvements to the Developer Experience ✨ Feature New feature added to the package

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Formulate symbolic mappings from serialized coordinates to invariants

1 participant