Skip to main content

A formalism for computing DVCS cross sections using the BKM10 approach.

Project description

The BKM10 formalism as a Python library.

Description:

A Python library to help nuclear physicists use the BKM formalism in predicting cross-section, asymmetries, and comparing GPD models.

Installation:

Available on PyPI. To install, one can run

pip install bkm10_lib

You will need Python 3 and pip.

Technicalities:

There are three different classes at play in this library: the main one, DifferentialCrossSection; the dataclass, BKM10Inputs; and another dataclass called CFFInputs. DifferentialCrossSection requires a million different inputs.

The Four-Fold Cross Section:

What we are numerically calculating is a four-fold (meaning, we need to do four integrals) cross section. We need to integrate over four variables: $Q^{2}$ , $x_{B}$ , $t$, $\phi$ . By the way, the first three quantities are called the kinematics, and $\phi$ is an azimuthal angle that is measured in a chosen reference frame. However, the function actually requires a bit more detail. It is a function of several different things -- schematically, we express this as:

$$d^{4}\sigma \left(\lambda, \Lambda; k, Q^{2} , x_{B} , t , \phi; \mathcal{H}, \mathcal{E}, \tilde{\mathcal{H}}, \tilde{\mathcal{E}} \right).$$

Polarization Settings:

The BKM10 formalism uses $\lambda$ to refer to the lepton beam helicity. (Note: $\lambda \in { -1, +1 }$ in this formalism!) $\Lambda$ refers to the target polarization. (In the formalism, $\Lambda \in { -1/2, +1/2 }$.)

Kinematics:

In order to evaluate the cross-section, you need to specify four numbers that correspond to the kinematic settings (experimental kinematics). These numbers are: $k$, the beam energy; $Q^{2}$, the virtuality of the photon probing the nucleon's partons; $x_{B}$, Bjorken $x$; and $t$, the (squared) momentum transfer to the hadron. Use the dataclass BKM10Inputs to specify these kinematic settings.

Note: the library currently does not handle exceptions where the provided kinematic inputs correspond to illegal mathematical operations, like division by $0$ and such. These exceptions usually correspond to unphysical kinematic settings.

Compton Form Factors:

There are four CFFs involved in the computation: $\mathcal{H}, \mathcal{E}, \tilde{\mathcal{H}}, \tilde{\mathcal{E}}$. Each of them is a complex function, so there are technically eight real numbers here. (Remember: any $z \in \mathbb{C}$ is $z = x + i y$, where $x, y \in \mathbb{R}$.) Use the dataclass CFFInputs to specify the values of these CFFs. (Note: they are of complex type!)

Goals/Future Work:

  • Provide the opportunity to compute the differential cross-section using the BKM02 formalism.
  • Integrate the functionality to actually do the integral over a given GPD model to obtain the CFFs, and then compute the differential cross-section.

Physics Terminology:

BKM: names of three authors: A.V. Belitsky, D. Buller, A. Kirchner,

QCD: "Quantum Chromodynamics"

CFF: "Compton Form Factor"

TMD: "Transverse Momentum Distribution"

GPD: "Generalized Parton Distribution (function)"

Project details


Download files

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

Source Distribution

bkm10-1.2.3.tar.gz (30.8 kB view details)

Uploaded Source

Built Distribution

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

bkm10-1.2.3-py3-none-any.whl (33.2 kB view details)

Uploaded Python 3

File details

Details for the file bkm10-1.2.3.tar.gz.

File metadata

  • Download URL: bkm10-1.2.3.tar.gz
  • Upload date:
  • Size: 30.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for bkm10-1.2.3.tar.gz
Algorithm Hash digest
SHA256 69ae3e7775291765e3a6caf652a4cbb9cfd2f97caa986d22e38ae8011a4d5337
MD5 010a08e2244deb42fc013ece1ecc2c39
BLAKE2b-256 9fb7d542f5c2a4440c3e1eaef6c737f7303afa764cf6891ba0ab6f95180ca67f

See more details on using hashes here.

File details

Details for the file bkm10-1.2.3-py3-none-any.whl.

File metadata

  • Download URL: bkm10-1.2.3-py3-none-any.whl
  • Upload date:
  • Size: 33.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for bkm10-1.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ebcce603842c072a9c43d28b0bfeda5436f3ce1dbaac2ecffe6a082a423fcca3
MD5 9e711887efa3e8fc16810e0a38d55701
BLAKE2b-256 7472a1ebb5d1bb70b9a0d5d69ba98946aee6f0fbbc77d5d0e0c0a8cd844de573

See more details on using hashes here.

Supported by

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