forked from BAllanach/softsusy
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
159 lines (130 loc) · 6.66 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
-------------------------------------------------
SOFTSUSY
-------------------------------------------------
by: B C Allanach, P Athron, A Bednyakov, M Bernhardt, D Grellscheid, M
Hanussek, C H Kom, R Ruiz de Austri, P Slavich, L Tunstall, A
Voigt and A G Williams
QUICK INSTALLATION AND RUN TEST
-------------------------------
See the "INSTALL" file in this directory for installation instructions.
There are five C++ test programs, four of which can be run by the commands
> ./softsusy.x
> ./rpvsoftsusy.x
> ./rpvneut.x
> ./softsusy-nmssm.x
The output from these commands can be checked against outputTest,
rpvOutputTest, neutOutputTest and respectively.
You can run the SUSY Les Houches Accord input provided by running the commands
> ./softpoint.x leshouches < lesHouchesInput
> ./softpoint.x leshouches < slha2Input
> ./softpoint.x leshouches < rpvHouchesInput
You may check the output of these commands against the output files
lesHouchesOutput, slha2Output and rpvHouchesOutput, respectively, that are
provided with the SOFTSUSY distribution
Alternatively, run with command line inputs, for example
> ./softpoint.x nmssm sugra --m0=125 --m12=125 --a0=-300 --tanBeta=10
--lambda=0.1 --lambdaAt Msusy
See the manual (in the doc/ subdirectory) threeLoop.pdf for instructions on
how to switch two-loop threshold corrections/three loop RGEs at run-time, once
they've been compiled.
INTRODUCTION
------------
The most recent version of SOFTSUSY and full documentation can be obtained
from: http://softsusy.hepforge.org/
This program provides a SUSY spectrum in the NMSSM, or the MSSM including
flavour violation and with or without R-parity consistent with input Standard
Model fermion mass/mixings and electroweak/strong coupling data. The R-parity
violating mode can calculate neutrino masses and mixings to 1 loop.
REFERENCES
----------
If you use SOFTSUSY to write a paper, please cite (see MCnet guidelines)
[1] B.C. Allanach, Comput. Phys. Commun. 143 (2002) 305-331, hep-ph/0104145,
which is the SOFTSUSY manual for the R-parity conserving MSSM. If you
calculate in the NMSSM, please cite [1] and
[2] B.C. Allanach, P. Athron, L. Tunstall, A. Voigt and A. Williams,
arXiv:1311.7659.
If you use the R-parity violating aspects, please cite [1] and
[3] B.C. Allanach and M.A. Bernhardt, Comput. Phys. Commun. 181 (2010) 232,
arXiv:0903.1805.
If you use it to calculate neutrino masses and mixings, please cite [1], [3] and
[4] B.C. Allanach, M. Hanussek and C.H. Kom, Comput. Phys. Commun. 183 (2012)
785, arXiv:1109.3735.
If you use the three-loop RGEs or two-loop threshold corrections, please cite
[1] and
[5] B.C. Allanach, A. Bednyakov and R. Ruiz de Autri, arXiv:????.????
CALCULATING DECAYS IN THE NMSSM
-------------------------------
To link with NMSSMTools, so that SOFTSUSY NMSSM output can be piped through it
(to calculate decays, for example), you'll need to download and
NMSSMTools. Then, you can link it using by running
> ./setup_nmssmtools.sh --nmssmtools-dir=/path/to/NMSSMTools --compile
After this, there will be an additional executable ./softsusy_nmssmtools.x
that calculates the spectrum with SOFTSUSY, and decays with NMSSMTools. It can
be run by (for example):
> ./softsusy_nmssmools.x leshouches < inOutFiles/nmssmSLHAnoZ3Input
If you use it, you should of course provide the proper citations to
NMSSMTools. Using the program in this mode, you should make sure in the SLHA
input file that Block SOFTSUSY variables 15 and 17 are set to 1.
If you use SOFTSUSY to write a paper, please cite B.C. Allanach,
Comp. Phys. Comm. 143 (2002) 305, hep-ph/0104145, which is the SOFTSUSY
manual. If you use the R-parity violating aspects, please cite
B.C. Allanach and M.A. Bernhardt, Comp. Phys. Comm. 181 (2010) 232,
arXiv:0903.1805 [hep-ph].
If you use neutrino masses or mixings, please cite
B.C. Allanach, M. Hanussek and C.H. Kom, Comput. Phys. Commun. 183 (2012) 785,
arXiv:1109.3735 [hep-ph].
The manuals on the electronic hep-ph/ archive will be updated with the most
recent version.
There are detailed comparisons between SOFTSUSY and other publicly available
codes in
* Precise Determination of the Neutral Higgs Boson Masses in the MSSM,
B.C. Allanach, A. Djouadi, J.L. Kneur, W. Porod, P. Slavich, JHEP 0409
(2004) 044, hep-ph/0406166,
* Theoretical uncertainties in sparticle mass predictions from
computational tools, B.C. Allanach, S. Kraml, W. Porod, JHEP 03 (2003)
045, hep-ph/0302102
EXECTUABLE FILES: AFTER INSTALLATION
------------------------------------
* softpoint.x: command-line interface. GMSB, AMSB, mSUGRA and general
boundary conditions possible. Main program: src/softpoint.cpp
* softsusy.x: example C++ test program - calculates spectrum of SPS1a
mSUGRA point with varying tan beta. Main program: src/main.cpp
* softsusy-nmssm.x: example NMSSM test program - loops over tan beta. Main
program: src/main-nmssm.cpp
* rpvsoftsusy.x: example C++ test program - calculates spectrum of SPS1a
mSUGRA point with varying lambda'_{331}(M_GUT). Main program:
src/rpvmain.cpp
* rpvneut.x: example neutrino mass calculating R-parity violating
test program.
FILES INCLUDED IN THIS DISTRIBUTION
-----------------------------------
Source files are to be found in the src/ subdirectory.
INPUT AND INFO FILES
--------------------
* [README] contains installation instructions and a list of included files
* [inOutFiles/outputTest] is the output from the test program
* [inOutFiles/slha2Input] is an alternative input file in the SUSY Les
Houches Accord
2 format for SPS1a'
* [inOutFiles/slha2Output] is the result of running with the above input
file and
includes flavour violation, for inclusion into codes like SusyBsg1.3 which
include flavour corrections
* [inOutFiles/lesHouchesInput] is an alternative input file in the SUSY
Les Houches Accord format
* [inOutFiles/rpvHouchesInput] is an alternative input file in the SUSY
Les Houches Accord format for R-parity violation
* [inOutFiles/rpvHouchesOutput] is the output from the R-parity violating
test program rpvmain.cpp
LICENSE
-------
SOFTSUSY Copyright (C) 2007 B.C. Allanach
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
See http://www.gnu.org/licenses/.