Phasespace

=====================

Add support for Python 3.12, drop support for 3.8

Major Features and Improvements
-------------------------------

- integrating `vector <https://vector.readthedocs.io/en/latest/index.html>`_ support for ``generate``: ``boost_to`` can be a Momentum Lorentz vector and return the boosted particles as a vector using ``as_vectors=True``.


Requirement changes
-------------------

===================

Add support for Python 3.11, drop support for 3.7

===================

Requirement changes
-------------------
- upgrade to zfit >= 0.10.0 and zfit-physics >= 0.3.0
- pinning uproot and awkward to ~4 and ~1, respectively

====================

Upgraded Python and TensorFlow version.

Added ``tf`` and ``tensorflow`` extra to requirements. If you intend to use
phasespace with TensorFlow in the future (and not another backend like numpy or JAX),
make sure to always install with ``phasespace[tf]``.

Requirement changes
-------------------
- upgrade to TensorFlow >= 2.7
- Python from 3.7 to 3.10 is now supported

====================

Major Features and Improvements
-------------------------------
- Improved GenMultiDecay to have better control on the decay mass of non-stable particles.
- Added a `particle_model_map` argument to the `GenMultiDecay` class. This is a
dict where the key is a particle name and the value is a mass function name.
The feature can be seen in the
`GenMultiDecay Tutorial <https://github.com/zfit/phasespace/blob/master/docs/GenMultiDecay_Tutorial.ipynb>`_.

===================


Major Features and Improvements
-------------------------------
- add support to generate from a DecayChain using
`the decaylanguage <https://github.com/scikit-hep/decaylanguage>`_ package from Scikit-HEP.
This is in the new subpackage "fromdecay" and can be used by installing the extra with
``pip install phasespace[fromdecay]``.


Requirement changes
-------------------
- drop Python 3.6 support


Thanks
------
- to Simon Thor for contributing the ``fromdecay`` subpackage.