VakintEvaluationMethod

symbolica.community.vakint Class

VakintEvaluationMethod()

One configured backend in a Vakint instance's evaluation order.

Member details

`str`

Method

__str__() -> str

String representation of the evaluation method.

`new_alphaloop_method`

Class method

new_alphaloop_method() -> VakintEvaluationMethod

Create a new VakintEvaluationMethod instance representing the AlphaLoop method. This method does not take any parameters.

Examples

from symbolica.community.vakint import VakintEvaluationMethod
alphaloop_method = VakintEvaluationMethod.new_alphaloop_method()
"AlphaLoop" in str(alphaloop_method)

`new_matad_method`

Class method

new_matad_method(expand_masters: Optional[bool] = None, susbstitute_masters: Optional[bool] = None, substitute_hpls: Optional[bool] = None, direct_numerical_substition: Optional[bool] = None) -> VakintEvaluationMethod

Create a new VakintEvaluationMethod instance representing the MATAD method.

Examples

from symbolica.community.vakint import VakintEvaluationMethod
matad_method = VakintEvaluationMethod.new_matad_method(
    expand_masters=True,
    susbstitute_masters=True,
    substitute_hpls=True,
    direct_numerical_substition=True,
)
"MATAD" in str(matad_method)

Notes

susbstitute_masters and direct_numerical_substition retain their historical misspellings for API compatibility. They mean substitute_masters and direct_numerical_substitution, respectively.

Parameters

Name	Type	Default	Description
`expand_masters`	`Optional[bool]`	`None`	Whether to expand master integrals. Default is True.
`susbstitute_masters`	`Optional[bool]`	`None`	Whether to substitute master integrals. Default is True.
`substitute_hpls`	`Optional[bool]`	`None`	Whether to substitute harmonic polylogarithms. Default is True.
`direct_numerical_substition`	`Optional[bool]`	`None`	Whether to perform direct numerical substitution. Default is True.

`new_fmft_method`

Class method

new_fmft_method(expand_masters: Optional[bool] = None, susbstitute_masters: Optional[bool] = None) -> VakintEvaluationMethod

Create a new VakintEvaluationMethod instance representing the FMFT method.

Examples

from symbolica.community.vakint import VakintEvaluationMethod
fmft_method = VakintEvaluationMethod.new_fmft_method(
    expand_masters=True,
    susbstitute_masters=True,
)
"FMFT" in str(fmft_method)

Notes

susbstitute_masters retains its historical misspelling for API compatibility; it means substitute_masters.

Parameters

Name	Type	Default	Description
`expand_masters`	`Optional[bool]`	`None`	Whether to expand master integrals. Default is True.
`susbstitute_masters`	`Optional[bool]`	`None`	Whether to substitute master integrals. Default is True.

`new_pysecdec_method`

Class method

new_pysecdec_method(quiet: Optional[bool] = None, relative_precision: Optional[float] = None, min_n_evals: Optional[int] = None, max_n_evals: Optional[int] = None, reuse_existing_output: Optional[str] = None, numerical_masses: Optional[Mapping[str, float]] = None, numerical_external_momenta: Optional[Mapping[int, tuple[float, float, float, float]]] = None) -> VakintEvaluationMethod

Create a new VakintEvaluationMethod instance representing the numerical pySecDec method.

Examples

from symbolica.community.vakint import VakintEvaluationMethod
pysecdec_method = VakintEvaluationMethod.new_pysecdec_method(
    quiet=True,
    relative_precision=1e-7,
    min_n_evals=10_000,
    max_n_evals=1_000_000_000_000,
    reuse_existing_output=None,
    numerical_masses={"muvsq": 1.0},
    numerical_external_momenta={
        1: (1.0, 0.0, 0.0, 0.0),
        2: (0.0, 1.0, 0.0, 0.0),
    },
)
"PySecDec" in str(pysecdec_method)

pySecDec performs numerical evaluation, so every required mass and external momentum must have a numerical value. Constructing this method does not run pySecDec; evaluation requires a working Python/pySecDec installation.

Parameters

Name	Type	Default	Description
`quiet`	`Optional[bool]`	`None`	Whether to suppress output from pySecDec. Default is True.
`relative_precision`	`Optional[float]`	`None`	The relative precision to be achieved in the numerical integration. Default is 1e-7.
`min_n_evals`	`Optional[int]`	`None`	The minimum number of evaluations to be performed in the numerical integration. Default is 10,000.
`max_n_evals`	`Optional[int]`	`None`	The maximum number of evaluations to be performed in the numerical integration. Default is 1,000,000,000,000.
`reuse_existing_output`	`Optional[str]`	`None`	Path to existing pySecDec output to reuse. Default is None.
`numerical_masses`	`Optional[Mapping[str, float]]`	`None`	A dictionary mapping mass parameter names to their numerical values. Default is an empty dictionary.
`numerical_external_momenta`	`Optional[Mapping[int, tuple[float, float, float, float]]]`	`None`	A dictionary mapping external momentum indices to their numerical 4-vector values. Default is an empty dictionary.

View generated signature source: docs/api/python/vakint-community.pyi:245