Commit 7ea18c56 authored by Juergen Reuter's avatar Juergen Reuter
Browse files

Updating the manual to include changes according to svn build and compiler update.

parent 8637057d
......@@ -99,7 +99,7 @@
<p>
<b> The manual for WHIZARD 2 </b> is not yet completed. We
regularly update the version from the distributions (<a href="manual.pdf">
link</a>, last update: 2016-08-25).
link</a>, last update: 2016-11-29).
There is also a
<a href="manual">HTML version of the manual</a>.
You can find a few
......@@ -344,7 +344,9 @@
http://whizard.hepforge.org/svn/trunk</a> for <i>checking out</i>
(pun intended!) the current sources. Note, that the svn
contains the latest developer version. In order to be able to
compile the svn version, one has to first generate the <em>configure</em>
compile the svn version, one has to first generate the <em>configure.ac</em>
by executing the shell script <em>build_master.sh</em>, then generate
the <em>configure</em>
script out of the file <em>configure.ac</em> by running
<em>autoreconf</em> (NOT <em>autoconf</em>) which is part of
the <em>autoconf/automake</em>
......
No preview for this file type
This diff is collapsed.
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Contents</title>
</head>
......
No preview for this file type
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 1  Introduction</title>
</head>
......
manual/manual002.png

5.08 KB | W: | H:

manual/manual002.png

5.08 KB | W: | H:

