# Lorentz Invariant Phase Space
[![CI Lint](https://github.com/GDeLaurentis/lips/actions/workflows/ci_lint.yml/badge.svg)](https://github.com/GDeLaurentis/lips/actions/workflows/ci_lint.yml)
[![CI Test](https://github.com/GDeLaurentis/lips/actions/workflows/ci_test.yml/badge.svg)](https://github.com/GDeLaurentis/lips/actions/workflows/ci_test.yml)
[![Coverage](https://img.shields.io/badge/Coverage-81%25-greenyellow?labelColor=2a2f35)](https://github.com/GDeLaurentis/lips/actions)
[![Docs](https://github.com/GDeLaurentis/lips/actions/workflows/cd_docs.yml/badge.svg?label=Docs)](https://gdelaurentis.github.io/lips/)
[![PyPI](https://img.shields.io/pypi/v/lips?label=PyPI)](https://pypi.org/project/lips/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/lips.svg?label=PyPI%20downloads)](https://pypi.org/project/lips/)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/GDeLaurentis/lips/HEAD)
[![Python](https://img.shields.io/pypi/pyversions/lips?label=Python)](https://pypi.org/project/lips/)
`Lips` is a Python 3 library that provides a phase-space generator and manipulator that is tailored to the needs of modern theoretical calculations in quantum field theory. At present, the package is designed to handle the kinematics of scattering processes involving an arbitrary number of massless particles. Use cases include:
1) generation of phase-space points over complex numbers ($\mathbb{C}$), finite fields ($\mathbb{F}_p$), and $p$-adic numbers ($\mathbb{Q}_p$);
2) generation of spinor strings representing possible kinematic singularities (related to letter of the symbol alphabet);
3) on-the-fly evaluation of arbitrary spinor-helicity expressions in any of the above mentioned fields;
4) construction of special kinematic configurations, with efficient, hard-coded solutions available up to codimension 2;
5) algebro-geometric analysis of irreducible varieties in kinematic space.
## Installation
The package is available on the [Python Package Index](https://pypi.org/project/lips/)
```console
pip install lips
```
Alternativelty, it can be installed by cloning the repo
```console
git clone https://github.com/GDeLaurentis/lips.git path/to/repo
pip install -e path/to/repo
```
## Requirements
`pip` will automatically install the required packages, which are
```
numpy, sympy, mpmath, pyadic
```
The `algebraic_gemetry` submodule requires [Singular](https://www.singular.uni-kl.de/) through the Python interface [syngular](https://github.com/GDeLaurentis/syngular). Singular needs to be installed manually (e.g. `apt-get install singular`).
## Testing
```
pytest --cov lips/ --cov-report html tests/ --verbose
```
## Citation
If you found this library useful, please consider citing it
```bibtex
@inproceedings{DeLaurentis:2023qhd,
author = "De Laurentis, Giuseppe",
title = "{Lips: $p$-adic and singular phase space}",
booktitle = "{21th International Workshop on Advanced Computing and Analysis Techniques in Physics Research}: {AI meets Reality}",
eprint = "2305.14075",
archivePrefix = "arXiv",
primaryClass = "hep-th",
reportNumber = "PSI-PR-23-14",
month = "5",
year = "2023"
}
@phdthesis{DeLaurentis:2020xar,
author = "De Laurentis, Giuseppe",
title = "{Numerical techniques for analytical high-multiplicity scattering amplitudes}",
school = "Durham U.",
year = "2020"
}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/GDeLaurentis/lips",
"name": "lips",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "lips, Lorentz Invariant Phase Space, Spinor Helicity",
"author": "Giuseppe De Laurentis",
"author_email": "g.dl@hotmail.it",
"download_url": "https://files.pythonhosted.org/packages/ea/31/076f9a7fe04986a13653bbab06d0183f72eb5fae9deac80e88a1c7ef1205/lips-0.4.1.tar.gz",
"platform": null,
"description": "# Lorentz Invariant Phase Space\n\n[![CI Lint](https://github.com/GDeLaurentis/lips/actions/workflows/ci_lint.yml/badge.svg)](https://github.com/GDeLaurentis/lips/actions/workflows/ci_lint.yml)\n[![CI Test](https://github.com/GDeLaurentis/lips/actions/workflows/ci_test.yml/badge.svg)](https://github.com/GDeLaurentis/lips/actions/workflows/ci_test.yml)\n[![Coverage](https://img.shields.io/badge/Coverage-81%25-greenyellow?labelColor=2a2f35)](https://github.com/GDeLaurentis/lips/actions)\n[![Docs](https://github.com/GDeLaurentis/lips/actions/workflows/cd_docs.yml/badge.svg?label=Docs)](https://gdelaurentis.github.io/lips/)\n[![PyPI](https://img.shields.io/pypi/v/lips?label=PyPI)](https://pypi.org/project/lips/)\n[![PyPI Downloads](https://img.shields.io/pypi/dm/lips.svg?label=PyPI%20downloads)](https://pypi.org/project/lips/)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/GDeLaurentis/lips/HEAD)\n[![Python](https://img.shields.io/pypi/pyversions/lips?label=Python)](https://pypi.org/project/lips/)\n\n\n`Lips` is a Python 3 library that provides a phase-space generator and manipulator that is tailored to the needs of modern theoretical calculations in quantum field theory. At present, the package is designed to handle the kinematics of scattering processes involving an arbitrary number of massless particles. Use cases include: \n \n1) generation of phase-space points over complex numbers ($\\mathbb{C}$), finite fields ($\\mathbb{F}_p$), and $p$-adic numbers ($\\mathbb{Q}_p$);\n2) generation of spinor strings representing possible kinematic singularities (related to letter of the symbol alphabet);\n3) on-the-fly evaluation of arbitrary spinor-helicity expressions in any of the above mentioned fields;\n4) construction of special kinematic configurations, with efficient, hard-coded solutions available up to codimension 2;\n5) algebro-geometric analysis of irreducible varieties in kinematic space.\n\n## Installation\nThe package is available on the [Python Package Index](https://pypi.org/project/lips/)\n```console\npip install lips\n```\nAlternativelty, it can be installed by cloning the repo\n```console\ngit clone https://github.com/GDeLaurentis/lips.git path/to/repo\npip install -e path/to/repo\n```\n\n## Requirements\n`pip` will automatically install the required packages, which are\n```\nnumpy, sympy, mpmath, pyadic\n```\nThe `algebraic_gemetry` submodule requires [Singular](https://www.singular.uni-kl.de/) through the Python interface [syngular](https://github.com/GDeLaurentis/syngular). Singular needs to be installed manually (e.g. `apt-get install singular`).\n\n## Testing\n\n```\npytest --cov lips/ --cov-report html tests/ --verbose\n```\n\n\n## Citation\n\nIf you found this library useful, please consider citing it\n\n\n```bibtex\n@inproceedings{DeLaurentis:2023qhd,\n author = \"De Laurentis, Giuseppe\",\n title = \"{Lips: $p$-adic and singular phase space}\",\n booktitle = \"{21th International Workshop on Advanced Computing and Analysis Techniques in Physics Research}: {AI meets Reality}\",\n eprint = \"2305.14075\",\n archivePrefix = \"arXiv\",\n primaryClass = \"hep-th\",\n reportNumber = \"PSI-PR-23-14\",\n month = \"5\",\n year = \"2023\"\n}\n\n@phdthesis{DeLaurentis:2020xar,\n author = \"De Laurentis, Giuseppe\",\n title = \"{Numerical techniques for analytical high-multiplicity scattering amplitudes}\",\n school = \"Durham U.\",\n year = \"2020\"\n}\n```\n\n\n",
"bugtrack_url": null,
"license": "GNU General Public License v3.0",
"summary": "Lorentz Invariant Phase Space",
"version": "0.4.1",
"project_urls": {
"Documentation": "https://gdelaurentis.github.io/lips/",
"Download": "https://github.com/GDeLaurentis/lips/archive/v0.4.1.tar.gz",
"Homepage": "https://github.com/GDeLaurentis/lips",
"Issues": "https://github.com/GDeLaurentis/lips/issues"
},
"split_keywords": [
"lips",
" lorentz invariant phase space",
" spinor helicity"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "83359323808d1bb2ff3fc596d546e2146041e226517bee1ed7ca56653b90e7ba",
"md5": "7d694f97a45947547ba9c9a63532df86",
"sha256": "c825fef49f9e421e6ee2a7c8f0d7e7682c945dff6fa676065162a575ba6fca3b"
},
"downloads": -1,
"filename": "lips-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7d694f97a45947547ba9c9a63532df86",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 98292,
"upload_time": "2024-06-07T10:09:18",
"upload_time_iso_8601": "2024-06-07T10:09:18.266438Z",
"url": "https://files.pythonhosted.org/packages/83/35/9323808d1bb2ff3fc596d546e2146041e226517bee1ed7ca56653b90e7ba/lips-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ea31076f9a7fe04986a13653bbab06d0183f72eb5fae9deac80e88a1c7ef1205",
"md5": "310f73bd01baea095b330fa2d93dcf89",
"sha256": "3ec8235eaad8916a08829fc1aa2b1e5fdd6f510a3991c717d09a26e9e1638fbf"
},
"downloads": -1,
"filename": "lips-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "310f73bd01baea095b330fa2d93dcf89",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 93180,
"upload_time": "2024-06-07T10:09:20",
"upload_time_iso_8601": "2024-06-07T10:09:20.165549Z",
"url": "https://files.pythonhosted.org/packages/ea/31/076f9a7fe04986a13653bbab06d0183f72eb5fae9deac80e88a1c7ef1205/lips-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-07 10:09:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GDeLaurentis",
"github_project": "lips",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "lips"
}