Matchete`
Matchete`

DefineCoupling

DefineCoupling[label]

defines a new coupling referred to by its label to be used in Lagrangians.

DefineCoupling[{label1,label2,}]

defines multiple new couplings referred to by label1, label2, that all share the same properties.

Details and Options

  • Defining a coupling with DefineCoupling informs Matchete of the EFT order counting and indices of the coupling in question. All couplings must be defined before a Lagrangian can be written down.
  • DefineCoupling provides a new function label[] (or label[i, j, ...] if indices are provided with the Indices option) that provides a shortcut for the user to write the coupling in the internal format used in Matchete. It gives an instance of the coupling with the given indices.
  • The following options can be given:
  • DiagonalCoupling Defaultspecifies if any of the indices are diagonal in flavor space, meaning irrelevant for Einstein summation convention.
    EFTOrder 0specifies the EFT power-counting of the coupling with a non-negative integer.
    Indices {}specifies a (list of) representation(s) corresponding to the flavor indices carried by the coupling.
    NiceForm Defaultprovides the display of the field under NiceForm formatting.
    SelfConjugate Falsespecifies whether the field is self-conjugated (real).
    Symmetries {}provides a list of symmetries among the indices of the coupling.
  • The allowed values for the option DiagonalCoupling are
  • Defaultall indices are taken to be non-diagonal
    Booleanspecifies if the single index is diagonal or not
    {Boolean, Boolean, }the n'th Boolean specifies whether the n'th flavor index is a diagonal in flavor space
  • The EFT power counting behavior of the coupling as specified by EFTOrder is used by Matchete to truncate the EFTexpansion in functions such as Match or SeriesEFT. The counting (EFTOrder) of light bosons and covariant derivatives are 1.
  • The option values for SelfConjugate are
  • Falsethe coupling is complex
    Truethe coupling is real
    {n1, n2,}complex conjugation of the coupling exchanges its indices, e.g, if the couplings is a Hermitian matrix
  • The option Symmetries takes a list of symmetries between the indices. The symmetries can be specified as
  • SymmetricIndices[n1,n2,]dictates symmetry of all permutations between the indices n1, n2,
    AntisymmetricIndices[n1,n2,]dictates antisymmetry of all permutations between the indices n1, n2,
    SymmetricPermutation[n1,n2,]dictates symmetry under a particular permutation of the indices n1, n2,
    AntisymmetricPermutation[n1,n2,]dictates antisymmetry under a particular permutation of the indices n1, n2,

Examples

open allclose all

Basic Examples  (1)

Defining a coupling

initializes the symbol as a short-hand to type in the coupling in internal Matchete notation:

The properties of the coupling is saved in the global state and can be recovered with GetCouplings

Scope  (1)

Multiple couplings (sharing properties) can be defined at once using a list of labels

The options will be shared between all couplings in the list. In the case above both couplings will be real.

Options  (8)

DiagonalCoupling  (2)

We define a new flavor index with DefineFlavorIndex:

The default behavior of flavor indices of couplings is that they respect Einstein summation convention. An ordinary two-index coupling

can, thus, freely have repeated indices relabeled (with RelabelIndices)

Following these rules triple-repeated indices are invalid, e.g.,

In some cases, particularly heavy masses, it is convenient to assume a diagonal structure for a coupling (meaning e.g. a mass matrix has elements only along the diagonal). In such cases it is convenient to use a single index instead of two it is even required for heavy masses when using Match. Setting a flavor index to be diagonal with the DiagonalCoupling option means that the index does not count in Einstein summation convention. For instance, the mass parameter

If diagonal indices appear with two ordinary repeated indices, they are included in the sum and relabeled simmultaneously:

Note that diagonality of coupling indices may not be stable under RG flow of the theory unless it is protected by some (accidental) symmetry.

In advanced situation a coupling can have multiple indices, some of which are diagonal and some which are not. Consider

with two indices, the first of which is diagonal. In some sense we might think of this as a rank-three tensor that is diagonal under the first two indices. In summation situations we have, e.g.,

Thus there is only a sum over the second index, which is non-diagonal and thus repeated for summation purposes.

EFTOrder  (1)

The option EFTOrder dictates the power-counting behavior of the coupling. A coupling

with EFTOrder 4, vanishes when truncating the EFT series at dimension 3:

Indices  (1)

Couplings can have flavor indices in theories where such have been defined. Using DefineFlavorIndex to initialize a flavor representation with dimension 3,

we may define a coupling with indices in that space. For instance, the SM lepton Yukawa coupling matrix is given by

The resulting coupling has two flavor indices, which means it must be called with two arguments in its definition:

NiceForm  (1)

The option NiceForm can be provided to the coupling definition to change how it displays under NiceForm output. The default is to use the label of the coupling, but it can be changed by providing a string. For instance to display the coupling with a subscript, we would use

SelfConjugate  (2)

Couplings are by default assumed to be complex; however, in many cases the form of the Lagrangian may require that they should be real. In such cases, it is important to specify this, so that the simplification algorithms can work as well as possible. To do this, we may use the option SelfConjugate. To illustrate the behavior of real and complex couplings consider

Complex conjugation with Bar gives

demonstrating that Bar acts non-trivially only on the complex coupling.

If a coupling is a tensor in flavor space, complex conjugation can also have the effect of exchanging the indices of the coupling. For instance, we may define a Hermitian coupling matrix (complex conjugation exchanges the first and second indices)

In that event

Symmetries  (1)

When couplings have multiple indices of the same type, it might be (anti-)symmetric under permutation of the indices. Including this information allows the simplification methods to perform better.

An example of such symmetries are from the SMEFT operator Cee, which has four flavor indices. It is symmetric under exchanges of the two first and two last indices in addition to under the exchange of indices 2 and 4:

We can verify that the coupling is in fact initialized with symmetries under the full symmetry group generated by the elements we provided. In this case we also get symmetry under the exchange of indices 1 and 3: