Physics PDFs#

Physics PDFs are PDFs that are often used in high energy physics. They are in the zfit-physics package, which needs to be installed separately (for example, via pip install zfit-physics) and accessed via the zfit_physics.pdf module.

Physics PDFs are specialized probability density functions commonly used in particle physics for modeling signal and background distributions. These PDFs are designed to capture specific physical phenomena observed in experimental data.

Below are visualizations of physics PDFs with different parameter values to help understand their shapes and choose appropriate initial parameter values.

CrystalBall PDF#

The CrystalBall function is a Gaussian with a power-law tail, commonly used to model energy loss and detector resolution effects in particle physics.

CrystalBall PDF with different alpha values CrystalBall PDF with different n values CrystalBall PDF with different mu values CrystalBall PDF with different sigma values

zfit.pdf.CrystalBall(mu, sigma, alpha, n, obs, *)

Crystal Ball shaped PDF.

GaussExpTail PDF#

The GaussExpTail combines a Gaussian core with an exponential tail, useful for modeling detector resolution effects with asymmetric tails.

GaussExpTail PDF with different alpha values GaussExpTail PDF with different sigma values

zfit.pdf.GaussExpTail(mu, sigma, alpha, obs, *)

GaussExpTail shaped PDF.

GeneralizedCB PDF#

The GeneralizedCB extends the Crystal Ball function with additional parameters for more flexible modeling of asymmetric peaks with power-law tails.

GeneralizedCB PDF with different alphaL values GeneralizedCB PDF with different nL values GeneralizedCB PDF with different alphaR values

zfit.pdf.GeneralizedCB(mu, sigmal, alphal, ...)

Generalized asymmetric double-sided Crystal Ball shaped PDF.

GeneralizedGaussExpTail PDF#

The GeneralizedGaussExpTail extends the GaussExpTail function with additional parameters for more flexible modeling of asymmetric distributions.

GeneralizedGaussExpTail PDF with different alphaL values GeneralizedGaussExpTail PDF with different alphaR values GeneralizedGaussExpTail PDF with different sigmaL values

zfit.pdf.GeneralizedGaussExpTail(mu, sigmal, ...)

GeneralizedGaussedExpTail shaped PDF which is Generalized assymetric double-sided GaussExpTail shaped PDF.

DoubleCB PDF#

The DoubleCB function extends the Crystal Ball by having power-law tails on both sides of the Gaussian core, providing more flexibility for modeling asymmetric peaks.

DoubleCB PDF with different alphaL values DoubleCB PDF with different alphaR values

zfit.pdf.DoubleCB(mu, sigma, alphal, nl, ...)

Double-sided Crystal Ball shaped PDF.

The following PDFs are available in the separate zfit_physics package:

Argus#

The Argus PDF is commonly used to model background distributions in B physics, particularly for describing the kinematic threshold behavior.

Argus PDF with different c values Argus PDF with different m0 values Argus PDF with different p values

zfit_physics.pdf.Argus(*args[, obs])

ARGUS shape describing the invariant mass of a particle in a continuous background.

RelativisticBreitWigner#

The RelativisticBreitWigner PDF describes the mass distribution of unstable particles, taking into account relativistic effects.

RelativisticBreitWigner PDF with different m0 values RelativisticBreitWigner PDF with different gamma values

zfit_physics.pdf.RelativisticBreitWigner(*args)

Relativistic Breit-Wigner distribution.

CMSShape#

The CMSShape PDF is used to model background distributions in CMS analyses.

CMSShape PDF with different alpha values CMSShape PDF with different beta values CMSShape PDF with different gamma values

zfit_physics.pdf.CMSShape(m, beta, gamma, obs, *)

CMSShape PDF.

Cruijff#

The Cruijff PDF is an asymmetric Gaussian with different widths and tails on each side, often used to model detector resolution effects.

Cruijff PDF with different mu values Cruijff PDF with different sigmaL values Cruijff PDF with different sigmaR values Cruijff PDF with different alphaL values Cruijff PDF with different alphaR values

zfit_physics.pdf.Cruijff(mu, sigmal, alphal, ...)

Cruijff PDF, a Gaussian with two width, left and right, and non-Gaussian tails.

ErfExp#

The ErfExp PDF combines an error function with an exponential, useful for modeling backgrounds with a turn-on effect.

ErfExp PDF with different mu values ErfExp PDF with different beta values ErfExp PDF with different gamma values ErfExp PDF with different n values

zfit_physics.pdf.ErfExp(mu, beta, gamma, n, ...)

ErfExp PDF, the product of a complementary error function and an exponential function.

Novosibirsk#

The Novosibirsk PDF is used to model asymmetric peaks with a Gaussian-like core and exponential tails.

Novosibirsk PDF with different mu values Novosibirsk PDF with different sigma values Novosibirsk PDF with different lambd values

zfit_physics.pdf.Novosibirsk(mu, sigma, ...)

Novosibirsk PDF.

Tsallis#

The Tsallis PDF is used in high-energy physics to model particle production spectra.

Tsallis PDF with different m values Tsallis PDF with different n values Tsallis PDF with different t values

zfit_physics.pdf.Tsallis(m, t, n, obs, *[, ...])

Tsallis-Hagedorn PDF.

zfit.pdf.CrystalBall(mu, sigma, alpha, n, obs, *)

Crystal Ball shaped PDF.

zfit.pdf.DoubleCB(mu, sigma, alphal, nl, ...)

Double-sided Crystal Ball shaped PDF.

zfit.pdf.GeneralizedCB(mu, sigmal, alphal, ...)

Generalized asymmetric double-sided Crystal Ball shaped PDF.

zfit.pdf.GaussExpTail(mu, sigma, alpha, obs, *)

GaussExpTail shaped PDF.

zfit.pdf.GeneralizedGaussExpTail(mu, sigmal, ...)

GeneralizedGaussedExpTail shaped PDF which is Generalized assymetric double-sided GaussExpTail shaped PDF.

zfit_physics.pdf.Argus(*args[, obs])

ARGUS shape describing the invariant mass of a particle in a continuous background.

zfit_physics.pdf.RelativisticBreitWigner(*args)

Relativistic Breit-Wigner distribution.

zfit_physics.pdf.CMSShape(m, beta, gamma, obs, *)

CMSShape PDF.

zfit_physics.pdf.Cruijff(mu, sigmal, alphal, ...)

Cruijff PDF, a Gaussian with two width, left and right, and non-Gaussian tails.

zfit_physics.pdf.ErfExp(mu, beta, gamma, n, ...)

ErfExp PDF, the product of a complementary error function and an exponential function.

zfit_physics.pdf.Novosibirsk(mu, sigma, ...)

Novosibirsk PDF.

zfit_physics.pdf.Tsallis(m, t, n, obs, *[, ...])

Tsallis-Hagedorn PDF.