gammaLoop generate amp

Generate an amplitude integrand for the supplied process specification

Synopsis

Usage: gammaLoop generate amp [OPTIONS] [TOKENS]...

Positional arguments

`tokens`

Quote-free spec.

Grammar (unquoted): INITIAL to FINAL [process_options] [generation_options] Also accepts: INITIAL > FINAL [ ... ]

Examples: e+ e- to d d~ g veto u d xs QED^2==2 QCD^2<=4 pert loops=1 fsloops=2 QCD=2 e+ e- > { z z, a a } [ {1} {{2}} QCD=2 QED=1 ] / u d | g ghG QED==2 QCD>=2 QCD<=4

Notes:

veto and only are synonyms for / and |.
The [ ... ] block holds perturbative spec: {n}, {{n}}, and orders QCD=n with shorthand QCD≡1.

Behavior: accepts repeated values; 1 or more values
Value names: TOKENS

Options

`-a`

Append the generated process instead of replacing the current process selection

Behavior: sets true; no value
Default: false

`-c, --clear-existing-processes`

Clear pre-existing processes

Behavior: sets true; no value
Default: false

`-p, --process-name`

Optional human-readable process name

Behavior: sets one value; 1 value(s)
Value names: PROCESS_NAME

`-i, --integrand-name`

Name assigned to the generated integrand; defaults to the generated process name

Behavior: sets one value; 1 value(s)
Value names: INTEGRAND_NAME

`-o, --only-diagrams`

Stop after diagram generation without constructing an evaluable integrand

Behavior: sets true; no value
Default: false

`--filter-selfenergies`

Include or exclude self-energy topologies; omission uses the generation-mode default

Behavior: sets one value; 1 value(s)
Value names: FILTER_SELFENERGIES
Values: true, false

`--filter-snails`

Include or exclude snail topologies; omission uses the generation-mode default

Behavior: sets one value; 1 value(s)
Value names: FILTER_SNAILS
Values: true, false

`--filter-tadpoles`

Include or exclude tadpole topologies; omission uses the generation-mode default

Behavior: sets one value; 1 value(s)
Value names: FILTER_TADPOLES
Values: true, false

`--veto-vertex-interactions`

Exclude graphs containing any listed vertex-interaction name

Behavior: accepts repeated values; 0 or more values
Value names: VETO_VERTEX_INTERACTIONS

`--allowed-vertex-interactions`

Restrict generation to an allow-list of vertex interactions

Behavior: accepts repeated values; 0 or more values
Value names: ALLOWED_VERTEX_INTERACTIONS

`--filter-cross-section-tadpoles`

Filter tadpoles formed while sewing amplitudes into a cross-section graph

Behavior: sets one value; 1 value(s)
Value names: FILTER_CROSS_SECTION_TADPOLES
Values: true, false

`--veto-tadpoles-attached-to-massive-lines`

Veto tadpoles attached to massive propagators

Behavior: sets one value; 1 value(s)
Value names: VETO_TADPOLES_ATTACHED_TO_MASSIVE_LINES
Values: true, false

`--veto-tadpoles-attached-to-massless-lines`

Veto tadpoles attached to massless propagators

Behavior: sets one value; 1 value(s)
Value names: VETO_TADPOLES_ATTACHED_TO_MASSLESS_LINES
Values: true, false

`--veto-only-scaleless-tadpoles`

Veto only tadpoles that are scaleless

Behavior: sets one value; 1 value(s)
Value names: VETO_ONLY_SCALELESS_TADPOLES
Values: true, false

`--veto-snails-attached-to-massive-lines`

Veto snail insertions attached to massive propagators

Behavior: sets one value; 1 value(s)
Value names: VETO_SNAILS_ATTACHED_TO_MASSIVE_LINES
Values: true, false

`--veto-snails-attached-to-massless-lines`

Veto snail insertions attached to massless propagators

Behavior: sets one value; 1 value(s)
Value names: VETO_SNAILS_ATTACHED_TO_MASSLESS_LINES
Values: true, false

`--veto-only-scaleless-snails`

Veto only snail insertions that are scaleless

Behavior: sets one value; 1 value(s)
Value names: VETO_ONLY_SCALELESS_SNAILS
Values: true, false

`--veto-self-energy-of-massive-lines`

Veto self-energy insertions on massive propagators

Behavior: sets one value; 1 value(s)
Value names: VETO_SELF_ENERGY_OF_MASSIVE_LINES
Values: true, false

`--veto-self-energy-of-massless-lines`

Veto self-energy insertions on massless propagators

Behavior: sets one value; 1 value(s)
Value names: VETO_SELF_ENERGY_OF_MASSLESS_LINES
Values: true, false

`--veto-only-scaleless-self-energy`

Veto only self-energy insertions that are scaleless

Behavior: sets one value; 1 value(s)
Value names: VETO_ONLY_SCALELESS_SELF_ENERGY
Values: true, false

`-b, --max-n-bridges`

Maximum number of bridges allowed in a generated graph; negative values disable the bound

Behavior: sets one value; 1 value(s)
Value names: MAX_N_BRIDGES

`-f, --number-of-factorized-loop-subtopologies`

Inclusive minimum and maximum number of factorized loop subtopologies

Behavior: accepts repeated values; 2 value(s)
Value names: NUMBER_OF_FACTORIZED_LOOP_SUBTOPOLOGIES

`-L, --number-of-fermion-loops`

Number of closed fermion loops; negative disables

