Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
SARAH SARAH
  • Project overview
    • Project overview
    • Details
    • Activity
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Analytics
    • Analytics
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Members
    • Members
  • Activity
Collapse sidebar
  • GOODSELL Mark
  • SARAHSARAH
  • Wiki
  • Particles.m

Last edited by Martin Gabelmann Jun 28, 2019
Page history

Particles.m

Particles.m

General

The particle file contains information about all fields of the model. This information is usually needed needed for an appropriate output.

  • Description: a string for defining the particle.
  • PDG: defines the PDG numbers of all generations.
  • PDG.IX: defines a nine-digit number of a particle supporting the proposal Ref. . By default, the entries of PDG are used in the output (to switch to the new scheme, either at the beginning of a SARAH session or in the model files, one has to set UsePDGIX = True;).
  • ElectricCharge: defines the electric charge of a particle in units of e. This information is exported to the CalcHep /CompHep and UFO model files.
  • Width: can be used to define a fixed numerical value for the width.
  • Mass: defines, how MC tools obtain a numerical value for the mass of the particle:
    • a numerical value can be given
    • the keyword Automatic assigns that SARAH derives the tree level expression for the mass from the Lagrangian. The mass is then calculated by using the values of the other parameters.
    • the keyword LesHouches assigns that this mass is calculated numerically by a spectrum generator like SPheno and provided via a Les Houches spectrum file. This is usually the preferred method because also loop corrections are included.
  • OutputName: defines the name used in the different outputs for other codes.
  • LaTeX: defines the name of the particle used in the LaTeX output.
  • FeynArtsNr: the number assigned to the particle used in the FeynArts output
  • LHPC: defines the column and colour used for the particle in the steering file for the LHPC Spectrum Plotter. All colours available in gnuplot can be used.
  • Goldstone: for each massive vector boson the name of corresponding Goldstone boson is given.

The properties of all particles appearing either as gauge or mass eigenstates, or just at intermediate steps can be defined in particles.m. Usually, the user is only interested in the output for the mass eigenstates. Therefore, it is not really necessary to define the entire properties of all intermediate states and the gauge eigenstates. The only input which is usually helpful to have a nice looking LaTeX output is to define the LaTeX syntax for all particles which appear at any stage in the model.

Considered eigenstates

This information must be given for all eigenstates in arrays named

ParticleDefinition[$EIGENSTATES]

Only for the LaTeX output also the names of the Weyl spinors and intermediate states (like scalar and pseudo scalar components of Higgs) should be given to improve the look and readability of the produced pdf file. For this purpose, the list

WeylFermionAndIndermediate

can be used.

Example

For the eigenstates after EWSB, an entry might look like

ParticleDefinitions[EWSB} = {
   ...
   {Sd ,  {  Description -> "Down Squark",
             PDG ->  {1000001,2000001,1000003,2000003,1000005,2000005},
             PDG.IX -> {-200890201,-200890202,-200890203,-200890204,-200890205,-200890206}
             Mass -> Automatic,
             FeynArtsNr -> 14,
             LaTeX -> "\\tilde{d}",,
             ElectricCharge -> -1/3,
             LHPC -> {7, "cyan"},
             OutputName -> "sd" }},
   ... }

Global definitions

It is also possible to define global properties for parameters or particles which are present in more than one model file. These properties are afterwards used for all models. The global definitions are saved in the files particles.m and parametes.m directly in the main model directory. For each parameter or particle, an entry like

{{        Descriptions -> "Down Squark",
          PDG ->  {1000002,2000002,1000004,2000004,1000006,2000006},
          Width -> Automatic,
          Mass -> Automatic,
          FeynArtsNr -> 13,
          LaTeX -> "\\tilde{u}",
          OutputName -> "um" }},

can be added. In particular, the entry Description is important. This should be an unique identifier for each particle or parameter. This identifier can later on be used in the different files of the different models, e.g.

{Su ,  {  Descriptions -> "Down Squark"}},

Of course, it is also possible to overwrite some of the global definitions by defining them locally, too. For instance, to use u instead of um as output name in a specific model, the entry should be changed to

{Su ,  {  Descriptions -> "Down Squark",
          OutputName -> "u" }},

