== The most general Minimal Supersymmetric Standard Model ==
=== Author ===

[http://www.cern.ch/fuks Benjamin Fuks]
   * IPHC Strasbourg / University of Strasbourg 
   * fuks@cern.ch
 
=== Description of the model & references ===

One popular Beyond the Standard Model theory is the Minimal Supersymmetric Standard Model (MSSM). Its main features are to link bosons with fermions and unify internal and external symmetries. Moreover, it allows for a stabilization of the gap between the Planck and the electroweak scale and for gauge coupling unification at high energies, provides a dark matter candidate as the lightest supersymmetric particle and appears naturally in string theories. However, since supersymmetric particles have not yet been discovered, supersymmetry must be broken at low energies, which makes the superpartners massive in comparison to their Standard Model counterparts.

Our MSSM implementation in !FeynRules is the most general one in a sense that it is keeping all the flavour-violating and helicity-mixing terms in the Lagrangian and also all the possible additional CP-violating phases. This yields thus 105 new free parameters. In order to deal in a transparent way with all of those, our implementation will follow the commonly used universal set of conventions provided by the Supersymmetry Les Houches Accord, except for some minor points (see instructions below).

The current version of the model, compatible with !FeynRules v1.6.0 and below used the [http://www-library.desy.de/cgi-bin/spiface/find/hep/www?eprint=arXiv:1102.4191 superspace module] of !FeynRules.

   * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=FIND+A+NILLES+AND+D+1983+and+j+phys+rept&FORMAT=www&SEQUENCE= Phys.Rept.110 (1984) 1]: H. P. Nilles, ''Supersymmetry, Supergravity and Particle Physics''. 
   * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=FIND+A+HABER+AND+A+KANE+AND+D+1984+and+j+phys+rept&FORMAT=www&SEQUENCE= Phys.Rept.117 (1985) 75]: H. E. Haber and G. L. Kane, ''The Search for Supersymmetry: Probing Physics Beyond the Standard Model.'' 
   * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=a+rosiek+and+t+Complete+Set+of+Feynman+Rules&FORMAT=WWW&SEQUENCE= Phys.Rev.D41 (1990) 3464]: J. Rosiek, ''Complete Set of Feynman Rules for the Minimal Supersymmetric Extension of the Standard Model.''
   * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=t+susy+primer&FORMAT=WWW&SEQUENCE= hep-ph/9709356]: S. P. Martin, ''A Supersymmetry primer.'' 
   * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=FIND+T+SUSY+LES+HOUCHES+and+j+JHEP&FORMAT=www&SEQUENCE= JHEP 0407 (2004) 36]: P. Skands ''et al'', ''SUSY Les Houches accord: Interfacing SUSY spectrum calculators, decay packages, and event generators'' ''.''
   * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=FIND+T+SUSY+LES+HOUCHES+and+j+comput+phys+commun&FORMAT=www&SEQUENCE= Comput.Phys.Commun.180 (2009) 8]: B. C. Allanach ''et al'', ''SUSY Les Houches Accord 2.'' 

=== Model files ===

   * [/attachment/wiki/MSSM/mssm.fr mssm.fr]: MSSM implementation using the superspace module (compatible with !FeynRules 1.6.x)
   * [/attachment/wiki/MSSM/ParamCard.dat sps1a]: parameter file to be read, associated to the sps1a scenario.
   * [/attachment/wiki/MSSM/SUSY.nb MSSM.nb]: Example of a Mathematica® notebook loading the model and the parameters. 

   * [/attachment/wiki/MSSM/susy1.0.1.tgz susy1.0.1.tgz (05.07.09)]: Old MSSM implementation (compatible with !FeynRules 1.4.x), with the corresponding [/attachment/wiki/MSSM/FRT_paramcard.dat parameter file] for the sps1a benchmark point, and the old  [/attachment/wiki/MSSM/SUSY.nb example notebook].