Behavior: accepts repeated values; 2 value(s)
Value names: NUMBER_OF_FERMION_LOOPS

`-B, --n-cut-blobs`

Inclusive minimum and maximum number of cut blobs on either side of a cross-section cut

Behavior: accepts repeated values; 2 value(s)
Value names: N_CUT_BLOBS

`-S, --n-cut-spectators`

Inclusive minimum and maximum number of spectators crossing a cross-section cut

Behavior: accepts repeated values; 2 value(s)
Value names: N_CUT_SPECTATORS

`--allow-symmetrization-of-external-fermions-in-amplitudes`

Permit external fermion permutations when identifying equivalent amplitudes

Behavior: sets one value; 1 value(s)
Value names: ALLOW_SYMMETRIZATION_OF_EXTERNAL_FERMIONS_IN_AMPLITUDES
Values: true, false

`--symmetrize-initial-states`

Identify graphs related by permutations of identical initial-state particles

Behavior: sets one value; 1 value(s)
Value names: SYMMETRIZE_INITIAL_STATES
Values: true, false

`--symmetrize-final-states`

Identify graphs related by permutations of identical final-state particles

Behavior: sets one value; 1 value(s)
Value names: SYMMETRIZE_FINAL_STATES
Values: true, false

`--symmetrize-left-right-states`

Identify cross-section graphs related by exchanging the left and right amplitudes

Behavior: sets one value; 1 value(s)
Value names: SYMMETRIZE_LEFT_RIGHT_STATES
Values: true, false

`-G, --numerator-grouping`

Numerator-aware grouping choice

Behavior: sets one value; 1 value(s)
Value names: NUMERATOR_AWARE_ISOMORPHISM_GROUPING
Values: no_grouping, only_detect_zeroes, group_identical_graphs_up_to_sign, group_identical_graphs_up_to_scalar_rescaling

`--numerical-samples-seed`

Deterministic random seed used for numerical numerator comparisons

Behavior: sets one value; 1 value(s)
Value names: NUMERICAL_SAMPLES_SEED

`--number-of-samples-for-numerator-comparisons`

Number of phase-space samples used to decide whether two numerators are equivalent

Behavior: sets one value; 1 value(s)
Value names: NUMBER_OF_SAMPLES_FOR_NUMERATOR_COMPARISONS

`--consider-internal-masses-only-in-numerator-isomorphisms`

Distinguish mass parameters while ignoring other model-parameter labels during grouping

Behavior: sets one value; 1 value(s)
Value names: CONSIDER_INTERNAL_MASSES_ONLY_IN_NUMERATOR_ISOMORPHISMS
Values: true, false

`--fully-numerical-substitution-when-comparing-numerators`

Numerically substitute every parameter when comparing candidate numerator isomorphisms

Behavior: sets one value; 1 value(s)
Value names: FULLY_NUMERICAL_SUBSTITUTION_WHEN_COMPARING_NUMERATORS
Values: true, false

`--compare-canonized-numerator`

Compare canonicalized numerators in addition to graph topology when grouping

Behavior: sets one value; 1 value(s)
Value names: COMPARE_CANONIZED_NUMERATOR
Values: true, false

`--symmetric-left-right-polarizations`

Treat left- and right-side polarization factors symmetrically during numerator grouping

Behavior: sets one value; 1 value(s)
Value names: SYMMETRIC_LEFT_RIGHT_POLARIZATIONS
Values: true, false

`--loop-momentum-bases`

Graph processing toggles

Format: --loop-momentum-bases "GL_12=7,10 GL_77=4,2" --select-graphs "GL_12 GL_13" --veto-graphs "GL_11 GL_15"

Behavior: accepts repeated values; 0 or more values
Value names: KEY=VALUE

`--select-graphs`

Generate only graphs whose names appear in this allow-list

Behavior: accepts repeated values; 0 or more values
Value names: SELECT_GRAPHS

`--veto-graphs`

Exclude graphs whose names appear in this deny-list

Behavior: accepts repeated values; 0 or more values
Value names: VETO_GRAPHS

`-g, --graph-prefix`

Prefix assigned to generated graph names; defaults to GL

Behavior: sets one value; 1 value(s)
Value names: GRAPH_PREFIX

`--global-prefactor-projector`

Global prefactor projector (Symbolica atom string)

Behavior: sets one value; 1 value(s)
Value names: ATOM

`--global-prefactor-num`

Global prefactor numerator (Symbolica atom string)

Behavior: sets one value; 1 value(s)
Value names: ATOM

`-M, --max-multiplicity-for-fast-cut-filter`

Fast cut filter switch multiplicity

Behavior: sets one value; 1 value(s)
Value names: MAX_MULTIPLICITY_FOR_FAST_CUT_FILTER
Default: 6

`--filter-self-loop`

Filter graph-theoretic self-loops explicitly; omission keeps them

Behavior: sets one value; 1 value(s)
Value names: FILTER_SELF_LOOP
Values: true, false

`--filter-zero-flow-edges`

Filter edges that carry zero momentum flow in the selected routing

Behavior: sets one value; 1 value(s)
Value names: FILTER_ZERO_FLOW_EDGES
Values: true, false

`-h, --help`

Print help (see a summary with '-h')

Behavior: shows help; no value

Inherited and global options

`--keep-sources`

Keep generated C++ source files after external compilation

Behavior: sets true; no value
Scope: inherited global
Default: false

gammaLoop generate amp

Synopsis

Command hierarchy

Positional arguments

Options

Inherited and global options