in the corresponding particle file of the model.

See also

  • Auto-generated templates for particles.m and parameters.m
Clone repository

Home

Index

  • Additional terms in Lagrangian
  • Advanced usage of FlavorKit
  • Advanced usage of FlavorKit to calculate new Wilson coefficients
  • Advanced usage of FlavorKit to define new observables
  • Already defined Operators in FlavorKit
  • Already defined observables in FlavorKit
  • Auto-generated templates for particles.m and parameters.m
  • Automatic index contraction
  • Basic definitions for a non-supersymmetric model
  • Basic definitions for a supersymmetric model
  • Basic usage of FlavorKit
  • Boundary conditions in SPheno
  • CalcHep CompHep
  • Calculation of flavour and precision observables with SPheno
  • Checking the particles and parameters within Mathematica
  • Checks of implemented models
  • Conventions
  • Decay calculation with SPheno
  • Defined FlavorKit parameters
  • Definition of the properties of different eigenstates
  • Delete Particles
  • Different sets of eigenstates
  • Diphoton and digluon vertices with SPheno
  • Dirac Spinors
  • FeynArts
  • Fine-Tuning calculations with SPheno
  • Flags for SPheno Output
  • Flags in SPheno LesHouches file
  • FlavorKit
  • FlavorKit Download and Installation
  • Flavour Decomposition
  • GUT scale condition in SPheno
  • Gauge Symmetries SUSY
  • Gauge Symmetries non-SUSY
  • Gauge fixing
  • Gauge group constants
  • General information about Field Properties
  • General information about model implementations
  • Generating files with particle properties
  • Generic RGE calculation
  • Global Symmetries SUSY
  • Global Symmetries non-SUSY
  • Handling of Tadpoles with SPheno
  • Handling of non-fundamental representations
  • HiggsBounds
  • Higher dimensionsal terms in superpotential
  • Input parameters of SPheno
  • Installation
  • Installing Vevacious
  • LHCP
  • LHPC
  • LaTeX
  • Lagrangian
  • Loop Masses
  • Loop calculations
  • Loop functions
  • Low or High scale SPheno version
  • Main Commands
  • Main Model File
  • Matching to the SM in SPheno
  • MicrOmegas
  • ModelOutput
  • Model files for Monte-Carlo tools
  • Model files for other tools
  • Models with Thresholds in SPheno
  • Models with another gauge group at the SUSY scale
  • Models with several generations of Higgs doublets
  • More precise mass spectrum calculation
  • No SPheno output possible
  • Nomenclature for fields in non-supersymmetric models
  • Nomenclature for fields in supersymmetric models
  • One-Loop Self-Energies and Tadpoles
  • One-Loop Threshold Corrections in Scalar Sectors
  • Options SUSY Models
  • Options non-SUSY Models
  • Parameters.m
  • Particle Content SUSY
  • Particle Content non-SUSY
  • Particles.m
  • Phases
  • Potential
  • Presence of super-heavy particles
  • RGE Running with Mathematica
  • RGEs
  • Renormalisation procedure of SPheno
  • Rotations angles in SPheno
  • Rotations in gauge sector
  • Rotations in matter sector
  • SARAH in a Nutshell
  • SARAH wiki
  • SLHA input for Vevacious
  • SPheno
  • SPheno Higgs production
  • SPheno Output
  • SPheno and Monte-Carlo tools
  • SPheno files
  • SPheno mass calculation
  • SPheno threshold corrections
  • Setting up SPheno.m
  • Setting up Vevacious
  • Setting up the SPheno properties
  • Special fields and parameters in SARAH
  • Superpotential
  • Support of Dirac Gauginos
  • Supported Models
  • Supported gauge sectors
  • Supported global symmetries
  • Supported matter sector
  • Supported options for symmetry breaking
  • Supported particle mixing
  • Tadpole Equations
  • The renormalisation scale in SPheno
  • Tree-level calculations
  • Tree Masses
  • Two-Loop Self-Energies and Tadpoles
  • UFO
  • Usage of tadpoles equations
  • Using SPheno for two-loop masses
  • Using auxiliary parameters in SPheno
  • VEVs
  • Vertices
  • Vevacious
  • WHIZARD