=== Sepcific instructions ===

   * The switch __FeynmanGauge__ allows to choose between Feynman and unitarity gauge.
   * The flags __$CKMDiag__ and __$MNSDiag__, being set to __True__ or __False__, allow for CKM and PMNS matrices different from the identity or not. 
   * A parameter file __must__ be loaded before running the model, or all the parameters would have a value of -1 (__ReadLHAFile[Input->"myfile"]__). 

=== Optimized matrix element generator models for sps1a (removal of all zero terms in the vertices) ===

||[/attachment/wiki/MSSM/sps1a_ch.tgz sps1a_ch.tgz]||The model files for !CalcHep.||
||[/attachment/wiki/MSSM/sps1a_fa.tgz sps1a_fa.tgz]||The model files for !FeynArts.||
||[/attachment/wiki/MSSM/sps1a_mg.tgz sps1a_mg.tgz]||The model files for !MadGraph 4.||
|| Not supported || The model files for Sherpa.||
||[/attachment/wiki/MSSM/sps1a_ufo.tgz sps1a_ufo.tgz ]||The model files in UFO format (e.g. for !MadGraph 5).||
||[/attachment/wiki/MSSM/sps1a_wo.tgz sps1a_wo.tgz]||The model files for Whizard.||

=== Validation ===

In order to validate our implementation, we have performed the following tests.
   * '''!FeynArts model file generated by !FeynRules''': recalculation of the helicity amplitudes related to the hadroproduction of a pair of supersymmetric particles and comparison with the three references: 
      * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=FIND+A+B+FUKS+AND+T+SQUARK+and+t+flavour&FORMAT=www&SEQUENCE= Nucl. Phys. B787 (2007) 1]: G. Bozzi, B. Fuks, B. Herrmann and M. Klasen, ''Squark and gaugino hadroproduction and decays in non-minimal flavour violating supersymmetry.'' 
      * [http://www.slac.stanford.edu/spires/find/hep/www?rawcmd=FIND+A+B+FUKS+AND+t+gauge-mediated&FORMAT=www&SEQUENCE= Nucl. Phys. B810 (2009) 266]: B. Fuks, B. Herrmann and M. Klasen, ''Flavour Violation in Gauge-Mediated Supersymmetry Breaking Models: Experimental Constraints and Phenomenology at the LHC.'' 
      * B. Fuks '', private communication''. 
   * '''Comparison of the built-in CalcHEP (CH-ST) and !MadGraph (MG-ST) model files with the !FeynRules generated ones, MG-FR and CH-FR,''' through the calculation of various quantities. For each implementation, we have fixed all the parameters to those of __SPS 1a__ and set the __widths of the particles to zero__. 
      * '''1 to 2''' decay widths for all Standard Model particles and their superpartners (320 channels), for MG-FR and MG-ST: [/attachment/wiki/MSSM/decay.tgz decay.tgz]. 
      * '''2 to 2''' cross sections related to the production of any pair of particles from a Standard Model initial state of __2x600 GeV__ and __2x1000 GeV__, and for the four implementations CH-ST, CH-FR, MG-ST and MG-FR. __CalcHEP is run in unitary gauge__.
         * Leptonic initial states (twice 149 channels): [/attachment/wiki/MSSM/lept.tgz lept.tgz]. 
         * Quark initial state (twice 181 channels): [/attachment/wiki/MSSM/quark.tgz quark.tgz]. 
         * Gauge boson initial states (twice 291 channels): [/attachment/wiki/MSSM/vv.tgz vv.tgz]. 
         * Other (twice 15 channels): [/attachment/wiki/MSSM/other.tgz other.tgz].
      * '''2 to 3''' matrix element evaluation for given phase space points: not available yet. 
      * Note: we have __some disagreements__ (red spots in the jpg-files). They are due to 
         * A certain amount of __bugs in the CH-ST implementation__.
         * __Massless propagators in t-channel diagrams__ leading to unreliable results for all implementations. We have tested here unintegrated matrix elements for 100 different phase space points: [/attachment/wiki/MSSM/sa.tgz sa.tgz].