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.8.tar.gz (321.6 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.8-py3-none-any.whl (82.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qrules-0.10.8.tar.gz
  • Upload date:
  • Size: 321.6 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.8.tar.gz
Algorithm Hash digest
SHA256 5a348e57eb051831222c220ddf9cf77ef7e6b99c561109e13af722eb6b404bb7
MD5 221f9b67fe1c0430a758666f712de77d
BLAKE2b-256 3a27b1fa7950c7d053ba65e37b6b27870f3814b85d14e42bcd9dec5a4ca1d3fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for qrules-0.10.8.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.8-py3-none-any.whl.

File metadata

  • Download URL: qrules-0.10.8-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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 5fac27c409ff7b8d5a8696922dbff69c032db2ef180cba13c94c6f5b22e3b31d
MD5 72523bc363bd250b7374445b62920e30
BLAKE2b-256 137e6b016f29e59c75aca3e2a231097210ad432648e0b8d51a75ae7dc2de5a7b

See more details on using hashes here.

Provenance

The following attestation bundles were made for qrules-0.10.8-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