-
Notifications
You must be signed in to change notification settings - Fork 7
/
README
183 lines (119 loc) · 5.67 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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
=========
OpenLoops
=========
Copyright 2014 Fabio Cascioli, Jonas Lindert, Philipp Maierhoefer, Stefano Pozzorini
Authors
Fabio Cascioli, [email protected]
Jonas Lindert, [email protected]
Philipp Maierhoefer, [email protected]
Stefano Pozzorini, [email protected]
Contact
If you would like to receive notifications about OpenLoops updates and news
per e-mail, please sign up to our mailing list at
https://www.hepforge.org/lists/listinfo/openloops-announce
OpenLoops is a Fortran 90 package for the calculation of tree and one-loop
matrix elements for Standard Model processes based on
F. Cascioli, P. Maierhoefer and S. Pozzorini,
Phys. Rev. Lett. 108 (2012) 111601, arXiv:1111.5206
License
OpenLoops 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.
OpenLoops 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.
You should have received a copy of the GNU General Public License
along with OpenLoops. If not, see <http://www.gnu.org/licenses/>.
============
Installation
============
Requirements
gfortran 4.6 or later, or ifort
Python 2.x starting with 2.4
Apache Subversion (optional, to install from SVN)
You can either download OpenLoops from SVN (recommended)
svn checkout http://openloops.hepforge.org/svn/OpenLoops/branches/public OpenLoops
or from the OpenLoops web page
http://www.hepforge.org/downloads
Compile
cd OpenLoops
./scons
Download and compile process libraries
./openloops libinstall <processes>
where <processes> is a white space separated list of the processes or
process collections (with suffix ".coll") which should be installed.
Some process collections are defined in the process repository (in
particular "all.coll" to install all processes from the repository).
User-defined collections can be set up as plain text files with file
extension ".coll" with line break separated names of process libraries.
A list of the available process libraries can be found here
http://openloops.hepforge.org/processes
Process libraries usually include all real correction processes required
for an NLO calculation. However these processes are not compiled by default.
Note that Sherpa uses its own matrix elements for real corrections, thus
compiling OpenLoops real corrections is not required for usage with Sherpa.
In order to activate the compilation of real corrections, create a file named
"openloops.cfg" in your installation directory which contains the following
(besides other options which you might have set):
[OpenLoops]
compile_extra = 1
The set of available processes will be extended continuously.
If you need a process which is not (yet) available, please contact the
OpenLoops authors.
======================================
Update OpenLoops and process libraries
======================================
Note that automatic updates of the process independent OpenLoops code
are only supported when OpenLoops was installed from SVN.
To update from SVN and update all installed processes
./openloops update
To only update installed processes, but not OpenLoops itself
(this also works when OpenLoops was not installed from SVN)
./openloops update --processes
Updating individual process libraries works the same way as installing
new processes.
./openloops libinstall <processes>
If process collections are used, new processes in the collection
will be installed and previously installed processes will be updated
if newer versions are available. E.g.
./openloops libinstall all.coll
Updating/installing processes also creates/updates a local database
of all processes which are available for download. This database is used
at runtime to report if a requested process is available for download,
if it is not yet installed.
=====================
Support and citations
=====================
Please help us improving OpenLoops by sending feedback to
If you use OpenLoops (or an event sample generated with Sherpa+OpenLoops)
please cite
F. Cascioli, P. Maierhoefer and S. Pozzorini,
Phys. Rev. Lett. 108 (2012) 111601, arXiv:1111.5206
In the computation of loop amplitudes, OpenLoops uses CutTools for OPP reduction
and OneLOop to compute scalar integrals (unless other reduction libraries are
installed and used). If you use CutTools and OneLOop please cite
G. Ossola, C. Papadopoulos, R. Pittau, JHEP 0803 (2008) 042, arXiv:0711.3596
A. van Hameren, Comput. Phys. Commun. 182 (2011) 2427-2438, arXiv:1007.4716
================
Sherpa+OpenLoops
================
OpenLoops can be used as a plug-in of Sherpa 2.1.0 or later. For the
installation of Sherpa and the usage of Sherpa+OpenLoops please refer to the
Sherpa documentation at
https://sherpa.hepforge.org
OpenLoops must be enabled by configuring Sherpa with the '--enable-openloops'
option
./configure --enable-openloops=</path/to/OpenLoops> [other configure options]
make
make install
The OpenLoops installation path can be modified at runtime by setting
(in the Sherpa run card or command line)
OL_PREFIX=</path/to/OpenLoops>
To run Sherpa in combination with OpenLoops it is sufficient to set the flag
Loop_Generator=OpenLoops
in the Sherpa runcard. Standard Sherpa+OpenLoops run cards can be found at
http://openloops.hepforge.org/sherpa-runcards