Ampform-dpd

_See all documentation for this version [here](https://ampform-dpd.rtfd.io/en/0.2.1)._

✨ New features

- implement model deserialization (132)

⚠️ Enhancements and optimizations

- lower momentum subscripts in LaTeX rendering (124)
- formulate amplitudes for existing subsystems only (127)

⚠️ API changes

- remove `ampform_dpd.io.perform_cached_doit()` alias (125)
- remove redundant `aslatex` dispatches (126)

⚠️ Changes that may affect behavior

- formulate amplitudes for existing subsystems only (127)

🐛 Bug fixes

- set correct return type for masses (128)
- allow `Particle`+`State` in `as_markdown_table()` (129)
- install `pip` packages on RTD with new `uv` install syntax (134)

📝 Documentation

- remove redundant `aslatex` dispatches (126)
- implement model deserialization (132)

🔨 Maintenance

- remove redundant `aslatex` dispatches (126)
- update pip constraints and pre-commit (130)
- upgrade to AmpForm v0.15.3 (131)

🖱️ Developer Experience

- install `pip` packages on RTD with new `uv` install syntax (134)

_The full changelog as commits can be found [here](https://github.com/ComPWA/ampform-dpd/compare/0.2.0...0.2.1)._

✨ New features

- Describe initial and final state particles with `State` class (116)
- Handle equal particles in final state (108)

⚠️ Enhancements and optimizations

- Group decay node in LaTeX rendering of `ThreeBodyDecayChain`s (114)

⚠️ API changes

- Initial and final states in `ThreeBodyDecayChain`s are now defined with a `State` class (116). This should affect the API too much, as it inherits from `Particle`, which was used initially for initial and final state particles.

📝 Documentation

- Added $\Xi_b^- \to p K^- K^-$ example notebook (117) for testing 108
- Host documentation on Read the Docs (119 and 122)

_The full changelog as commits can be found [here](https://github.com/ComPWA/ampform-dpd/compare/0.1.6...0.1.7)._

✨ New features

- Implement adapter functions for QRules (107, 111, and 112)
See the [`ampform_dpd.adapter.qrules`](https://compwa.github.io/ampform-dpd/api/ampform_dpd.adapter.qrules.html) module
- Define more dynamics expression classes: `RelativisticBreitWigner` and `FormFactor` (113)

🐛 Bug fixes

- Set non-negative assumption on masses (106)
- Removed `IsobarNode` argument checks (110)

📝 Documentation

- Write Λ_c in notebook title instead of Λc (104)
- Render particle name in Markdown tables as inline code (105)
- Use new `invariants` and `masses` attributes in example notebooks (115)

🖱️ Developer Experience

- Type hints are now also linted with MyPy, which helped improving some of the type hints (109)

_The full changelog as commits can be found [here](https://github.com/ComPWA/ampform-dpd/compare/0.1.6...0.1.7)._

✨ New features
- Implement `AmplitudeModel.masses` and `.invariants` attributes from https://github.com/ComPWA/polarimetry/issues/336 (#96)

⚠️ API changes
- `formulate_polarimetry()` has been removed. Use [ComPWA/polarimetry](https://github.com/ComPWA/polarimetry) instead (#96)
- Removed `perform_cached_doit()` function. Use [`ampform.sympy.perform_cached_doit()`](https://ampform.readthedocs.io/0.14.4/api/ampform.sympy.html#ampform.sympy.perform_cached_doit) instead (97)

⚠️ Enhancements and optimizations
- Caches are now written to user cache directory by default (98)
- Verified installation on Python 3.11 and 3.12 (47 and 86)
- Removed `tensorflow` pinning for Python 3.11 (64)

⚠️ Changes that may affect behavior
- Dropped Python 3.7 support (84)

🐛 Bug fixes

- render expression in comparison widget (57)
- improve documentation layout (65)
- move bibliography to isolated page (67)
- improve documentation sidebar (72)
- use `pypa/gh-action-pypi-publish` directly (99)

📝 Documentation

- Added toggle buttons for showing expressions (71)
- add spinless final state comparison (49)
- render expression in comparison widget (57)
- add J/ψ → K⁰Σ⁺p̅ AmpForm comparison (58)
- visualize and match angular distributions (60)
- render coupling sliders as `ToggleButton` (61)
- add comparison for J/ψ → φ π⁺ π⁻ (63)
- improve documentation layout (65)
- move bibliography to isolated page (67)
- add title and logo to website (68)
- move comparison notebooks to separate folder (69)
- show selected resonances as plot title (70)
- add toggle buttons for showing expressions (71)
- improve documentation sidebar (72)
- update links to compwa.github.io (91)


🖱️ Developer Experience

- Switched to Ruff as linter (76)
- colorize `sphinx-build` output (56)
- enable language navigation on Jupyter Lab (77)
- install Ruff and Git in Jupyter Lab (87)
- use `pypa/gh-action-pypi-publish` directly (99)

_The full changelog as commits can be found [here](https://github.com/ComPWA/ampform-dpd/compare/0.1.5...0.1.6)._

🐛 Bug fixes

- Dynamics lineshape are now non-resonant by default (42)

📝 Documentation

- Added phase of the particle-2 convention (40)

🖱️ Developer Experience

- GitHub workflows are now outsourced to ComPWA/actions (41 and 43)

_The full changelog as commits can be found [here](https://github.com/ComPWA/ampform-dpd/compare/0.1.4...0.1.5)._

_See all documentation for the latest version [here](https://compwa.github.io/ampform-dpd)._

✨ New features

- Add option to use decay LS-couplings instead of helicity couplings on the production and/or decay node (32)

📝 Documentation

- Main DPD formulas from [JPAC:2019ufm](https://journals.aps.org/prd/abstract/10.1103/PhysRevD.101.034033) are sumarised on the main page (#37)