The oneloop.gluon module¶
Library of functions and routines for the one-loop gluon propagator computed in the Screened Massive Expansion.
Contents:
Note
Where not otherwise specified,
s
is the adimensional Euclidea momentum squared .Most functions are defined modulo factors of the coupling constant. If the
ren
parameter is available, such factors become irrelevant when renormalization is enabled usingren=True
.With the parametrization described below, to one loop, the number of colors only enters the expressions through the quark contribution – hence is irrelevant in pure Yang-Mills theory (no quarks, i.e., ) – and through the value of the gluon mass parameter .
The one-loop gluon dressing function, propagator and spectral function¶
- gluon_J_inv(s, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc')¶
Inverse gluon dressing function
Modulo a factor of .
- Parameters:
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)
- gluon_J(s, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc')¶
Gluon dressing function
Modulo a factor of .
- Parameters:
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)
- gluon_prop(s, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', ren=True, Z=None, mu0=6.099699589795203, dimensionful=False, m=0.65577)¶
Gluon propagator .
Modulo a factor of .
- Parameters:
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)ren – if
True
, multiplicatively renormalize the propagatorZ – if
None
, renormalize the propagator in the MOM scheme at the scalemu0
, else useZ
as the multiplicative renormalization factor (only ifren=True
)mu0 – adimensional renormalization scale for the renormalization of the propagator in the MOM scheme (only if
ren=True
)dimensionful – if
False
, adimensionalize the propagator by multiplying it bym
2; ifTrue
,s
is the dimensionful momentum squaredm – gluon mass parameter (only if
dimensionful=True
)
- gluon_spectral(s, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', ren=True, Z=None, mu0=6.099699589795203, dimensionful=False, m=0.65577)¶
Gluon spectral function in Minkowski space.
Modulo a factor of . The for the difference across the branch cut is defined in the
PySmeQcd.settings
module.- Parameters:
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)ren – if
True
, multiplicatively renormalize the spectral functionZ – if
None
, renormalize the spectral function in the MOM scheme at the scalemu0
, else useZ
as the multiplicative renormalization factor (only ifren=True
)mu0 – adimensional renormalization scale for the renormalization of the spectral function in the MOM scheme (only if
ren=True
)dimensionful – if
False
, adimensionalize the spectral function by multiplying it bym
2; ifTrue
,s
is the dimensionful Minkowski momentum squaredm – gluon mass parameter (only if
dimensionful=True
)
Note
s
is the adimensional Minkowski momentum squared ,
or the dimensionful Minkowski momentum squared if
dimensionful=True
.
- dgluon_J_inv(s, x=0.238171, N=3, xi=0, Nf=0, type='uc')¶
Derivative of
gluon_J_inv
with respect tos
.- Parameters:
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)
Poles and residues¶
- gluon_pole(x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', dimensionful=False, m=0.65577, stp=-1 - 1j)¶
Pole of the gluon propagator in Euclidean space.
If the pole cannot be found, prints to
stderr
and raises aRuntimeError
.- Parameters:
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)dimensionful – if
False
, adimensionalize the pole by dividing it bym
2m – gluon mass parameter (only if
dimensionful=True
)stp – starting point for the root-finding algorithm
- gluon_residue(pole=None, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', ren=True, Z=None, mu0=6.099699589795203, dimensionful=False, m=0.65577, stp=-1 - 1j)¶
Residue of the gluon propagator at its pole.
Modulo a factor of .
- Parameters:
pole – if
None
, compute the pole before computing its residue (recommended); else usepole
as the Euclidean pole. See below for dimensionsx – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)ren – if
True
, multiplicatively renormalize the residueZ – if
None
, renormalize the residue in the MOM scheme at the scalemu0
, else useZ
as the multiplicative renormalization factor (only ifren=True
)mu0 – adimensional renormalization scale for the renormalization of the residue in the MOM scheme (only if
ren=True
)dimensionful – if
True
,pole
is passed dimensionful (only ifpole!=None
)m – gluon mass parameter (only if
dimensionful=True
)stp – starting point for the root-finding algorithm (only if
pole=None
)
Plots¶
- gluon_J_plot(s=[0.001, 25], N_s=1000, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', inverse=False, ren=True, Z=None, mu0=6.099699589795203, dimensionful=False, m=0.65577, scale='log', title=True, outf=None)¶
Plots the gluon dressing function in Euclidean space.
Modulo a factor of .
- Parameters:
s – a two-element list containing the minimum and maximum momentum squared for the plot (see below for dimensions)
N_s – an integer specifying the number of plot points
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)inverse – if
True
, plot the inverse dressing functionren – if
True
, multiplicatively renormalize the dressing functionZ – if
None
, renormalize the dressing function in the MOM scheme at the scalemu0
, else useZ
as the multiplicative renormalization factor (only ifren=True
)mu0 – adimensional renormalization scale for the renormalization of the dressing function in the MOM scheme (only if
ren=True
)dimensionful – if
True
,s
is the dimensionful momentum squaredm – gluon mass parameter (only if
dimensionful=True
)scale – if set to
'log'
, switch to a log-lin scaletitle – if
True
, show a title for the plotoutf – if not
None
, save the output to the file specified byoutf
rather than printing it out
- gluon_J_3D_plot(value='abs', s_real=[-5, 3], s_imag=[-4, 4], N_s_real=1000, N_s_imag=1000, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', inverse=False, ren=True, Z=None, mu0=6.099699589795203, dimensionful=False, m=0.65577, title=True, outf=None)¶
Plots the gluon dressing function in the complex plane (3D plot).
Modulo a factor of .
- Parameters:
value – if
'abs'
, plot the absolute value; if'real'
, plot the real part; if'imag'
, plot the imaginary parts_real – a two-element list containing the minimum and maximum real part of the momentum squared for the plot (see below for dimensions)
s_imag – a two-element list containing the minimum and maximum imaginary part of the momentum squared for the plot (see below for dimensions)
N_s_real – an integer specifying the number of subdivisions in the real direction
N_s_imag – an integer specifying the number of subdivisions in the imaginary direction
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)inverse – if
True
, plot the inverse dressing functionren – if
True
, multiplicatively renormalize the dressing functionZ – if
None
, renormalize the dressing function in the MOM scheme at the scalemu0
, else useZ
as the multiplicative renormalization factor (only ifren=True
)mu0 – adimensional renormalization scale for the renormalization of the dressing function in the MOM scheme (only if
ren=True
)dimensionful – if
True
,s_real
ands_imag
are the real and imaginary parts of the dimensionful momentum squaredm – gluon mass parameter (only if
dimensionful=True
)title – if
True
, show a title for the plotoutf – if not
None
, save the output to the file specified byoutf
rather than printing it out
- gluon_J_inv_contour(s_real=[-5, 3], s_imag=[-4, 4], N_s_real=500, N_s_imag=500, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', dimensionful=False, m=0.65577, title=True, outf=None)¶
Plots the zeroes of the real and imaginary part of the inverse gluon dressing function.
- Parameters:
s_real – a two-element list containing the minimum and maximum real part of the momentum squared for the plot (see below for dimensions)
s_imag – a two-element list containing the minimum and maximum imaginary part of the momentum squared for the plot (see below for dimensions)
N_s_real – an integer specifying the number of subdivisions in the real direction
N_s_imag – an integer specifying the number of subdivisions in the imaginary direction
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)dimensionful – if
True
,s_real
ands_imag
are the real and imaginary parts of the dimensionful momentum squaredm – gluon mass parameter (only if
dimensionful=True
)title – if
True
, show a title for the plotoutf – if not
None
, save the output to the file specified byoutf
rather than printing it out
- gluon_prop_plot(s=[0.001, 25], N_s=1000, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', ren=True, Z=None, mu0=6.099699589795203, dimensionful=False, m=0.65577, scale='log', title=True, outf=None)¶
Plots the gluon propagator in Euclidean space.
Modulo a factor of .
- Parameters:
s – a two-element list containing the minimum and maximum momentum squared for the plot (see below for dimensions)
N_s – an integer specifying the number of plot points
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)ren – if
True
, multiplicatively renormalize the propagatorZ – if
None
, renormalize the propagator in the MOM scheme at the scalemu0
, else useZ
as the multiplicative renormalization factor (only ifren=True
)mu0 – adimensional renormalization scale for the renormalization of the propagator in the MOM scheme (only if
ren=True
)dimensionful – if
False
, adimensionalize the propagator by multiplying it bym
2; ifTrue
,s
is the dimensionful momentum squaredm – gluon mass parameter (only if
dimensionful=True
)scale – if set to
'log'
, switch to a log-lin scaletitle – if
True
, show a title for the plotoutf – if not
None
, save the output to the file specified byoutf
rather than printing it out
- gluon_spectral_plot(s=[0.001, 25], N_s=1000, x=0.238171, N=3, xi=0, F0=-0.876, Nf=0, type='uc', ren=True, Z=None, mu0=6.099699589795203, dimensionful=False, m=0.65577, scale='log', title=True, outf=None)¶
Plots the gluon spectral function in Minkowski space.
Modulo a factor of .
- Parameters:
s – a two-element list containing the minimum and maximum Minkowski momentum squared for the plot (see below for dimensions)
N_s – an integer specifying the number of plot points
x – adimensional quark chiral mass squared
N – number of colors
xi – gauge parameter
F0 – additive renormalization constant
Nf – number of quarks
type – diagram selector:
'uc'
if only the ordinary quark loop is included,'cr'
if also the crossed quark loop is included (full QCD only)ren – if
True
, multiplicatively renormalize the spectral functionZ – if
None
, renormalize the spectral function in the MOM scheme at the scalemu0
, else useZ
as the multiplicative renormalization factor (only ifren=True
)mu0 – adimensional renormalization scale for the renormalization of the spectral function in the MOM scheme (only if
ren=True
)dimensionful – if
False
, adimensionalize the spectral function by multiplying it bym
2; ifTrue
,s
is the dimensionful Minkowski momentum squaredm – gluon mass parameter (only if
dimensionful=True
)scale – if set to
'log'
, switch to a log-lin scaletitle – if
True
, show a title for the plotoutf – if not
None
, save the output to the file specified byoutf
rather than printing it out
Note
s
is the adimensional Minkowski momentum squared ,
or the dimensionful Minkowski momentum squared if
dimensionful=True
.