Skip to main content

Quantum Number Conservation Rules

10.5281/zenodo.5526360 License

PyPI package Conda package Supported Python versions

Binder Google Colab Open in Visual Studio Code

Documentation pre-commit.ci status CI Type-checked with mypy Test coverage Spelling checked code style: prettier Ruff uv

QRules is a Python package for validating and generating particle reactions using quantum number conservation rules. The user only has to provide a certain set of boundary conditions (initial and final state, allowed interaction types, expected decay topologies, etc.). QRules will then span the space of allowed quantum numbers over all allowed decay topologies and particle instances that correspond with the sets of allowed quantum numbers it has found.

The resulting state transition objects are particularly useful for amplitude analysis / Partial Wave Analysis as they contain all information (such as expected masses, widths, and spin projections) that is needed to formulate an amplitude model.

Visit qrules.rtfd.io for more information!

For an overview of upcoming releases and planned functionality, see here.

Available features

  • Input: Particle database
    • Source of truth: PDG
    • Predefined particle list file
    • Option to overwrite and append with custom particle definitions
  • State transition graph
    • Feynman graph like description of the reactions
    • Visualization of the decay topology
  • Conservation rules
    • Open-closed design
    • Large set of predefined rules
      • Spin/Angular momentum conservation
      • Quark and Lepton flavor conservation (incl. isospin)
      • Baryon number conservation
      • EM-charge conservation
      • Parity, C-Parity, G-Parity conservation
      • Mass conservation
    • Predefined sets of conservation rules representing Strong, EM, Weak interactions

Contribute

See CONTRIBUTING.md

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qrules-0.10.9.tar.gz (317.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qrules-0.10.9-py3-none-any.whl (82.3 kB view details)

Uploaded Python 3

File details

Details for the file qrules-0.10.9.tar.gz.

File metadata

  • Download URL: qrules-0.10.9.tar.gz
  • Upload date:
  • Size: 317.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for qrules-0.10.9.tar.gz
Algorithm Hash digest
SHA256 fbd1e4e0d86c6eea371c95a2e62732dc73cba45afb4e4d657e123a8017f1bc9c
MD5 1e9e327af7f31ac9ab26e5458d29ef43
BLAKE2b-256 9bc083f770f8dfbdb02fcf17858f41f332addeebcca11b95bea634e2f7bc0b17

See more details on using hashes here.

Provenance

The following attestation bundles were made for qrules-0.10.9.tar.gz:

Publisher: cd.yml on ComPWA/qrules

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qrules-0.10.9-py3-none-any.whl.

File metadata

  • Download URL: qrules-0.10.9-py3-none-any.whl
  • Upload date:
  • Size: 82.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for qrules-0.10.9-py3-none-any.whl
Algorithm Hash digest
SHA256 3fd00341a1711592be414b31293b72106911462d403f41ca848b586394353443
MD5 db5dc0ddaf587ae98e102bcc61417fa6
BLAKE2b-256 0653be20af6713c2d498cfa5be89aa004933bd199ed63694417fac9d6f57523f

See more details on using hashes here.

Provenance

The following attestation bundles were made for qrules-0.10.9-py3-none-any.whl:

Publisher: cd.yml on ComPWA/qrules

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page