manual/manual002.png
manual/manual002.png
manual/manual002.png
manual/manual002.png
  • 2-up
  • Swipe
  • Onion skin
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 2  Installation</title>
</head>
......@@ -69,8 +69,8 @@ the current stable distribution from the <span style="font-family:monospace">WHI
hosted at the HepForge webpage
</p><blockquote class="quote">
<a href="http://whizard.hepforge.org"><span style="font-family:monospace">http://whizard.hepforge.org</span></a></blockquote><p>
The distribution is a single file, say <span style="font-family:monospace">whizard-2.4.0.tgz</span> for
version 2.4.0.</p><p>You need the additional prerequisites:
The distribution is a single file, say <span style="font-family:monospace">whizard-2.4.1.tgz</span> for
version 2.4.1.</p><p>You need the additional prerequisites:
</p><ul class="itemize"><li class="li-itemize">
GNU <span style="font-family:monospace">tar</span> (or <span style="font-family:monospace">gunzip</span> and <span style="font-family:monospace">tar</span>) for unpacking the
tarball.
......@@ -113,12 +113,12 @@ against an external version of <span style="font-family:monospace">STDHEP</span>
on. Nevertheless, we list some explanations in Sec. <a href="#sec%3Astdhep">2.2.10</a>.
Once these prerequisites are met, you may unpack the package in a
directory of your choice
</p><blockquote class="quote"><span style="font-size:small"><span style="font-family:monospace">some-directory&gt; tar xzf whizard-2.4.0.tgz
</p><blockquote class="quote"><span style="font-size:small"><span style="font-family:monospace">some-directory&gt; tar xzf whizard-2.4.1.tgz
</span></span></blockquote><p>
and proceed.<sup><a id="text11" href="#note11">2</a></sup> </p><p>For using external physics models that are directly supported by
<span style="font-family:monospace">WHIZARD</span> and <span style="font-family:monospace">O’Mega</span>, the user can use tools like <span style="font-family:monospace">SARAH</span> or
<span style="font-family:monospace">FeynRules</span>. There installation and linking to <span style="font-family:monospace">WHIZARD</span> will be
explained in Chap. <a href="manual018.html#chap%3Aextmodels">17</a>.</p><p>The directory will then contain a subdirectory <span style="font-family:monospace">whizard-2.4.0</span>
explained in Chap. <a href="manual018.html#chap%3Aextmodels">17</a>.</p><p>The directory will then contain a subdirectory <span style="font-family:monospace">whizard-2.4.1</span>
where the complete source tree is located. To update later to a new
version, repeat these steps. Each new version will unpack in a
separate directory with the appropriate name.</p>
......@@ -143,7 +143,9 @@ To start, go to a directory of your choice and execute
</span></pre><p>The SVN source tree will appear in the current directory. To update
later, you just have to execute
</p><pre class="verbatim"><span style="font-size:small"> your-src-directory&gt; svn update
</span></pre><p>within that directory.</p><p>After checking out the sources, run<sup><a id="text14" href="#note14">5</a></sup>
</span></pre><p>within that directory.</p><p>After checking out the sources, you first have to create
<span style="font-family:monospace">configure.ac</span> by executing the shell script
<span style="font-family:monospace">build_master.sh</span>. Afterwards, run<sup><a id="text14" href="#note14">5</a></sup>
</p><pre class="verbatim"><span style="font-size:small"> your-src-directory&gt; autoreconf
</span></pre><p>This will generate a <span style="font-family:monospace">configure</span> script.</p>
<h3 id="sec:compilers" class="subsection">2.2.4  Fortran Compilers</h3>
......@@ -151,11 +153,14 @@ later, you just have to execute
subset of the <span style="font-family:monospace">Fortran2003</span> standard. At the time of this writing,
this subset is supported by, at least, the following compilers:
</p><ul class="itemize"><li class="li-itemize">
<span style="font-family:monospace">gfortran</span> (GNU, Open Source). You will need version 4.7.4
or higher<sup><a id="text15" href="#note15">6</a></sup>.
<span style="font-family:monospace">gcc</span> 4.7.1-3 suffer from too many bugs in the object-orientation.
</li><li class="li-itemize"><span style="font-family:monospace">nagfor</span> (NAG). You will need version 5.2 or higher.
</li><li class="li-itemize"><span style="font-family:monospace">ifort</span> (Intel). You will need version 16.0.0 or higher.
<span style="font-family:monospace">gfortran</span> (GNU, Open Source). You will need version 4.8.0
or higher<sup><a id="text15" href="#note15">6</a></sup>. We recommend to use at
least version 4.8.4 or 4.9.4, as especially the the early version of
4.8.X and 4.9.X experience some severe bugs.
</li><li class="li-itemize"><span style="font-family:monospace">nagfor</span> (NAG). You will need version 6.0 or higher.
</li><li class="li-itemize"><span style="font-family:monospace">ifort</span> (Intel). You will need version 16.0.0 or
higher. Unfortunately, versions 17.0.0 and 17.0.1 show a severe
regression and cannot be used.
</li></ul><p>
There are some commercial compilers that might be able to compile
<span style="font-family:monospace">WHIZARD</span> 2.4 in the near future, but at the time of writing, all of
......@@ -163,7 +168,7 @@ the compilers listed below contained compiler bugs. Consult the
<span style="font-family:monospace">WHIZARD</span> website for updates on this situation.
</p><ul class="itemize"><li class="li-itemize">
<span style="font-family:monospace">pgfortran</span> (PGI). You will need a more modern version than
15.10.
16.11.
</li><li class="li-itemize">ekopath. You will need a more modern version than 4.0.
</li></ul>
<h3 id="sec14" class="subsection">2.2.5  LHAPDF</h3>
......@@ -205,7 +210,7 @@ output (for <span style="font-family:monospace">LHAPDF</span> version 6 or newer
configure:
checking for lhapdf... /usr/local/bin/lhapdf
checking for lhapdf-config... /usr/local/bin/lhapdf-config
checking the LHAPDF version... 6.1.3
checking the LHAPDF version... 6.1.6
checking the major version... 6
checking the LHAPDF pdfsets path... /usr/local/share/LHAPDF
checking the standard PDF sets... all standard PDF sets installed
......@@ -1190,23 +1195,29 @@ Unfortunately, the version of the <span style="font-family:monospace">OCaml</spa
compiler from 3.12.0 broke backwards compatibility. Therefore,
versions of <span style="font-family:monospace">O’Mega</span>/<span style="font-family:monospace">WHIZARD</span> up to 2.0.2 only compile with older
versions (3.11.x works). This has been fixed in versions
2.0.3 and later. See also Sec. <a href="#sec%3Abuildproblems">2.5.1</a>.</div></dd><dt class="dt-thefootnotes"><a id="note11" href="#text11">2</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Without GNU <span style="font-family:monospace">tar</span>, this would read
<span style="font-family:monospace"><span style="font-size:small">gunzip -c whizard-2.4.0.tgz | tar xz -</span></span></div></dd><dt class="dt-thefootnotes"><a id="note12" href="#text12">3</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">In
2.0.3 and later. See also Sec. <a href="#sec%3Abuildproblems">2.5.1</a>.</div>
</dd><dt class="dt-thefootnotes"><a id="note11" href="#text11">2</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Without GNU <span style="font-family:monospace">tar</span>, this would read
<span style="font-family:monospace"><span style="font-size:small">gunzip -c whizard-2.4.1.tgz | tar xz -</span></span></div>
</dd><dt class="dt-thefootnotes"><a id="note12" href="#text12">3</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">In
Ubuntu from version 10.04 on, and in Debian since
squeeze. For <span style="font-family:monospace">Mac OS X</span>, <span style="font-family:monospace">noweb</span> is available via the
<span style="font-family:monospace">MacPorts</span> system.</div></dd><dt class="dt-thefootnotes"><a id="note13" href="#text13">4</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Please, do not use any of the binary builds from this
webpage. Probably all of them are quite old and broken.</div></dd><dt class="dt-thefootnotes"><a id="note14" href="#text14">5</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">At least, version 2.65 of
the <span style="font-family:monospace">autoconf</span> package is required.</div></dd><dt class="dt-thefootnotes"><a id="note15" href="#text15">6</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Note that <span style="font-family:monospace">WHIZARD</span> versions 2.0.0 until 2.1.1 compiled
with <span style="font-family:monospace">gfortran</span> 4.5.x and 4.6.x, but the object-oriented
refactoring of the <span style="font-family:monospace">WHIZARD</span> code from 2.2 on made a switch to
<span style="font-family:monospace">gfortran</span> 4.7.4 or higher necessary. <span style="font-family:monospace">gcc</span> 4.7.0 contains a
major bug in the static <span style="font-family:monospace">libstdc++</span> library which prevented
static builds of <span style="font-family:monospace">WHIZARD</span> with external <span style="font-family:monospace">C++</span> libraries.</div></dd><dt class="dt-thefootnotes"><a id="note16" href="#text16">7</a></dt><dd class="dd-thefootnotes"><div class="footnotetext"> Note that
<span style="font-family:monospace">MacPorts</span> system.</div>
</dd><dt class="dt-thefootnotes"><a id="note13" href="#text13">4</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Please, do not use any of the binary builds from this
webpage. Probably all of them are quite old and broken.</div>
</dd><dt class="dt-thefootnotes"><a id="note14" href="#text14">5</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">At least, version
2.65 of the <span style="font-family:monospace">autoconf</span> package is required.</div>
</dd><dt class="dt-thefootnotes"><a id="note15" href="#text15">6</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Note that <span style="font-family:monospace">WHIZARD</span> versions 2.0.0 until 2.3.1 compiled
with <span style="font-family:monospace">gfortran</span> 4.7.4, but the object-oriented
refactoring of the <span style="font-family:monospace">WHIZARD</span> code from 2.4 on made a switch to
<span style="font-family:monospace">gfortran</span> 4.8.0 or higher necessary.</div>
</dd><dt class="dt-thefootnotes"><a id="note16" href="#text16">7</a></dt><dd class="dd-thefootnotes"><div class="footnotetext"> Note that
PDF sets which contain photons as partons are only supported with
<span style="font-family:monospace">WHIZARD</span> for <span style="font-family:monospace">LHAPDF</span> version 5.7.1 or higher</div></dd><dt class="dt-thefootnotes"><a id="note17" href="#text17">8</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">This holds for simple workflow. In
<span style="font-family:monospace">WHIZARD</span> for <span style="font-family:monospace">LHAPDF</span> version 5.7.1 or higher</div>
</dd><dt class="dt-thefootnotes"><a id="note17" href="#text17">8</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">This holds for simple workflow. In
case of scans and repeated integrations of the same process, there
may be name clashes on the written files which prevent resuming. A
future <span style="font-family:monospace">WHIZARD</span> version will address this problem.</div></dd></dl>
future <span style="font-family:monospace">WHIZARD</span> version will address this problem.</div>
</dd></dl>
<hr>
<a href="manual002.html"><img src="previous_motif.gif" alt="Previous"></a>
<a href="index.html"><img src="contents_motif.gif" alt="Up"></a>
......
No preview for this file type
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 3  Getting Started</title>
</head>
......@@ -106,7 +106,7 @@ named <code>hello.sin</code>.</p><blockquote class="figure"><div class="center">
| M. Moretti, T. Ohl, J. Reuter, arXiv: hep-ph/0102195 |
| |
|=============================================================================|
| WHIZARD 2.4.0
| WHIZARD 2.4.1
|=============================================================================|
| Reading model file '/usr/local/share/whizard/models/SM.mdl'
| Preloaded model: SM
......@@ -137,7 +137,7 @@ including the <span style="font-family:monospace">WHIZARD</span> banner is shown
<span style="font-size:small">
</span></p><pre class="verbatim"><span style="font-size:small">| Writing log to 'whizard.log'
</span></pre><div class="center"><span style="font-size:small">[... here a banner is displayed]</span></div><pre class="verbatim"><span style="font-size:small">|=============================================================================|
| WHIZARD 2.4.0
| WHIZARD 2.4.1
|=============================================================================|
| Reading model file '/usr/local/share/whizard/models/SM.mdl'
| Preloaded model: SM
......@@ -181,7 +181,7 @@ As before, you save this text in a file (named, e.g.,
This produces a lot of output which looks similar to this:</p><pre class="verbatim"><span style="font-size:small"> | Writing log to 'whizard.log'
[... banner ...]
|=============================================================================|
| WHIZARD 2.4.0
| WHIZARD 2.4.1
|=============================================================================|
| Reading model file '/usr/local/share/whizard/models/SM.mdl'
| Preloaded model: SM
......
manual/manual004.png

3.34 KB | W: | H:

manual/manual004.png

3.32 KB | W: | H:

manual/manual004.png
manual/manual004.png
manual/manual004.png
manual/manual004.png
  • 2-up
  • Swipe
  • Onion skin
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 4  Steering WHIZARD: SINDARIN Overview</title>
</head>
......
No preview for this file type
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 5  Detailed WHIZARD Steering: SINDARIN</title>
</head>
......@@ -2399,7 +2399,7 @@ density matrix:
<br>
<br>
</td></tr>
</table></td></tr>
</table></td><td class="dcell"> </td></tr>
</table>
(for antiparticles, the matrix is conjugated).
</li><li class="li-itemize"><span style="font-weight:bold">Polarization along arbitrary axis </span>(θ, φ)<span style="font-weight:bold">:</span>
......@@ -3940,20 +3940,25 @@ does not correctly reproduce the total cross section.
<a id="note18" href="#text18">1</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">In older versions of <span style="font-family:monospace">WHIZARD</span>, until v2.1.1, there
used to be separate comparators for the comparisons up to a tolerance,
namely <span style="font-family:monospace">==~</span> and <span style="font-family:monospace">&lt;&gt;~</span>. These have been discarded from
v2.2.0 on in order to simplify the syntax.</div></dd><dt class="dt-thefootnotes"><a id="note19" href="#text19">2</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">In older versions of <span style="font-family:monospace">WHIZARD</span>,
v2.2.0 on in order to simplify the syntax.</div>
</dd><dt class="dt-thefootnotes"><a id="note19" href="#text19">2</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">In older versions of <span style="font-family:monospace">WHIZARD</span>,
until v2.1.1, there also used to be a <span style="font-family:monospace">sprintd</span> function and a
<span style="font-family:monospace">printd</span> command for default formats without a format
string. They have been discarded in order to simplify the syntax
from version v2.2.0 on.</div></dd><dt class="dt-thefootnotes"><a id="note20" href="#text20">3</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">In future versions of <span style="font-family:monospace">WHIZARD</span> it is foreseen to
implement other electroweak schemes.</div></dd><dt class="dt-thefootnotes"><a id="note21" href="#text21">4</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Until
from version v2.2.0 on.</div>
</dd><dt class="dt-thefootnotes"><a id="note20" href="#text20">3</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">In future versions of <span style="font-family:monospace">WHIZARD</span> it is foreseen to
implement other electroweak schemes.</div>
</dd><dt class="dt-thefootnotes"><a id="note21" href="#text21">4</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Until
<span style="font-family:monospace">WHIZARD</span> version 2.2.1 including, only the <span style="font-family:monospace">LHAPDF</span> series 5 was
supported, while from version 2.2.2 on also the <span style="font-family:monospace">LHAPDF</span> release
series 6 has been supported.</div></dd><dt class="dt-thefootnotes"><a id="note22" href="#text22">5</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Note that
series 6 has been supported.</div>
</dd><dt class="dt-thefootnotes"><a id="note22" href="#text22">5</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">Note that
the syntax for the specification of beam polarization has changed
from version v2.1 to v2.2 and is incompatible between the two
release series. The old syntax <span style="font-family:monospace">beam_polarization</span> with its
different polarization constructors has been discarded in favor of a
unified syntax.</div></dd></dl>
unified syntax.</div>
</dd></dl>
<hr>
<a href="manual005.html"><img src="previous_motif.gif" alt="Previous"></a>
<a href="index.html"><img src="contents_motif.gif" alt="Up"></a>
......
manual/manual006.png

6.05 KB | W: | H:

manual/manual006.png

6.44 KB | W: | H:

manual/manual006.png
manual/manual006.png
manual/manual006.png
manual/manual006.png
  • 2-up
  • Swipe
  • Onion skin
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 6  Random number generators</title>
</head>
......
manual/manual007.png

5.61 KB | W: | H:

manual/manual007.png

6.05 KB | W: | H:

manual/manual007.png
manual/manual007.png
manual/manual007.png
manual/manual007.png
  • 2-up
  • Swipe
  • Onion skin
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 7  Integration Methods</title>
</head>
......
manual/manual008.png

5.48 KB | W: | H:

manual/manual008.png

5.61 KB | W: | H:

manual/manual008.png
manual/manual008.png
manual/manual008.png
manual/manual008.png
  • 2-up
  • Swipe
  • Onion skin
<!DOCTYPE html>
<html >
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="hevea 2.25">
<meta name="generator" content="hevea 2.09">
<link rel="stylesheet" type="text/css" href="manual.css">
<title>Chapter 8  Phase space parameterizations</title>
</head>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment