|
Appendix A SINDARIN Reference
In the SINDARIN language, there are certain pre-defined constructors or
commands that cannot be used in different context by the user, which
are e.g. alias, beams, integrate, simulate etc.
A complete list will be given below. Also units are fixed, like
degree, eV, keV,
MeV, GeV, and TeV. Again, these tags are locked and
not user-redefinable. Their functionality will be listed in detail
below, too. Furthermore, a variable with a preceding
question mark, ?, is a logical, while a preceding dollar, $, denotes a
character string variable. Also, a lot of unary and binary operators
exist, + - \ , = : => < > <= >= () [] {}
==, as well as quotation marks, ". Note that the
different parentheses and brackets fulfill different purposes, which
will be explained below. Comments in a line can either be marked by a
hash, #, or an exclamation mark, !.
A.1 Commands and Operators
We begin the SINDARIN reference with all commands, operators, functions
and constructors.
The list of variables (which can be set to change behavior of WHIZARD) can
be found in the next section.
-
+
1) Arithmetic operator for addition of integers, reals and complex
numbers. Example: real mm = mH + mZ (cf. also -, *,
/, ^). 2) It also adds different particles for inclusive
process containers: process foo = e1, E1 => (e2, E2) + (e3,
E3). 3) It also serves as a shorthand notation for the
concatenation of (→) combine operations on
particles/subevents, e.g. cuts = any 170 GeV < M < 180 GeV [b +
lepton + invisible].
- -
Arithmetic operator for subtraction of integers, reals and complex
numbers. Example: real foo = 3.1 - 5.7 (cf. also +, *,
/, ^).
- /
Arithmetic operator for division of integers, reals and complex
numbers. Example: scale = mH / 2 (cf. also +, *,
-, ^).
- *
Arithmetic operator for multiplication of integers, reals and complex
numbers. Example: complex z = 2 * I (cf. also +, /,
-, ^).
- ^
Arithmetic operator for exponentiation of integers, reals and complex
numbers. Example: real z = x^2 + y^2 (cf. also +,
/, -, ^).
- <
Arithmetic comparator between values that checks for ordering
of two values: <val1> < <val2> tests whether
val1 is smaller than val2. Allowed for
integer and real values. Note that this is an exact comparison if
tolerance is set to zero. For a finite value of tolerance
it is a “fuzzy” comparison. (cf. also tolerance, <>,
==, >, >=, <=)
- >
Arithmetic comparator between values that checks for ordering
of two values: <val1> > <val2> tests whether
val1 is larger than val2. Allowed for
integer and real values. Note that this is an exact comparison if
tolerance is set to zero. For a finite value of tolerance
it is a “fuzzy” comparison. (cf. also tolerance, <>,
==, >, >=, <=)
- <=
Arithmetic comparator between values that checks for ordering
of two values: <val1> <= <val2> tests whether
val1 is smaller than or equal val2. Allowed for
integer and real values. Note that this is an exact comparison if
tolerance is set to zero. For a finite value of tolerance
it is a “fuzzy” comparison. (cf. also tolerance, <>,
==, >, <, >=)
- >=
Arithmetic comparator between values that checks for ordering
of two values: <val1> >= <val2> tests whether
val1 is larger than or equal val2. Allowed for
integer and real values. Note that this is an exact comparison if
tolerance is set to zero. For a finite value of tolerance
it is a “fuzzy” comparison. (cf. also tolerance, <>,
==, >, <, >=)
- ==
Arithmetic comparator between values that checks for identity
of two values: <val1> == <val2>. Allowed for
integer and real values. Note that this is an exact comparison if
tolerance is set to zero. For a finite value of tolerance
it is a “fuzzy” comparison. (cf. also tolerance, <>,
>, <, >=, <=)
- <>
Arithmetic comparator between values that checks for
two values being unequal: <val1> <> <val2>. Allowed for
integer and real values. Note that this is an exact comparison if
tolerance is set to zero. For a finite value of tolerance
it is a “fuzzy” comparison. (cf. also tolerance, ==,
>, <, >=, <=)
- !
The exclamation mark tells SINDARIN that everything that follows in
that line should be treated as a comment. It is the same as (→)
#.
- #
The hash tells SINDARIN that everything that follows in
that line should be treated as a comment. It is the same as (→)
!.
- &
Concatenates two or more particle lists/subevents and hence acts in
the same way as the subevent function (→) join: let
@visible = [photon] & [colored] & [lepton] in .... (cf. also
join, combine, collect, extract, sort).
- $
Constructor at the beginning of a variable name,
$<string_var>, that specifies a string variable.
- @
Constructor at the beginning of a variable name, @<subevt_var>, that specifies a subevent variable, e.g. let
@W_candidates = combine ["mu-", "numubar"] in ....
- =
Binary constructor to appoint values to commands, e.g. <command>
= <expr> or
<command> <var_name> =
<expr>.
- %
Constructor that gives the percentage of a number, so in
principle multiplies a real number by 0.01. Example: 1.23
% is equal to 0.0123.
- :
Separator in alias expressions for particles, e.g. alias neutrino
= n1:n2:n3:N1:N2:N3. (cf. also alias)
- ;
Concatenation operator for logical expressions: lexpr1 ;
lexpr2. Evaluates lexpr1 and throws the result
away, then evaluates lexpr2 and returns that result. Used
in analysis expressions. (cf. also analysis, record)
- /+
Incrementor for (→) scan ranges, that increments additively,
scan <num_spec> <num> = (<lower val> => <upper
val> /+ <step
size>). E.g. scan int i = (1 => 5 /+ 2) scans over the values 1,
3, 5. For real ranges, it divides the interval between
upper and lower bound into as many intervals as the incrementor
provides, e.g. scan real r = (1 => 1.5 /+ 0.2) runs over
1.0, 1.333, 1.667, 1.5.
- /+/
Incrementor for (→) scan ranges, that increments additively,
but the number after the incrementor is the number of steps, not the
step size: scan <num_spec> <num> = (<lower val> =>
<upper val>
/+/ <steps>). It is only available for real scan ranges, and divides
the interval <upper val> - <lower val> into
<steps> steps,
e.g. scan real r = (1 => 1.5 /+/ 3) runs over 1.0,
1.25, 1.5.
- /-
Incrementor for (→) scan ranges, that increments subtractively,
scan <num_spec> <num> = (<lower val> => <upper val> /- <step
size>). E.g. scan int i = (9 => 0 /+ 3) scans over the values 9,
6, 3, 0. For real ranges, it divides the interval
between upper and lower bound into as many intervals as the incrementor
provides, e.g. scan real r = (1 => 0.5 /- 0.2) runs over
1.0, 0.833, 0.667, 0.5.
- /*
Incrementor for (→) scan ranges, that increments multiplicatively,
scan <num_spec> <num> = (<lower val> => <upper val> /* <step
size>). E.g. scan int i = (1 => 4 /* 2) scans over the values 1,
2, 4. For real ranges, it divides the interval
between upper and lower bound into as many intervals as the incrementor
provides, e.g. scan real r = (1 => 5 /* 2) runs over
1.0, 2.236 (i.e. √5), 5.0.
- /*/
Incrementor for (→) scan ranges, that increments multiplicatively,
but the number after the incrementor is the number of steps, not the
step size: scan <num_spec> <num> = (<lower val> => <upper val>
/*/ <steps>). It is only available for real scan ranges, and divides
the interval <upper val> - <lower val> into <steps> steps,
e.g. scan real r = (1 => 9 /*/ 4) runs over 1.000,
2.080, 4.327, 9.000.
- //
Incrementor for (→) scan ranges, that increments by division,
scan <num_spec> <num> = (<lower val> => <upper val> // <step
size>). E.g. scan int i = (13 => 0 // 3) scans over the values 13,
4, 1, 0. For real ranges, it divides the interval
between upper and lower bound into as many intervals as the incrementor
provides, e.g. scan real r = (5 => 1 // 2) runs over
5.0, 2.236 (i.e. √5), 1.0.
- =>
Binary operator that is used in several different contexts: 1) in
process declarations between the particles specifying the
initial and final state, e.g. process <proc_name> = <in1>, <in2>
=> <out1>, ....; 2) for the specification of beams when
structure functions are applied to the beam particles, e.g. beams
= p, p => pdf_builtin; 3) for the specification of the scan range in
the scan <var> <var_name> = (<scan_start> => <scan_end>
<incrementor>) (cf. also process, beams, scan)
- %d
Format specifier in analogy to the C language for the print out
on screen by the (→) printf or into strings by the (→)
sprintf command. It is used for decimal integer numbers,
e.g. printf "one = %d" (i). The difference between %i
and %d does not play a role here. (cf. also printf, sprintf,
%i, %e, %f, %g, %E, %F,
%G, %s)
- %e
Format specifier in analogy to the C language for the print out
on screen by the (→) printf or into strings by the (→)
sprintf command. It is used for floating-point numbers in
standard form [-]d.ddd e[+/-]ddd. Usage e.g. printf "pi =
%e" (PI). (cf. also printf, sprintf,
%d, %i, %f, %g, %E, %F,
%G, %s)
- %E
Same as (→) %e, but using upper-case letters. (cf. also
printf, sprintf, %d, %i, %e, %f,
%g, %F, %G, %s)
- %f
Format specifier in analogy to the C language for the print out
on screen by the (→) printf or into strings by the (→)
sprintf command. It is used for floating-point numbers in
fixed-point form. Usage e.g. printf "pi =
%f" (PI). (cf. also printf, sprintf,
%d, %i, %e, %g, %E, %F,
%G, %s)
- %F
Same as (→) %f, but using upper-case letters. (cf. also
printf, sprintf, %d, %i, %e, %f,
%g, %E, %G, %s)
- %g
Format specifier in analogy to the C language for the print out
on screen by the (→) printf or into strings by the (→)
sprintf command. It is used for floating-point numbers in
normal or exponential notation, whichever is more approriate. Usage
e.g. printf "pi = %g" (PI). (cf. also printf, sprintf,
%d, %i, %e, %f, %E, %F,
%G, %s)
- %G
Same as (→) %g, but using upper-case letters. (cf. also
printf, sprintf, %d, %i, %e, %f,
%g, %E, %F, %s)
- %i
Format specifier in analogy to the C language for the print out
on screen by the (→) printf or into strings by the (→)
sprintf command. It is used for integer numbers,
e.g. printf "one = %i" (i). The difference between %i
and %d does not play a role here. (cf. printf, sprintf,
%d, %e, %f, %g, %E, %F,
%G, %s)
- %s
Format specifier in analogy to the C language for the print out
on screen by the (→) printf or into strings by the (→)
sprintf command. It is used for logical or string variables
e.g. printf "foo = %s" ($method). (cf. printf, sprintf,
%d, %i, %e, %f, %g, %E, %F,
%G)
- abarn
Physical unit, stating that a number is in attobarns (10−18
barn). (cf. also nbarn, fbarn, pbarn)
- abs
Numerical function that takes the absolute value of its argument:
abs (<num_val>) yields |<num_val>|. (cf. also conjg, sgn, mod, modulo)
- acos
Numerical function asin (<num_val>) that calculates the
arccosine trigonometric function (inverse of cos) of real and
complex numerical numbers or variables. (cf. also sin,
cos, tan, asin, atan)
- alias
This allows to define a collective expression for a class of
particles, e.g. to define a generic expression for leptons, neutrinos
or a jet as alias lepton = e1:e2:e3:E1:E2:E3, alias
neutrino = n1:n2:n3:N1:N2:N3, and alias jet =
u:d:s:c:U:D:S:C:g, respectively.
- all
all is a function that works on a logical expression and a list,
all <log_expr> [<list>], and returns true if and only if
log_expr is fulfilled for all entries in list, and
false otherwise. Examples: all Pt > 100 GeV [lepton]
checks whether all leptons are harder than 100 GeV, all Dist > 2
[u:U, d:D] checks whether all pairs of corresponding quarks
are separated in R space by more than 2. Logical expressions with
all can be logically combined with and and
or. (cf. also any, and, no, and or)
- alt_setup
This command allows to specify alternative setups for a process/list
of processes, alt_setup = { <setup1> } [, { <setup2> } ,
...]. An alternative setup can be a resetting of a coupling
constant, or different cuts etc. It can be particularly used in a
(→) rescan procedure.
- analysis
This command, analysis = <log_expr>, allows to define an
analysis as a logical expression, with a syntax similar to the (→)
cuts or (→) selection command. Note that a (→)
formally is a logical expression.
- and
This is the standard two-place logical connective that has the value
true if both of its operands are true, otherwise a value of false. It
is applied to logical values, e.g. cut expressions. (cf. also
all, no, or).
- any
any is a function that works on a logical expression and a list,
any <log_expr> [<list>], and returns true if
log_expr is fulfilled for any entry in list, and
false otherwise. Examples: any PDG == 13 [lepton] checks
whether any lepton is a muon, any E > 2 * mW [jet] checks
whether any jet has an energy of twice the W mass. Logical
expressions with any can be logically combined with and
and or. (cf. also all, and, no, and or)
- as
cf. compile
- ascii
Specifier for the sample_format command to demand the
generation of the standard WHIZARD verbose/debug ASCII event
files. (cf. also $sample, $sample_normalization,
sample_format)
- asin
Numerical function asin (<num_val>) that calculates the
arcsine trigonometric function (inverse of sin) of real and
complex numerical numbers or variables. (cf. also sin,
cos, tan, acos, atan)
- atan
Numerical function atan (<num_val>) that calculates the
arctangent trigonometric function (inverse of tan) of real and
complex numerical numbers or variables. (cf. also sin,
cos, tan, asin, acos)
- athena
Specifier for the sample_format command to demand the
generation of the ATHENA variant for HEPEVT ASCII event
files. (cf. also $sample, $sample_normalization,
sample_format)
- beam
Constructor that specifies a particle (in a subevent) as beam particle. It is
used in cuts, analyses or selections, e.g. cuts = all Theta > 20
degree [beam lepton, lepton]. (cf. also incoming, outgoing,
cuts, analysis, selection, record)
- beam_events
Beam structure specifier to read in lepton collider beamstrahlung’s
spectra from external files as pairs of energy fractions: beams:
e1, E1 => beam_events. Note that this is a pair spectrum that has to
be applied to both beams simultaneously. (cf. also beams,
$beam_events_file, ?beam_events_warn_eof)
- beams
This specifies the contents and structure of the beams: beams =
<prt1>, <prt2> [ => <str_fun1> ....]. If this
command is absent in the input file, WHIZARD automatically takes the
two incoming partons (or one for decays) of the corresponding process
as beam particles, and no structure functions are applied. Protons and
antiprotons as beam particles are predefined as p and
pbar, respectively. A structure function, like pdf_builtin,
ISR, EPA and so on are switched on as e.g. beams = p,
p => lhapdf. Structure functions can be specified for one of the two
beam particles only, of the structure function is not a
spectrum. (cf. also beams_momentum, beams_theta,
beams_phi, beams_pol_density,
beams_pol_fraction, beam_events, circe1,
circe2, energy_scan, epa, ewa, isr,
lhapdf, pdf_builtin).
- beams_momentum
Command to set the momenta (or energies) for the two beams of a
scattering process: beams_momentum = <mom1>, <mom2> to allow
for asymmetric beam setups (e.g. HERA: beams_momentum = 27.5
GeV, 920 GeV). Two arguments must be present
for a scattering process, but the command can be used with one
argument to integrate and simulate a decay of a moving
particle. (cf. also beams, beams_theta,
beams_phi, beams_pol_density,
beams_pol_fraction)
- beams_phi
Same as (→) beams_theta, but to allow for a non-vanishing
beam azimuth angle, too. (cf. also beams, beams_theta,
beams_momentum, beams_pol_density,
beams_pol_fraction)
- beams_pol_density
This command allows to specify the initial state for polarized beams
by the syntax: beams_pol_density = @(<pol_spec_1>),
@(<pol_spec_2>). Two polarization specifiers are mandatory for
scattering, while one can be used for decays from polarized
probes. The specifier <pol_spec_i> can be empty (no
polarization), has one entry (for a definite helicity/spin
orientation), or ranges of entries of a spin density matrix. The
command can be used globally, or as a local argument of the
integrate command. For detailed information, see
Sec. 5.6.1. It is also possible to use
variables as placeholders in the specifiers. Note that polarization is
assumed to be complete, for partial polarization use (→)
beams_pol_fraction. (cf. also beams, beams_theta,
beams_phi, beams_momentum, beams_pol_fraction)
- beams_pol_fraction
This command allows to specify the amount of polarization when using
polarized beams (→ beams_pol_density). The syntax is:
beams_pol_fraction = <frac_1>, <frac_2>. Two fractions must
be present for scatterings, being real numbers between 0 and
1. A specification with percentage is also possible,
e.g. beams_pol_fraction = 80%, 40%. (cf. also beams,
beams_theta, beams_phi, beams_momentum,
beams_pol_density)
- beams_theta
Command to set a crossing angle (with respect to the z axis) for one
or both of the beams of a
scattering process: beams_theta = <angle1>, <angle2> to allow
for asymmetric beam setups (e.g. beams_angle = 0, 10
degree). Two arguments must be present for a scattering process, but
the command can be used with one argument to integrate and simulate a
decay of a moving particle. (cf. also beams, beams_phi,
beams_momentum, beams_pol_density,
beams_pol_fraction)
- by
Constructor that replaces the default sorting criterion (according to
PDG codes) of the (→) sort function on particle
lists/subevents by one given by a unary or binary particle observable:
sort by <observable> [<particles> [, <ref_particles>] ]. (cf. also sort, extract, join,
collect, combine, +)
- ceiling
This is a function ceiling (<num_val>) that gives the
least integer greater than or equal to <num_val>,
e.g. int i = ceiling (4.56789) gives i = 5. (cf. also
int, nint, floor)
- circe1
Beam structure specifier for the CIRCE1 structure function for
beamstrahlung at a linear lepton collider: beams = e1, E1 =>
circe1. Note that this is a pair spectrum, so the specifier acts for
both beams simultaneously. (cf. also beams, ?circe1_photons,
?circe1_photon2, circe1_sqrts,
?circe1_generate, ?circe1_map,
circe1_eps,
circe1_mapping_slope, circe1_ver,
circe1_rev, $circe1_acc, circe1_chat)
- circe2
Beam structure specifier for the lepton-collider structure function
for photon spectra, CIRCE2: beams = A, A => circe2. Note that
this is a pair spectrum, an application to only one beam is not
possible. (cf. also beams, ?circe2_polarized,
$circe2_file, $circe2_design)
- clear
This command allows to clear a variable set before: clear
(<clearable var.>) resets the variable <clearable var.> which
could be the beams, the unstable settings, sqrts,
any kind of cuts or scale expressions, any user-set
variable etc. The syntax of the command is completely analogous to
(→) show.
- close_out
With the command, close_out ("<out_file">) user-defined
information like data or (→) printf statements can be
written out to a user-defined file. The command closes an I/O stream to
an external file <out_file>. (cf. also open_out,
$out_file, printf)
- cluster
Command that allows to cluster all particles in a subevent to a set of
jets: cluster [<particles>]. It also to cluster particles
subject to a certain boolean condition, cluster if
<condition> [<particles>]. At the moment only available
if the FastJet package is linked.
(cf. also jet_r, combine, jet_algorithm,
kt_algorithm,
cambridge_[for_passive_]algorithm,
antikt_algorithm, plugin_algorithm,
genkt_[for_passive_]algorithm,
ee_kt_algorithm, ee_genkt_algorithm,
?keep_flavors_when_clustering)
- collect
The collect [<list>] operation collects all particles in
the list <list> into a one-entry subevent with a
four-momentum of the sum of all four-momenta of non-overlapping
particles in <list>. (cf. also combine,
select, extract, sort)
- complex
Defines a complex variable. The syntax is e.g. complex x = 2 + 3
* I. (cf. also int, real)
- combine
The combine [<list1>, <list2>] operation makes a particle list
whose entries are the result of adding (the momenta of) each pair of
particles in the two input lists list1, list2. For example,
combine [incoming lepton, lepton] constructs all mutual pairings
of an incoming lepton with an outgoing lepton (an alias for the
leptons has to be defined, of course). (cf. also collect,
select, extract, sort, +)
- compile
The compile () command has no arguments (the parentheses can
also been left out: /compile (). The command is optional, it
invokes the compilation of the process(es) (i.e. the matrix element
file(s)) to be compiled as a shared library. This shared object file
has the standard name default_lib.so and resides in the
.libs subdirectory of the corresponding user workspace. If the
user has defined a different library name lib_name with the
library command, then WHIZARD compiles this as the shared object
.libs/lib_name.so. (This allows to split process classes and to
avoid too large libraries.)
Another possibility is to use the command compile as
"static_name". This will compile and link the process library in a
static way and create the static executable static_name in the
user workspace. (cf. also library)
- compile_analysis
The compile_analysis statement does the same as
the write_analysis command, namely to tell WHIZARD to write
the analysis setup by the user for the SINDARIN input file under
consideration. If no $out_file is provided, the histogram
tables/plot data etc. are written to the default file
whizard_analysis.dat. In addition to write_analysis,
compile_analysis also invokes the WHIZARD LATEXroutines for
producing postscript or PDF output of the data (unless the flag
→ ?analysis_file_only is set to true).
(cf. also $out_file, write_analysis,
?analysis_file_only)
- conjg
Numerical function that takes the complex conjugate of its argument:
conjg (<num_val>) yields <num_val>∗. (cf. also abs, sgn, mod, modulo)
- cos
Numerical function cos (<num_val>) that calculates the
cosine trigonometric function of real and complex numerical numbers or
variables. (cf. also sin, tan, asin, acos,
atan)
- cosh
Numerical function cosh (<num_val>) that calculates the
hyperbolic cosine function of real and complex numerical numbers or
variables. Note that its inverse function is part of the
Fortran2008 status and hence not realized. (cf. also sinh,
tanh)
- count
Subevent function that counts the number of particles or particle
pairs in a subevent: count [<particles_1> [, <particles_2>]]. This can also be a counting subject to a
condition: count if <condition> [<particles_1> [,
<particles_2>]].
- cuts
This command defines the cuts to be applied to certain processes. The
syntax is: cuts = <log_class> <log_expr> [<unary or binary
particle (list) arg>], where the cut expression must be initialized
with a logical classifier log_class like all, any,
no. The logical expression log_expr contains the cut to
be evaluated. Note that this need not only be a kinematical cut
expression like E > 10 GeV or 5 degree < Theta < 175 degree,
but can also be some sort of trigger expression or event selection.
Whether the expression is evaluated on particles or pairs
of particles depends on whether the discriminating variable is unary or
binary, Dist being obviously binary, Pt being unary. Note that
some variables are both unary and binary, e.g. the invariant mass M. Cut
expressions can be connected by the logical connectives and and
or. The cuts statement acts on all subsequent process
integrations and analyses until a new cuts statement appears.
(cf. also all, any,
Dist, E, M,
no, Pt).
- debug
Specifier for the sample_format command to demand the
generation of the very verbose WHIZARD ASCII event
file format intended for debugging. (cf. also $sample,
sample_format, $sample_normalization)
- degree
Expression specifying the physical unit of degree for angular
variables, e.g. the cut expression function Theta. (if no unit is
specified for angular variables, radians are used; cf. rad, mrad).
- Dist
Binary observable specifier, that gives the η-φ-
(pseudorapidity-azimuth) distance R = √(Δ η)2 +
(Δφ)2 between the momenta of the two particles: eval
Dist [jet, jet]. (cf. also eval, cuts, selection,
Theta, Eta, Phi)
- dump
Specifier for the sample_format command to demand the
generation of the intrinsic WHIZARD event record format
(output of the particle_t type container). (cf. also
$sample, sample_format, $sample_normalization
- E
Unary (binary) observable specifier for the energy of a single
(two) particle(s), e.g. eval E ["W+"], all E > 200 GeV [b,
B]. (cf. eval, cuts, selection)
- else
Constructor for providing an alternative in a conditional clause:
if <log_expr> then <expr 1> else <expr 2> endif. (cf. also
if, elsif, endif, then).
- elsif
Constructor for concatenating more than one conditional clause with
each other: if <log_expr 1> then <expr 1> elsif <log_expr 2>
then <expr 2> …endif. (cf. also if, else,
endif, then).
- endif
Mandatory constructor to conclude a conditional clause: if
<log_expr> then …endif. (cf. also if,
else, elsif, then).
- energy_scan
Beam structure specifier for the energy scan structure function:
beams = e1, E1 => energy_scan. This pair spectrum that has to
be applied to both beams simultaneously can be used to scan over a
range of collider energies without using the scan command.
(cf. also beams, scan, ?energy_scan_normalize)
- epa
Beam structure specifier for the equivalent-photon approximation
(EPA), i.e the Weizsäcker-Williams structure function:
e.g. beams = e1, E1 => epa (applied to both beams), or
e.g. beams = e1, u => epa, none (applied to only one
beam). (cf. also beams, epa_alpha, epa_x_min,
epa_mass, epa_q_max, epa_q_min,
?epa_recoil, ?epa_keep_energy)
- Eta
Unary and also binary observable specifier, that as a unary observable
gives the pseudorapidity of a particle momentum. The pseudorapidity is
given by η = − log[ tan(θ/2) ], where
θ is the angle with the beam direction. As a binary
observable, it gives the pseudorapidity difference between the momenta
of two particles, where θ is the enclosed angle: eval Eta
[e1], all abs (Eta) < 3.5 [jet, jet]. (cf. also eval,
cuts, selection, Rap, abs)
- eV
Physical unit, stating that the corresponding number is in electron
volt. (cf. also keV, meV, MeV, GeV, TeV)
- eval
Evaluator that tells WHIZARD to evaluate the following expr:
eval <expr>. Examples are: eval Rap [e1], eval
M / 1 GeV [combine [q,Q]] etc. (cf. also cuts,
selection, record, sum, prod)
- ewa
Beam structure specifier for the equivalent-photon approximation
(EWA): e.g. beams = e1, E1 => ewa (applied to both beams), or
e.g. beams = e1, u => ewa, none (applied to only one
beam). (cf. also beams, ewa_x_min, ewa_pt_max,
ewa_mass, ?ewa_keep_energy,
?ewa_recoil)
- exec
Constructor exec ("<cmd_name>") that demands WHIZARD to
execute/run the command cmd_name. For this to work that
specific command must be present either in the path of the operating
system or as a command in the user workspace.
- exit
Command to finish the WHIZARD run (and not execute any further code
beyond the appearance of exit in the SINDARIN file. The command
(which is the same as → quit) allows for an argument,
exit (<expr>), where the expression can be executed, e.g. a
screen message or an exit code.
- exp
Numerical function exp (<num_val>) that calculates the
exponential of real and complex numerical numbers or
variables. (cf. also sqrt, log, log10)
- expect
The binary function expect compares two numerical expressions
whether they fulfill a certain ordering condition or are equal up
to a specific uncertainty or tolerance which can bet set by the
specifier tolerance, i.e. in principle it checks whether a
logical expression is true. The expect function does actually
not just check a value for correctness, but also records its result.
If failures are present when the program terminates, the exit code is
nonzero. The syntax is expect (<num1> <log_comp> <num2>), where <num1> and
<num2> are two numerical values (or
corresponding variables) and <log_comp> is one of the following
logical comparators: <, >, <=, >=, ==,
<>.
(cf. also <, >, <=, >=, ==, <>,
tolerance).
- extract
Subevent function that either extracts the first element of a
particle list/subevent: extract [ <particles>], or the
element at position <index_value> of the particle list:
extract index <index_value> [ <particles>]. Negative index values count from the end of the
list. (cf. also sort, combine,
collect, +, index)
- factorization_scale
This is a command, factorization_scale = <expr>, that sets
the factorization scale of a process or list of processes. It
overwrites a possible scale set by the (→) scale command.
<expr> can be any kinematic expression that leads to a result of
momentum dimension one, e.g. 100 GeV, eval
Pt [e1]. (cf. also renormalization_scale).
- false
Constructor stating that a logical expression or variable is false,
e.g. ?<log_var> = false. (cf. also true).
- fbarn
Physical unit, stating that a number is in femtobarns (10−15
barn). (cf. also nbarn, abarn, pbarn)
- floor
This is a function floor (<num_val>) that gives the
greatest integer less than or equal to <num_val>,
e.g. int i = floor (4.56789) gives i = 4. (cf. also
int, nint, ceiling)
- gaussian
Beam structure specifier that imposes a Gaussian energy distribution,
separately for each beam. The σ values are set by
gaussian_spread1 and gaussian_spread2, respectively.
- GeV
Physical unit, energies in 109 electron volt. This is the default
energy unit of WHIZARD. (cf. also eV, keV, MeV, meV,
TeV)
- graph
This command defines the necessary information regarding producing
a graph of a function in WHIZARD’s internal graphical gamelan
output. The syntax is: graph <record_name> { <optional
arguments> }. The record with name <record_name> has to be
defined, either before or after the graph definition. Possible optional
arguments of the graph command are the minimal and maximal values
of the axes (x_min, x_max, y_min, y_max).
(cf. plot, histogram, record)
- Hel
Unary observable specifier that allows to specify the helicity of a
particle, e.g. all Hel == -1 [e1] in a selection. (cf. also
eval, cuts, selection)
- hepevt
Specifier for the sample_format command to demand the
generation of HEPEVT ASCII event files. (cf. also $sample,
sample_format)
- hepevt_verb
Specifier for the sample_format command to demand the
generation of the extended or verbose version of HEPEVT ASCII event
files. (cf. also $sample, sample_format)
- hepmc
Specifier for the sample_format command to demand the
generation of HepMC ASCII event files. Note that this is only
available if the HepMC package is installed and correctly
linked. (cf. also $sample, sample_format,
?hepmc_output_cross_section)
- histogram
This command defines the necessary information regarding plotting data
as a histogram, in the form of: histogram <record_name> {
<optional arguments> }. The record with name <record_name> has to be
defined, either before or after the histogram definition. Possible optional
arguments of the histogram command are the minimal and maximal values
of the axes (x_min, x_max, y_min, y_max).
(cf. graph, plot, record)
- Ht
Subeventary observable specifier for the transverse mass
(√pT2 + m2 in the c.m. frame) summed over all particles in
the subevent given as argument, e.g. eval Ht [t:T:Z]. (cf.
eval, sum, prod, Pt, M)
- if
Conditional clause with the construction if <log_expr> then
<expr> [else <expr> …] endif. Note that there must be an
endif statement. For more complicated expressions it is better
to use expressions in parentheses: if (<log_expr>) then
{<expr>} else {<expr>} endif. Examples are a selection of up quarks
over down quarks depending on a logical variable: if ?ok then u
else d, or the setting of an integer variable depending on the
rapidity of some particle: if (eta > 0) then { a = +1} else
{ a = -1}. (cf. also elsif, endif, then)
- in
Second part of the constructor to let a variable be local to an
expression. It has the syntax let <var> = <value> in
<expression>. E.g. let int a = 3 in let int b = 4 in
<expression> (cf. also let)
- include
The include statement, include ("file.sin") allows to
include external SINDARIN files file.sin into the main WHIZARD
input file. A standard example is the inclusion of the standard cut
file default_cuts.sin.
- incoming
Constructor that specifies particles (or subevents) as incoming. It is
used in cuts, analyses or selections, e.g. cuts = all Theta > 20
degree [incoming lepton, lepton]. (cf. also beam, outgoing,
cuts, analysis, selection, record)
- index
Specifies the position of the element of a particle to be extracted by
the subevent function (→) extract: extract index
<index_value> [ <particles>]. Negative index values count
from the end of the list. (cf. also extract, sort, combine,
collect, +)
- int
1) This is a constructor to specify integer constants in the input
file. Strictly speaking, it is a unary function setting the value
int_val of the integer variable int_var:
int <int_var> = <int_val>. Note that is mandatory for all
user-defined variables. (cf. also real and complex)
2) It is a function int (<num_val>) that converts real and
complex numbers (here their real parts) into integers. (cf. also
nint, floor, ceiling)
- integrate
The integrate (<proc_name>) { <integrate_options> } command
invokes the integration (phase-space generation and Monte-Carlo
sampling) of the process proc_name (which can also be a list of
processes) with the integration options
<integrate_options>. Possible options are (1) via
$integration_method = "<intg. method>" the integration
method (the default being VAMP), (2) the number of iterations and
calls per integration during the Monte-Carlo phase-space integration
via the iterations specifier; (3) goal for the
accuracy, error or relative error (accuracy_goal,
error_goal, relative_error_goal). (4) Invoking only
phase space generation (?phs_only = true), (5) making test
calls of the matrix element. (cf. also iterations,
accuracy_goal, error_goal, relative_error_goal,
error_threshold)
- isr
Beam structure specifier for the lepton-collider/QED initial-state
radiation (ISR) structure function: e.g. beams = e1, E1 => isr
(applied to both beams), or e.g. beams = e1, u => isr, none
(applied to only one beam). (cf. also beams, isr_alpha,
isr_q_max, isr_mass, isr_order,
?isr_recoil, ?isr_keep_energy)
- iterations (default: internal heuristics)
Option to set the number of iterations and calls per iteration during
the Monte-Carlo phase-space integration process. The syntax is
iterations = <n_iterations>:<n_calls>. Note that this can be
also a list, separated by colons, which breaks up the integration
process into passes of the specified number of integrations and calls
each. It works for all integration methods. For VAMP, there is the
additional option to specify whether grids and channel weights should
be adapted during iterations ("g", "w",
"gw" for both, or "" for no adaptation). (cf. also
integrate, accuracy_goal, error_goal,
relative_error_goal, error_threshold).
- join
Subevent function that concatenates two particle lists/subevents if
there is no overlap: join [<particles>, <new_particles>]. The joining of the two lists can also be made
depending on a condition: join if <condition> [<particles>, <new_particles>]. (cf. also &,
collect, combine, extract, sort, +)
- keV
Physical unit, energies in 103 electron volt. (cf. also eV,
meV, MeV, GeV, TeV)
- kT
Binary particle observable that represents a jet kT clustering
measure: kT [j1, j2] gives the following kinematic expression:
2 min(Ej12, Ej22) / Q2 × (1 − cosθj1,j2). At the
moment, Q2 = 1.
- let
This allows to let a variable be local to an expression. It has the
syntax let <var> = <value> in <expression>.
E.g. let int a = 3 in let int b = 4 in <expression>
(cf. also in)
- lha
Specifier for the sample_format command to demand the
generation of the WHIZARD version 1 style (deprecated) LHA ASCII event
format files. (cf. also $sample,
sample_format)
- lhapdf
This is a beams specifier to demand calling LHAPDF parton densities as
structure functions to integrate processes in hadron collisions. Note
that this only works if the external LHAPDF library is present and
correctly linked. (cf. beams, $lhapdf_dir,
$lhapdf_file, lhapdf_photon,
$lhapdf_photon_file, lhapdf_member,
lhapdf_photon_scheme)
- lhapdf_photon
This is a beams specifier to demand calling LHAPDF parton densities as
structure functions to integrate processes in hadron collisions with a
photon as initializer of the hard scattering process. Note
that this only works if the external LHAPDF library is present and
correctly linked. (cf. beams, lhapdf, $lhapdf_dir,
$lhapdf_file, $lhapdf_photon_file,
lhapdf_member, lhapdf_photon_scheme)
- lhef
Specifier for the sample_format command to demand the
generation of the Les Houches Accord (LHEF) event format files, with
XML headers. There are several different versions of this format,
which can be selected via the $lhef_version specifier
(cf. also $sample, sample_format, $lhef_version,
$lhef_extension, ?lhef_write_sqme_prc,
?lhef_write_sqme_ref, ?lhef_write_sqme_alt)
- library
The command library = "<lib_name>" allows to specify a separate
shared object library archive lib_name.so, not using the
standard library default_lib.so. Those libraries (when using
shared libraries) are located in the .libs subdirectory of the
user workspace. Specifying a separate library is useful for splitting
up large lists of processes, or to restrict a larger number of
different loaded model files to one specific process library.
(cf. also compile, $library_name)
- log
Numerical function log (<num_val>) that calculates the
natural logarithm of real and complex numerical numbers or
variables. (cf. also sqrt, exp, log10)
- log10
Numerical function log10 (<num_val>) that calculates the
base 10 logarithm of real and complex numerical numbers or
variables. (cf. also sqrt, exp, log)
- long
Specifier for the sample_format command to demand the
generation of the long variant of HEPEVT ASCII event
files. (cf. also $sample,
sample_format)
- M
Unary (binary) observable specifier for the (signed) mass of a single
(two) particle(s), e.g. eval M [e1], any M = 91 GeV [e2,
E2]. (cf. eval, cuts, selection)
- M2
Unary (binary) observable specifier for the mass squared of a single
(two) particle(s), e.g. eval M2 [e1], all M2 > 2*mZ [e2,
E2]. (cf. eval, cuts, selection)
- max
Numerical function with two arguments max (<var1>, <var2>) that gives the maximum of the two arguments: max(var1,
var2). It can act on all combinations of integer and real
variables. Example: real heavier_mass = max (mZ, mH). (cf. also
min)
- meV
Physical unit, stating that the corresponding number is in 10−3
electron volt. (cf. also eV, keV, MeV, GeV,
TeV)
- MeV
Physical unit, energies in 106 electron volt. (cf. also eV,
keV, meV, GeV, TeV)
- min
Numerical function with two arguments min (<var1>, <var2>) that gives the minimum of the two arguments: min(var1,
var2). It can act on all combinations of integer and real
variables. Example: real lighter_mass = min (mZ, mH). (cf. also
max)
- mod
Numerical function for integer and real numbers mod (x, y) that
computes the remainder of the division of x by y (which
must not be zero). (cf. also
abs, conjg, sgn, modulo)
- model (default: SM)
With this specifier, model = <model_name>, one sets the hard
interaction physics model for the processes defined after this model
specification. The list of available models can be found in Table
10.1. Note that the model specification can appear
arbitrarily often in a SINDARIN input file, e.g. for compiling and
running processes defined in different physics models. (cf. also
$model_name)
- modulo
Numerical function for integer and real numbers modulo (x, y) that
computes the value of x modulo y. (cf. also
abs, conjg, sgn, mod)
- mokka
Specifier for the sample_format command to demand the
generation of the MOKKA variant for HEPEVT ASCII event
files. (cf. also $sample,
sample_format)
- mrad
Expression specifying the physical unit of milliradians for angular
variables. This default in WHIZARD is rad. (cf. degree, rad).
- nbarn
Physical unit, stating that a number is in nanobarns (10−9
barn). (cf. also abarn, fbarn, pbarn)
- n_in
Integer variable that accesses the number of incoming particles of a
process. It can be used in cuts or in an analysis. (cf. also
sqrts_hat, cuts, record, n_out, n_tot)
- Nacl
Unary observable specifier that returns the total number of open anticolor lines
of a particle or subevent (i.e., composite particle). Defined only if
?colorize_subevt is true.. (cf. also
Ncol, ?colorize_subevt)
- Ncol
Unary observable specifier that returns the total number of open color lines
of a particle or subevent (i.e., composite particle). Defined only if
?colorize_subevt is true.. (cf. also
Nacl, ?colorize_subevt)
- nint
This is a function nint (<num_val>) that converts real
numbers into the closest integer, e.g. int i = nint (4.56789)
gives i = 5. (cf. also
int, floor, ceiling)
- no
no is a function that works on a logical expression and a list,
no <log_expr> [<list>], and returns true if and only if
log_expr is fulfilled for none of the entries in
list, and false otherwise. Examples: no Pt < 100 GeV
[lepton] checks whether no lepton is softer than 100 GeV. It is the
logical opposite of the function all. Logical expressions with
no can be logically combined with and and
or. (cf. also all, any, and, and or)
- none
Beams specifier that can used to explicitly not apply a
structure function to a beam, e.g. in HERA physics: beams = e1, P
=> none, pdf_builtin. (cf. also beams)
- not
This is the standard logical negation that converts true into false
and vice versa. It is applied to logical values, e.g. cut
expressions. (cf. also and, or).
- n_out
Integer variable that accesses the number of outgoing particles of a
process. It can be used in cuts or in an analysis. (cf. also
sqrts_hat, cuts, record, n_in, n_tot)
- n_tot
Integer variable that accesses the total number of particles (incoming
plus outgoing) of a process. It can be used in cuts or in an
analysis. (cf. also sqrts_hat, cuts, record,
n_in, n_out)
- observable
With this, observable = <obs_spec>, the user is able to define
a variable specifier obs_spec for observables. These can be
reused in the analysis, e.g. as a record, as functions of the
fundamental kinematical variables of the processes.
(cf. analysis, record)
- open_out
With the command, open_out ("<out_file">) user-defined
information like data or (→) printf statements can be
written out to a user-defined file. The command opens an I/O stream to
an external file <out_file>. (cf. also close_out,
$out_file, printf)
- or
This is the standard two-place logical connective that has the value
true if one of its operands is true, otherwise a value of false. It
is applied to logical values, e.g. cut expressions. (cf. also
and, not).
- outgoing
Constructor that specifies particles (or subevents) as outgoing. It is
used in cuts, analyses or selections, e.g. cuts = all Theta > 20
degree [incoming lepton, outgoing lepton]. Note that the outgoing
keyword is redundant and included only for completeness: outgoing lepton
has the same meaning as lepton. (cf. also beam,
incoming,
cuts, analysis, selection, record)
- P
Unary (binary) observable specifier for the spatial momentum
√p→2 of a single (two) particle(s), e.g. eval P
["W+"], all P > 200 GeV [b, B]. (cf. eval, cuts,
selection)
- pbarn
Physical unit, stating that a number is in picobarns (10−12
barn). (cf. also abarn, fbarn, nbarn)
- pdf_builtin
This is a beams specifier for WHIZARD’s internal PDF structure
functions to integrate processes in hadron collisions.
(cf. beams, pdf_builtin_photon,
$pdf_builtin_file)
- pdf_builtin_photon
This is a beams specifier for WHIZARD’s internal PDF structure
functions to integrate processes in hadron collisions with a photon as
initializer of the hard scattering process.
(cf. beams, $pdf_builtin_file)
- PDG
Unary observable specifier that allows to specify the PDG code of a
particle, e.g. eval PDG [e1], giving 11. (cf. also
eval, cuts, selection)
- Phi
Unary and also binary observable specifier, that as a unary observable
gives the azimuthal angle of a particle’s momentum in the detector
frame (beam into +z direction). As a binary observable, it gives the
azimuthal difference between the momenta of two particles: eval
Phi [e1], all Phi > Pi [jet, jet]. (cf. also eval,
cuts, selection, Theta)
- photon_isolation
Logical function photon_isolation if <condition> [<list1> , <list2>] that cuts out event where the photons in
<list1> do not fulfill the condition <condition> and are not isolated from hadronic (and electromagnetic)
activity, i.e. the photon fragmentation. (cf. also cluster,
collect, combine, extract, select,
sort, +)
- photon_recombination
Similar to the cluster statement takes a subevent as argument
and combines a (single) photon with the closest non-photon object
given in the subevent. Depends on the SINDARIN variable
photon_rec_r0 which gives the R radius within which the photon
is recombined. (cf. also cluster, collect, combine)
- Pl
Unary (binary) observable specifier for the longitudinal momentum
(pz in the c.m. frame) of a single (two) particle(s),
e.g. eval Pl ["W+"], all Pl > 200 GeV [b,
B]. (cf. eval, cuts, selection)
- plot
This command defines the necessary information regarding plotting data
as a graph, in the form of: plot <record_name> { <optional
arguments> }. The record with name <record_name> has to be
defined, either before or after the plot definition. Possible optional
arguments of the plot command are the minimal and maximal values
of the axes (x_min, x_max, y_min, y_max).
(cf. graph, histogram, record)
- polarized
Constructor to instruct WHIZARD to retain polarization of the
corresponding particles in the generated events: polarized <prt1>
[, <prt2> , ...]. (cf. also unpolarized, simulate,
?polarized_events)
- printf
Command that allows to print data as screen messages, into logfiles or
into user-defined output files: printf "<string_expr>". There
exist format specifiers, very similar to the C command
printf, e.g. printf "%i" (123). (cf. also
open_out, close_out, $out_file,
?out_advance, sprintf, %d, %i, %e,
%f, %g, %E, %F, %G, %s)
- process
Allows to set a hard interaction process, either for a decay process
with name <decay_proc> as process <decay_proc> = <mother> => <daughter1>, <daughter2>, ..., or for a scattering process
with name <scat_proc as process <scat_proc> =
<in1>, <in2> => <out1>, <out2>, .... Note
that there can be arbitrarily many processes to be defined in a
SINDARIN input file. There are two options for particle/process sums: flavor sums:
<prt1>:<prt2>:..., where all masses have to be identical, and
inclusive sums, <prt1> + <prt2> + .... The latter can be done on
the level of individual particles, or sums over whole final
states. Here, masses can differ, and terms will be translated into
different process components. The process command also allows for
optional arguments, e.g. to specify a numerical identifier
(cf. process_num_id), the method how to generate the code for
the matrix element(s): $method, possible methods are either
with the O’Mega matrix element generator, using template matrix
elements with different normalizations, or completely internal matrix
element; for O’Mega matrix elements there is also the possibility to
specify possible restrictions (cf. $restrictions).
- prod
Takes the product of an expression <expr> over the elements of
the given subevent <subevt>, prod <expr> [<subevt>], e.g.
prod Hel [e1:E1] (cf. eval, sum).
- Pt
Unary (binary) observable specifier for the transverse momentum
(√px2 + py2 in the c.m. frame) of a single (two)
particle(s), e.g. eval Pt ["W+"], all Pt > 200 GeV [b,
B]. (cf. eval, cuts, selection)
- Px
Unary (binary) observable specifier for the x-component of the
momentum of a single (two) particle(s), e.g. eval Px ["W+"],
all Px > 200 GeV [b, B]. (cf. eval, cuts,
selection)
- Py
Unary (binary) observable specifier for the y-component of the
momentum of a single (two) particle(s), e.g. eval Py ["W+"],
all Py > 200 GeV [b, B]. (cf. eval, cuts,
selection)
- Pz
Unary (binary) observable specifier for the z-component of the
momentum of a single (two) particle(s), e.g. eval Pz ["W+"],
all Pz > 200 GeV [b, B]. (cf. eval, cuts,
selection)
- quit
Command to finish the WHIZARD run (and not execute any further code
beyond the appearance of quit in the SINDARIN file. The command
(which is the same as → exit) allows for an argument,
quit (<expr>), where the expression can be executed, e.g. a
screen message or an quit code.
- rad
Expression specifying the physical unit of radians for angular
variables. This is the default in WHIZARD. (cf. degree, mrad).
- Rap
Unary and also binary observable specifier, that as a unary observable
gives the rapidity of a particle momentum. The rapidity is given by y
= 1/2 log[ (E + pz)/(E−pz) ]. As a binary
observable, it gives the rapidity difference between the momenta of
two particles: eval Rap [e1], all abs (Rap) < 3.5 [jet,
jet]. (cf. also eval, cuts, selection, Eta,
abs)
- read_slha
Tells WHIZARD to read in an input file in the SUSY Les Houches accord
(SLHA), as read_slha ("slha_file.slha"). Note that the files
for the use in WHIZARD should have the suffix .slha.
(cf. also write_slha, ?slha_read_decays,
?slha_read_input, ?slha_read_spectrum)
- real
This is a constructor to specify real constants in the input
file. Strictly speaking, it is a unary function setting the value
real_val of the real variable real_var:
real <real_var> = <real_val>. (cf. also int and
complex)
- real_epsilon
Predefined real; the relative uncertainty intrinsic to the floating
point type of the Fortran compiler with which WHIZARD has been
built.
- real_precision
Predefined integer; the decimal precision of the floating point type
of the Fortran compiler with which WHIZARD has been built.
- real_range
Predefined integer; the decimal range of the floating point type of
the Fortran compiler with which WHIZARD has been built.
- real_tiny
Predefined real; the smallest number which can be represented by the
floating point type of the Fortran compiler with which WHIZARD has
been built.
- record
The record constructor provides an internal data structure in
SINDARIN input files. Its syntax is in general record
<record_name> (<cmd_expr>). The <cmd_expr> could be the
definition of a tuple of points for a histogram or an eval
constructor that tells WHIZARD e.g. by which rule to calculate an
observable to be stored in the record record_name. Example:
record h (12) is a record for a histogram defined under the name
h with the single data point (bin) at value 12; record rap1
(eval Rap [e1]) defines a record with name rap1 which has an
evaluator to calculate the rapidity (predefined WHIZARD function) of
an outgoing electron.
(cf. also eval, histogram, plot)
- renormalization_scale
This is a command, renormalization_scale = <expr>, that sets
the renormalization scale of a process or list of processes. It
overwrites a possible scale set by the (→) scale command.
<expr> can be any kinematic expression that leads to a result of
momentum dimension one, e.g. 100 GeV, eval
Pt [e1]. (cf. also factorization_scale).
- rescan
This command allows to rescan event samples with modified model
parameter, beam structure etc. to recalculate (analysis) observables,
e.g.:
rescan "<event_file>" (<proc_name>) { <rescan_setup>}.
"<event_file>" is the name of the event file and
<proc_name> is the process whose (existing) event
file of arbitrary size that is to be rescanned. Several flags allow to
reconstruct the beams (→ ?recover_beams), to reuse only the
hard process but rebuild the full events (→
?update_event), to recalculate the matrix element (→
?update_sqme) or to recalculate the individual event weight (→
?update_weight). Further rescan options are redefining model
parameter input, or defining a completely new alternative setup (→
alt_setup) (cf. also $rescan_input_format)
- results
Only used in the combination show (results). Forces WHIZARD to
print out a results summary for the integrated processes.
(cf. also show)
- reweight
The reweight = <expr> command allows to give for a process or
list of processes an alternative weight, given by any kind of scalar
expression <expr>, e.g. reweight = 0.2 or reweight =
(eval M2 [e1, E1]) / (eval M2 [e2, E2]). (cf. also alt_setup,
weight, rescan)
- sample_format
Variable that allows the user to specify additional event formats
beyond the WHIZARD native binary event format. Its syntax is
sample_format = <format>, where <format> can be any of
the following specifiers: hepevt, hepevt_verb, ascii,
athena, debug, long, short, hepmc,
lhef, lha, lha_verb, stdhep, stdhep_up,
lcio, mokka.
(cf. also $sample, simulate, hepevt, ascii,
athena, debug, long, short, hepmc,
lhef, lha, stdhep, stdhep_up, lcio,
mokka, $sample_normalization, ?sample_pacify,
sample_max_tries, sample_split_n_evt, sample_split_n_kbytes)
- scale
This is a command, scale = <expr>, that sets the kinematic scale
of a process or list of processes. Unless overwritten explicitly by
(→) factorization_scale and/or (→)
renormalization_scale it sets both scales. <expr> can be
any kinematic expression that leads to a result of momentum dimension
one, e.g. scale = 100 GeV, scale = eval Pt [e1].
- scan
Constructor to perform loops over variables or scan over processes in
the integration procedure. The syntax is scan <var> <var_name>
(<value list> or <value_init> => <value_fin> /<incrementor>
<increment>) { <scan_cmd> }. The variable var can be
specified if it is not a real, e.g. an integer. var_name is the
name of the variable which is also allowed to be a predefined one like
seed. For the scan, one can either specify an explicit list of
values value list, or use an initial and final value and a
rule to increment. The scan_cmd can either be just a
show to print out the scanned variable or the integration of a process.
Examples are: scan seed (32 => 1 // 2) { show (seed_value) }
, which runs the seed down in steps 32, 16, 8, 4, 2, 1 (division by
two). scan mW (75 GeV, 80 GeV => 82 GeV /+ 0.5 GeV, 83 GeV => 90
GeV /* 1.2) { show (sw) } scans over the W mass for the values
75, 80, 80.5, 81, 81.5, 82, 83 GeV, namely one discrete value, steps
by adding 0.5 GeV, and increase by 20 % (the latter having no effect
as it already exceeds the final value). It prints out the
corresponding value of the effective mixing angle which is defined as
a dependent variable in the model input file(s). scan sqrts (500 GeV =>
600 GeV /+ 10 GeV) { integrate (proc) } integrates the process
proc in eleven increasing 10 GeV steps in center-of-mass energy
from 500 to 600 GeV. (cf. also /+, /+/, /-,
/*, /*/, //)
- select
Subevent function select if <condition> [<list1> [ ,
<list2>]] that selects all particles in <list1>
that satisfy the condition <condition>. The second
particle list <list2> is for conditions that depend on
binary observables. (cf. also collect,
combine, extract, sort, +)
- select_b_jet
Subevent function select if <condition> [<list1> [ ,
<list2>]] that selects all particles in <list1>
that are b jets and satisfy the condition <condition>. The second particle list <list2> is for
conditions that depend on binary observables. (cf. also cluster,
collect, combine, extract, select,
sort, +)
- select_c_jet
Subevent function select if <condition> [<list1> [ ,
<list2>]] that selects all particles in <list1>
that are c jets (but not b jets) and satisfy the condition
<condition>. The second particle list <list2>
is for conditions that depend on binary observables. (cf. also
cluster, collect, combine, extract,
select, sort, +)
- select_light_jet
Subevent function select if <condition> [<list1> [ ,
<list2>]] that selects all particles in <list1>
that are light(-flavor) jets and satisfy the condition
<condition>. The second particle list <list2>
is for conditions that depend on binary observables. (cf. also
cluster, collect, combine, extract,
select, sort, +)
- select_non_b_jet
Subevent function select if <condition> [<list1> [ ,
<list2>]] that selects all particles in <list1>
that are not b jets (c and light jets) and satisfy the
condition <condition>. The second particle list <list2> is for conditions that depend on binary
observables. (cf. also cluster, collect, combine,
extract, select, sort, +)
- selection
Command that allows to select particular final states in an analysis
selection, selection = <log_expr>. The term log_expr can
be any kind of logical expression. The syntax matches exactly
the one of the (→) cuts command. E.g. selection = any
PDG == 13 is an electron selection in a lepton sample.
- sgn
Numerical function for integer and real numbers that gives the sign of
its argument: sgn (<num_val>) yields +1 if <num_val> is positive or zero, and −1 otherwise. (cf. also
abs, conjg, mod, modulo)
- short
Specifier for the sample_format command to demand the
generation of the short variant of HEPEVT ASCII event
files. (cf. also $sample, sample_format)
- show
This is a unary function that is operating on specific constructors in
order to print them out in the WHIZARD screen output as well as the
log file whizard.log. Examples are show(<parameter_name>)
to issue a specific parameter from a model or a constant defined in a
SINDARIN input file, show(integral(<proc_name>)),
show(library), show(results), or show(<var>) for any
arbitrary variable. Further possibilities are show(real),
show(string), show(logical) etc. to allow to show all
defined real, string, logical etc. variables, respectively.
(cf. also library, results)
- simulate
This command invokes the generation of events for the process
proc by means of simulate (<proc>).
Optional arguments: $sample, sample_format,
checkpoint (cf. also integrate, luminosity,
n_events, $sample, sample_format,
checkpoint, ?unweighted, safety_factor,
?negative_weights, sample_max_tries,
sample_split_n_evt, sample_split_n_kbytes)
- sin
Numerical function sin (<num_val>) that calculates the
sine trigonometric function of real and complex numerical numbers or
variables. (cf. also cos, tan, asin, acos,
atan)
- sinh
Numerical function sinh (<num_val>) that calculates the
hyperbolic sine function of real and complex numerical numbers or
variables. Note that its inverse function is part of the
Fortran2008 status and hence not realized. (cf. also cosh,
tanh)
- sort
Subevent function that allows to sort a particle list/subevent either
by increasing PDG code: sort [<particles>] (particles
first, then antiparticles). Alternatively, it can sort according to a
unary or binary particle observable (in that case there is a second
particle list, where the first particle is taken as a reference):
sort by <observable> [<particles> [, <ref_particles>]]. (cf. also extract, combine,
collect, join, by, +)
- sprintf
Command that allows to print data into a string variable: sprintf
"<string_expr>". There exist format specifiers, very similar
to the C command sprintf, e.g. sprintf "%i"
(123). (cf. printf, %d, %i, %e,
%f, %g, %E, %F, %G, %s)
- sqrt
Numerical function sqrt (<num_val>) that calculates the
square root of real and complex numerical numbers or
variables. (cf. also exp, log, log10)
- sqrts_hat
Real variable that accesses the partonic energy of a hard-scattering
process. It can be used in cuts or in an analysis, e.g. cuts =
sqrts_hat > <num> [ <phys_unit> ]. The physical unit
can be one of the following eV, keV, MeV, GeV,
and TeV. (cf. also sqrts, cuts, record)
- stable
This constructor allows particles in the final states of processes in
decay cascade set-up to be set as stable, and not letting them
decay. The syntax is stable <prt_name> (cf. also unstable)
- stdhep
Specifier for the sample_format command to demand the
generation of binary StdHEP event files based on the HEPEVT common
block. (cf. also $sample, sample_format)
- stdhep_up
Specifier for the sample_format command to demand the
generation of binary StdHEP event files based on the HEPRUP/HEPEUP common
blocks. (cf. also $sample, sample_format)
- sum
Takes the sum of an expression <expr> over the elements of
the given subevent <subevt>, sum <expr> [<subevt>], e.g.
sum Pt/2 [jets] (cf. eval, prod).
- tan
Numerical function tan (<num_val>) that calculates the
tangent trigonometric function of real and complex numerical numbers or
variables. (cf. also sin, cos, asin, acos,
atan)
- tanh
Numerical function tanh (<num_val>) that calculates the
hyperbolic tangent function of real and complex numerical numbers or
variables. Note that its inverse function is part of the
Fortran2008 status and hence not realized. (cf. also cosh,
sinh)
- TeV
Physical unit, for energies in 1012 electron volt. (cf. also
eV, keV, MeV, meV, GeV)
- then
Mandatory phrase in a conditional clause: if <log_expr> then
<expr 1> …endif. (cf. also if, else, elsif,
endif).
- Theta
Unary and also binary observable specifier, that as a unary observable
gives the angle between a particle’s momentum and the beam axis (+z
direction). As a binary observable, it gives the angle enclosed
between the momenta of the two particles: eval Theta [e1],
all Theta > 30 degrees [jet, jet]. (cf. also eval,
cuts, selection, Phi, Theta_star)
- Theta_star
Binary observable specifier, that gives the polar angle enclosed
between the momenta of the two particles in the rest frame of the
mother particle (momentum sum of the two particle): eval
Theta_star [jet, jet]. (cf. also eval,
cuts, selection, Theta)
- true
Constructor stating that a logical expression or variable is true,
e.g. ?<log_var> = true. (cf. also false).
- unpolarized
Constructor to force WHIZARD to discard polarization of the
corresponding particles in the generated events: unpolarized <prt1>
[, <prt2> , ...]. (cf. also polarized, simulate,
?polarized_events)
- unstable
This constructor allows to let final state particles of the hard
interaction undergo a subsequent (cascade) decay (in the on-shell
approximation). For this the user has to define the list of desired
|
| process zee = Z => e1, E1
process zuu = Z => u, U
process zz = e1, E1 => Z, Z
compile
integrate (zee) { iterations = 1:100 }
integrate (zuu) { iterations = 1:100 }
sqrts = 500 GeV
integrate (zz) { iterations = 3:5000, 2:5000 }
unstable Z (zee, zuu)
|
| |
|
|
Figure A.1: SINDARIN input file for unstable
particles and inclusive decays. |
decay channels as unstable <mother> (<decay1>, <decay2>, ....),
where mother is the mother particle, and the argument is a list
of decay channels. Note that – unless the ?auto_decays = true
flag has been set – these decay channels have to be provided by the
user as in the example in Fig. A.1. First, the Z
decays to electrons and up quarks are generated, then ZZ production
at a 500 GeV ILC is called, and then both Zs are decayed according
to the probability distribution of the two generated decay matrix
elements. This obviously allows also for inclusive decays.
(cf. also stable, ?auto_decays)
- weight
This is a command, weight = <expr>, that allows to specify a
weight for a process or list of processes. <expr> can be
any expression that leads to a scalar result, e.g. weight = 0.2,
weight = eval Pt [jet]. (cf. also rescan,
alt_setup, reweight)
- write_analysis
The write_analysis statement tells WHIZARD to write the
analysis setup by the user for the SINDARIN input file under
consideration. If no $out_file is provided, the histogram
tables/plot data etc. are written to the default file
whizard_analysis.dat. Note that the related command
compile_analysis does the same as write_analysis but in
addition invokes the WHIZARD LATEXroutines for producing
postscript or PDF output of the data.
(cf. also $out_file, compile_analysis)
- write_slha
Demands WHIZARD to write out a file in the SUSY Les Houches accord
(SLHA) format. (cf. also read_slha, ?slha_read_decays,
?slha_read_input, ?slha_read_spectrum)
A.2 Variables
A.2.1 Rebuild Variables
-
?rebuild_events (default: false)
This logical variable, if set true triggers WHIZARD to newly
create an event sample, even if nothing seems to have changed,
including the MD5 checksum. This can be used when manually
manipulating some settings. (cf also ?rebuild_grids,
?rebuild_library, ?rebuild_phase_space)
- ?rebuild_grids (default: false)
The logical variable ?rebuild_grids forces WHIZARD to newly
create the VAMP grids when using VAMP as an integration method, even
if they are already present. (cf. also ?rebuild_events,
?rebuild_library, ?rebuild_phase_space)
- ?rebuild_library (default: false)
The logical variable ?rebuild_library = true/false specifies
whether the library(-ies) for the matrix element code for processes is
re-generated (incl. possible Makefiles etc.) by the corresponding ME
method (e.g. if the process has been changed, but not its name). This
can also be set as a command-line option whizard --rebuild. The
default is false, i.e. code is never re-generated if it is
present and the MD5 checksum is valid.
(cf. also ?recompile_library, ?rebuild_grids,
?rebuild_phase_space)
- ?rebuild_phase_space (default: false)
This logical variable, if set true, triggers recreation of the
phase space file by WHIZARD(cf. also ?rebuild_events,
?rebuild_grids, ?rebuild_library)
- ?recompile_library (default: false)
The logical variable ?recompile_library = true/false specifies
whether the library(-ies) for the matrix element code for processes is
re-compiled (e.g. if the process code has been manually modified by
the user). This can also be set as a command-line option whizard
--recompile. The default is false, i.e. code is never
re-compiled if its corresponding object file is present. (cf. also
?rebuild_library)
A.2.2 Standard Variables
-
accuracy_goal (default: 0.00000E+00)
Real parameter that allows the user to set a minimal accuracy that should be achieved in the Monte-Carlo integration of a certain process. If that goal is reached, grid and weight adapation stop, and this result is used for simulation. (cf. also integrate, iterations, error_goal, relative_error_goal, error_threshold)
- ?allow_decays (default: true)
Master flag to switch on cascade decays for final state particles as an event transform. As a default, it is switched on. (cf. also ?auto_decays, auto_decays_multiplicity, ?auto_decays_radiative, ?decay_rest_frame)
- ?allow_hadronization (default: true)
Master flag to switch on hadronization as an event transform. As a default, it is switched on. (cf. also ?ps_ ...., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?allow_shower (default: true)
Master flag to switch on (initial and final state) parton shower, matching/merging as an event transform. As a default, it is switched on. (cf. also ?ps_ ...., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?alpha_evolve_analytic (default: true)
Flag that tells WHIZARD to use analytic running formulae for α instead of a numeric Runge-Kutta. (cf. also alpha_order, ?alpha_is_fixed, alpha_nf, alpha_nlep, ?alpha_from_me)
- ?alpha_is_fixed (default: true)
Flag that tells WHIZARD to use a non-running QED α. Note that this has to be set explicitly to false if the user wants to use one of the running α options. (cf. also alpha_order, alpha_nf, alpha_lep, ?alphas_from_me
- alpha_nf (default: -1)
Integer parameter that sets the number of active quark flavors for the internal evolution for running α in WHIZARD. The default, -1, keeps it equal to alphas_nf alpha_is_fixed, alphas_order, ?alpha_from_me, ?alpha_evolve_analytic
- alpha_nlep (default: 1)
Integer parameter that sets the number of active leptons in the running of α in WHIZARD. The deffault isone, with only the electron considered massless (cf. also alpha_is_fixed, alpha_nf, alpha_order, ?alpha_from_me, ?alpha_evolve_analytic)
- alpha_order (default: 0)
Integer parameter that sets the order of the internal evolution for running α in WHIZARD: the default, 0, is LO running, 1 is NLO. (cf. also alpha_is_fixed, alpha_nf, alphas_lep, ?alpha_from_me)
- alpha_power (default: 2)
Fixes the electroweak coupling powers used by BLHA matrix element generators. Setting these values is necessary for the correct generation of OLP-files. Having inconsistent values yields to error messages by the corresponding OLP-providers.
- ?alphas_from_lambda_qcd (default: false)
Flag that tells WHIZARD to use its internal running αs from αs(ΛQCD). Note that in that case ?alphas_is_fixed has to be set explicitly to false. (cf. also alphas_order, ?alphas_is_fixed, ?alphas_from_lhapdf, alphas_nf, ?alphas_from_pdf_builtin,
?alphas_from_mz, lambda_qcd)
- ?alphas_from_lhapdf (default: false)
Flag that tells WHIZARD to use a running αs from the LHAPDF library (which has to be correctly linked). Note that ?alphas_is_fixed has to be set explicitly to false. (cf. also alphas_order, ?alphas_is_fixed, ?alphas_from_pdf_builtin, alphas_nf, ?alphas_from_mz, ?alphas_from_lambda_qcd, lambda_qcd)
- ?alphas_from_mz (default: false)
Flag that tells WHIZARD to use its internal running αs from αs(MZ). Note that in that case ?alphas_is_fixed has to be set explicitly to false. (cf. also alphas_order, ?alphas_is_fixed, ?alphas_from_lhapdf, alphas_nf, ?alphas_from_pdf_builtin,
?alphas_from_lambda_qcd, lambda_qcd)
- ?alphas_from_pdf_builtin (default: false)
Flag that tells WHIZARD to use a running αs from the internal PDFs. Note that in that case ?alphas_is_fixed has to be set explicitly to false. (cf. also alphas_order, ?alphas_is_fixed, ?alphas_from_lhapdf, alphas_nf, ?alphas_from_mz,
?alphas_from_lambda_qcd, lambda_qcd)
- ?alphas_is_fixed (default: true)
Flag that tells WHIZARD to use a non-running QCD αs. Note that this has to be set explicitly to false if the user wants to use one of the running αs options. (cf. also alphas_order, ?alphas_from_lhapdf, ?alphas_from_pdf_builtin, alphas_nf, ?alphas_from_mz,
?alphas_from_lambda_qcd, lambda_qcd)
- alphas_nf (default: 5)
Integer parameter that sets the number of active quark flavors for the internal evolution for running αs in WHIZARD. (cf. also alphas_is_fixed, ?alphas_from_lhapdf, ?alphas_from_pdf_builtin, alphas_order, ?alphas_from_mz,
?alphas_from_lambda_qcd, lambda_qcd)
- alphas_order (default: 0)
Integer parameter that sets the order of the internal evolution for running αs in WHIZARD: the default, 0, is LO running, 1 is NLO, 2 is NNLO. (cf. also alphas_is_fixed, ?alphas_from_lhapdf, ?alphas_from_pdf_builtin, alphas_nf, ?alphas_from_mz,
?alphas_from_lambda_qcd, lambda_qcd)
- alphas_power (default: 0)
Fixes the strong coupling powers used by BLHA matrix element generators. Setting these values is necessary for the correct generation of OLP-files. Having inconsistent values yields to error messages by the corresponding OLP-providers.
- ?analysis_file_only (default: false)
Allows to specify that only LATEX files for WHIZARD’s graphical analysis are written out, but not processed. (cf. compile_analysis, write_analysis)
- antikt_algorithm (fixed value: 2)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_[for_passive_]algorithm, plugin_algorithm, genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_r)
- ?auto_decays (default: false)
Flag, particularly as optional argument of the (→) unstable command, that tells WHIZARD to automatically determine the decays of that particle up to the final state multplicity (→) auto_decays_multiplicity. Depending on the flag (→) ?auto_decays_radiative, radiative decays will be taken into account or not. (cf. also unstable, ?isotropic_decay, ?diagonal_decay)
- auto_decays_multiplicity (default: 2)
Integer parameter, that sets – for the (→) ?auto_decays option to let WHIZARD automatically determine the decays of a particle set as (→) unstable – the maximal final state multiplicity that is taken into account. The default is 2. The flag ?auto_decays_radiative decides whether radiative decays are taken into account. (cf. also unstable, ?auto_decays)
- ?auto_decays_radiative (default: false)
If WHIZARD’s automatic detection of decay channels are switched on (→ ?auto_decays for the (→) unstable command, this flags decides whether radiative decays (e.g. containing additional photon(s)/gluon(s)) are taken into account or not. (cf. also unstable, auto_decays_multiplicity)
- $beam_events_file
String variable that allows to set the name of the external file from which a beamstrahlung’s spectrum for lepton colliders as pairs of energy fractions is read in. (cf. also beam_events, ?beam_events_warn_eof)
- ?beam_events_warn_eof (default: true)
Flag that tells WHIZARD to issue a warning when in a simulation the end of an external file for beamstrahlung’s spectra for lepton colliders are reached, and energy fractions from the beginning of the file are reused. (cf. also beam_events, $beam_events_file)
- $blha_ew_scheme (default: "alpha_internal")
String variable that transfers the electroweak renormalization scheme via BLHA to the one-loop provider. Possible values are GF or Gmu for the Gµ scheme, alpha_internal (default, Gµ scheme, but value of αS calculated internally by WHIZARD), alpha_mz and alpha_0 (or alpha_thompson) for different schemes with α as input.
- blha_top_yukawa (default: -1.00000E+00)
If this value is set, the given value will be used as the top Yukawa coupling instead of the top mass. Note that having different values for yt and mt must be supported by your OLP-library and yield errors if this is not the case.
- $born_me_method (default: "")
This string variable specifies the method for the matrix elements to be used in the evaluation of the Born part of the NLO computation. The default is the empty string, i.e. the $method being the intrinsic O’Mega matrix element generator ("omega"), other options are: "ovm", "unit_test", "template", "template_unity", "threshold", "gosam", "openloops". Note that this option is inoperative if no NLO calculation is specified in the process definition. If you want ot use different matrix element methods in a LO computation, use the usual method command. (cf. also $correlation_me_method, $dglap_me_method, $loop_me_method and $real_tree_me_method.)
- cambridge_algorithm (fixed value: 1)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_for_passive_algorithm, plugin_algorithm, genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_r)
- cambridge_for_passive_algorithm (fixed value: 11)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_algorithm, plugin_algorithm,
genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_r)
- channel_weights_power (default: 2.50000E-01)
Real parameter that allows to vary the exponent of the channel weights for the VAMP integrator.
- ?check_event_file (default: true)
Setting this to false turns off all sanity checks when reading a raw event file with previously generated events. Use this at your own risk; the program may return wrong results or crash if data do not match. (cf. also ?check_grid_file, ?check_phs_file)
- ?check_event_weights_against_xsection (default: false)
Activates an internal recording of event weights when unweighted events are generated. At the end of the simulation, the mean value of the weights and its standard deviation are displayed. This allows to cross-check event generation and integration, because the value displayed must be equal to the integration result.
- ?check_grid_file (default: true)
Setting this to false turns off all sanity checks when reading a grid file with previous integration data. Use this at your own risk; the program may return wrong results or crash if data do not match. (cf. also ?check_event_file, ?check_phs_file)
- ?check_phs_file (default: true)
Setting this to false turns off all sanity checks when reading a previously generated phase-space configuration file. Use this at your own risk; the program may return wrong results or crash if data do not match. (cf. also ?check_event_file, ?check_grid_file)
- checkpoint (default: 0)
Setting this integer variable to a positive integer n instructs simulate to print out a progress summary every n events.
- $circe1_acc (default: "SBAND")
String variable that specifies the accelerator type for the CIRCE1 structure function for lepton-collider beamstrahlung. (?circe1_photons, ?circe1_photon2, circe1_sqrts, ?circe1_generate, ?circe1_map, circe1_eps, circe1_mapping_slope, circe1_ver,
circe1_rev, circe1_chat, ?circe1_with_radiation)
- circe1_chat (default: 0)
Chattiness of the CIRCE1 structure function for lepton-collider beamstrahlung. The higher the integer value, the more information will be given out by the CIRCE1 package. (?circe1_photons, ?circe1_photon2, circe1_sqrts, ?circe1_generate, ?circe1_map, circe1_eps, circe1_mapping_slope, circe1_ver,
circe1_rev, $circe1_acc, ?circe1_with_radiation)
- circe1_eps (default: 1.00000E-05)
Real parameter, that takes care of the mapping of the peak in the lepton collider beamstrahlung structure function spectrum of CIRCE1. (cf. also circe1, ?circe1_photons, ?circe1_photon2, circe1_sqrts, ?circe1_generate, ?circe1_map, circe1_eps,
circe1_mapping_slope, circe1_ver, circe1_rev, $circe1_acc, circe1_chat,
?circe1_with_radiation)
- ?circe1_generate (default: true)
Flag that determines whether the CIRCE1 structure function for lepton collider beamstrahlung uses the generator mode for the spectrum, or a pre-defined (semi-)analytical parameterization. Default is the generator mode. (cf. also circe1, ?circe1_photon1,
?circe1_photon2, circe1_sqrts, ?circe1_map, circe1_mapping_slope, circe1_eps,
circe1_ver, circe1_rev, $circe1_acc, circe1_chat, ?circe1_with_radiation)
- ?circe1_map (default: true)
Flag that determines whether the CIRCE1 structure function for lepton collider beamstrahlung uses special mappings for s-channel resonances. (cf. also circe1, ?circe1_photon1,
?circe1_photon2, circe1_sqrts, ?circe1_generate, circe1_mapping_slope, circe1_eps,
circe1_ver, circe1_rev, $circe1_acc, circe1_chat, ?circe1_with_radiation)
- circe1_mapping_slope (default: 2.00000E+00)
Real parameter that allows to vary the slope of the mapping function for the CIRCE1 structure function for lepton collider beamstrahlung from the default value 2.. (cf. also circe1, ?circe1_photon1, ?circe1_photon2, circe1_sqrts, ?circe1_generate, ?circe1_map, circe1_eps, circe1_ver, circe1_rev, $circe1_acc, circe1_chat,
?circe1_with_radiation)
- ?circe1_photon1 (default: false)
Flag to tell WHIZARD to use the photon of the CIRCE1 beamstrahlung structure function as initiator for the hard scattering process in the first beam. (cf. also circe1, ?circe1_photon2, circe1_sqrts, ?circe1_generate, ?circe1_map, circe1_eps,
circe1_mapping_slope, circe1_ver, circe1_rev, $circe1_acc, circe1_chat,
?circe1_with_radiation)
- ?circe1_photon2 (default: false)
Flag to tell WHIZARD to use the photon of the CIRCE1 beamstrahlung structure function as initiator for the hard scattering process in the second beam. (cf. also circe1, ?circe1_photon1, circe1_sqrts, ?circe1_generate, ?circe1_map, circe1_eps,
circe1_mapping_slope, circe1_ver, circe1_rev, $circe1_acc, circe1_chat,
?circe1_with_radiation)
- circe1_rev (default: 0)
Integer parameter that sets the internal revision number of the CIRCE1 structure function for lepton-collider beamstrahlung. The default 0 translates always into the most recent version; older versions have to be accessed through the explicit revision date. For more details cf. the CIRCE1manual. (cf. also circe1, ?circe1_photon1, ?circe1_photon2, ?circe1_generate, ?circe1_map, circe1_eps, circe1_mapping_slope, circe1_sqrts, circe1_ver, $circe1_acc, circe1_chat, ?circe1_with_radiation)
- circe1_sqrts
Real parameter that allows to set the value of the collider energy for the lepton collider beamstrahlung structure function CIRCE1. If not set, √s is taken. (cf. also circe1, ?circe1_photon1, ?circe1_photon2, ?circe1_generate, ?circe1_map, circe1_eps,
circe1_mapping_slope, circe1_ver, circe1_rev, $circe1_acc, circe1_chat,
?circe1_with_radiation)
- circe1_ver (default: 0)
Integer parameter that sets the internal versioning number of the CIRCE1 structure function for lepton-collider beamstrahlung. It has to be set by the user explicitly, it takes values from one to ten. (cf. also circe1, ?circe1_photon1, ?circe1_photon2, ?circe1_generate, ?circe1_map, circe1_eps, circe1_mapping_slope, circe1_sqrts, circe1_rev, $circe1_acc, circe1_chat, ?circe1_with_radiation)
- ?circe1_with_radiation (default: false)
This logical decides whether the additional photon or electron ("beam remnant") will be considered in the event record or not. (?circe1_photons, ?circe1_photon2, circe1_sqrts, ?circe1_generate, ?circe1_map, circe1_eps, circe1_mapping_slope, circe1_ver,
circe1_rev, $circe1_acc)
- $circe2_design (default: "*")
String variable that sets the collider design for the CIRCE2 structure function for photon collider spectra. (cf. also circe2, $circe2_file, ?circe2_polarized)
- $circe2_file
String variable by which the corresponding photon collider spectrum for the CIRCE2 structure function can be selected. (cf. also circe2, ?circe2_polarized, $circe2_design)
- ?circe2_polarized (default: true)
Flag whether the photon spectra from the CIRCE2 structure function for lepton colliders should be treated polarized. (cf. also circe2, $circe2_file, $circe2_design)
- ?ckkw_matching (default: false)
Master flag that switches on the CKKW(-L) (LO) matching between hard scattering matrix elements and QCD parton showers. Note that this is not yet (completely) implemented in WHIZARD. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ...)
- ?colorize_subevt (default: false)
Flag that enables color-index tracking in the subevent (subevt) objects that are used for internal event analysis.
- ?combined_nlo_integration (default: false)
When this option is set to true, the NLO integration will not be performed in the separate components, but instead the sum of all components will be integrated directly. When fixed-order NLO events are requested, this integration mode is possible, but not necessary. However, it is necessary for POWHEG events.
- $compile_workspace
If set, create process source code and process-driver library code in a subdirectory with this name. If non-existent, the directory will be created. (cf. also $job_id, $run_id, $integrate_workspace)
- $correlation_me_method (default: "")
This string variable specifies the method for the matrix elements to be used in the evaluation of the color (and helicity) correlated part of the NLO computation. The default is the same as the $method, i.e. the intrinsic O’Mega matrix element generator ("omega"), other options are: "ovm", "unit_test", "template", "template_unity", "threshold", "gosam", "openloops". (cf. also $born_me_method, $dglap_me_method, $loop_me_method and
$real_tree_me_method.)
- $dalitz_plot (default: "")
This string variable has two purposes: when different from the empty string, it switches on generation of the Dalitz plot file (ASCII tables) for the real emitters. The string variable itself provides the file name.
- ?debug_decay (default: true)
Flag that decides whether decay information will be displayed in the ASCII debug event format (→) debug. (cf. also sample_format, $sample, $debug_extension, ?debug_process, ?debug_transforms, ?debug_verbose)
- $debug_extension (default: "debug")
String variable that allows via $debug_extension = "<suffix>" to specify the suffix for the file name.suffix to which events in a long verbose format with debugging information are written. If not set, the default file name and suffix is <process_name>.debug. (cf. also sample_format, $sample, ?debug_process, ?debug_transforms, ?debug_decay, ?debug_verbose)
- ?debug_process (default: true)
Flag that decides whether process information will be displayed in the ASCII debug event format (→) debug. (cf. also sample_format, $sample, $debug_extension, ?debug_decay, ?debug_transforms, ?debug_verbose)
- ?debug_transforms (default: true)
Flag that decides whether information about event transforms will be displayed in the ASCII debug event format (→) debug. (cf. also sample_format, $sample, ?debug_decay, $debug_extension, ?debug_process, ?debug_verbose)
- ?debug_verbose (default: true)
Flag that decides whether extensive verbose information will be included in the ASCII debug event format (→) debug. (cf. also sample_format, $sample, $debug_extension, ?debug_decay, ?debug_transforms, ?debug_process)
- decay_helicity
If this parameter is given an integer value, any particle decay triggered by a subsequent unstable declaration will receive a projection on the given helicity state for the unstable particle. (cf. also unstable, ?isotropic_decay, ?diagonal_decay. The latter parameters, if true, take precdence over any ?decay_helicity setting.)
- ?decay_rest_frame (default: false)
Flag that allows to force a particle decay to be simulated in its rest frame. This simplifies the calculation for decays as stand-alone processes, but makes the process unsuitable for use in a decay chain.
- $description (default: "")
String variable that allows to specify a description text for the analysis, $description = "<LaTeX analysis descr.>". This line appears below the title of a corresponding analysis, on top of the respective plot. (cf. also analysis, n_bins, ?normalize_bins, $obs_unit, $x_label, $y_label, ?y_log, ?x_log, graph_width_mm, graph_height_mm, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_base, ?draw_histogram, ?fill_curve, ?draw_piecewise, ?draw_curve, ?draw_errors, $symbol, ?draw_symbols, $fill_options, $draw_options, $err_options)
- $dglap_me_method (default: "")
This string variable specifies the method for the matrix elements to be used in the evaluation of the DGLAP remnants of the NLO computation. The default is the same as $method, i.e. the O’Mega matrix element generator ("omega"), other options are: "ovm", "unit_test", "template", "template_unity", "threshold", "gosam", "openloops". (cf. also
$born_me_method, $correlation_me_method, $loop_me_method and $real_tree_me_method.)
- ?diagonal_decay (default: false)
Flag that – in case of using factorized production and decays using the (→) unstable command – tells WHIZARD instead of full spin correlations to take only the diagonal entries in the spin-density matrix (i.e. classical spin correlations). (cf. also unstable, ?auto_decays, decay_helicity, ?isotropic_decay)
- ?disable_subtraction (default: false)
Disables the subtraction of soft and collinear divergences from the real matrix element.
- ?draw_base
Settings for WHIZARD’s internal graphics output: flag that tells WHIZARD to insert a base statement in the analysis code to calculate the plot data from a data set. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max,
$gmlcode_fg, $gmlcode_bg, ?draw_curve, ?draw_piecewise, ?fill_curve, $symbol,
?draw_histogram, ?draw_errors, ?draw_symbols, $fill_options, $draw_options,
$err_options)
- ?draw_curve
Settings for WHIZARD’s internal graphics output: flag that tells WHIZARD to either plot data as a continuous line or as a histogram (if → ?draw_histogram is set true). (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max,
$gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?fill_curve, ?draw_histogram, ?draw_errors, ?draw_symbols, $fill_options, $draw_options, $err_options, $symbol)
- ?draw_errors
Settings for WHIZARD’s internal graphics output: flag that determines whether error bars should be drawn or not. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?fill_curve, ?draw_histogram, ?draw_curve, ?draw_symbols, $fill_options,
$draw_options, $err_options, $symbol)
- ?draw_histogram
Settings for WHIZARD’s internal graphics output: flag that tells WHIZARD to either plot data as a histogram or as a continuous line (if → ?draw_curve is set true). (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max,
$gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols, $fill_options, $draw_options, $err_options, $symbol)
- $draw_options
Settings for WHIZARD’s internal graphics output: $draw_options = "<LaTeX_code>" is a string variable that allows to set specific drawing options for plots and histograms. For more details see the gamelan manual. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_fg, $gmlcode_bg, ?draw_base,
?draw_piecewise, ?fill_curve, ?draw_histogram, ?draw_errors, ?draw_symbols,
$fill_options, ?draw_histogram, $err_options, $symbol)
- ?draw_piecewise
Settings for WHIZARD’s internal graphics output: flag that tells WHIZARD to data from a data set piecewise, i.e. histogram style. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_fg, $gmlcode_bg, ?draw_curve, ?draw_base, ?fill_curve, $symbol, ?draw_histogram, ?draw_errors, ?draw_symbols, $fill_options, $draw_options, $err_options)
- ?draw_symbols
Settings for WHIZARD’s internal graphics output: flag that determines whether particular symbols (specified by → $symbol = "<LaTeX_code>") should be used for plotting data points (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?fill_curve, ?draw_histogram, ?draw_curve, ?draw_errors, $fill_options, $draw_options,
$err_options, $symbol)
- ?dump_compressed (default: false)
Flag that, if set to true, issues a very compressed and clear version of the dump (→) event format. (cf. also sample_format, $sample, dump, $dump_extension, ?dump_screen, ?dump_summary, ?dump_weights)
- $dump_extension (default: "pset.dat")
String variable that allows via $dump_extension = "<suffix>" to specify the suffix for the file name.suffix to which events in WHIZARD’s internal particle set format are written. If not set, the default file name and suffix is <process_name>.pset.dat. (cf. also sample_format, $sample, dump, ?dump_compressed, ?dump_screen, ?dump_summary, ?dump_weights)
- ?dump_screen (default: false)
Flag that, if set to true, outputs events for the dump (→) event format on screen instead of to a file. (cf. also sample_format, $sample, dump, ?dump_compressed, $dump_extension, ?dump_summary, ?dump_weights)
- ?dump_summary (default: false)
Flag that, if set to true, includes a summary with momentum sums for incoming and outgoing particles as well as for beam remnants in the dump (→) event format. (cf. also sample_format, $sample, dump, ?dump_compressed, $dump_extension, ?dump_screen, ?dump_weights)
- ?dump_weights (default: false)
Flag that, if set to true, includes cross sections, weights and excess in the dump (→) event format. (cf. also sample_format, $sample, dump, ?dump_compressed, $dump_extension, ?dump_screen, ?dump_summary)
- ee_genkt_algorithm (fixed value: 53)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_[for_passive_]algorithm, plugin_algorithm, genkt_[for_passive_]algorithm, ee_kt_algorithm, jet_r), jet_p)
- ee_kt_algorithm (fixed value: 50)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_[for_passive_]algorithm, plugin_algorithm, genkt_[for_passive_]algorithm, ee_genkt_algorithm, jet_r)
- ellis_sexton_scale (default: -1.00000E+00)
Real positive paramter for the Ellis-Sexton scaleQ used both in the finite one-loop contribution provided bythe OLP and in the virtual counter terms. The NLO cross section isindependent of Q. Therefore, this allows for debugging ofthe implemention of the virtual counter terms. As the defaultQ = µR is chosen. So far, setting this parameteronly works for OpenLoops2, otherwise the default behaviour is invoked.
- ?energy_scan_normalize (default: false)
Normalization flag for the energy scan structure function: if set the total cross section is normalized to unity. (cf. also energy_scan)
- epa_alpha (default: 0.00000E+00)
For the equivalent photon approximation (EPA), this real parameter sets the value of αem used in the structure function. If not set, it is taken from the parameter set of the physics model in use (cf. also epa, epa_x_min, epa_mass, epa_e_max, epa_q_min, ?epa_recoil, ?epa_keep_energy, $epa_mode, ?epa_handler, $epa_handler_mode)
- ?epa_handler (default: false)
Activate EPA handler for event generation (no effect on integration). Requires epa_recoil = false
- $epa_handler_mode (default: "trivial")
Operation mode for the EPA event handler. Allowed values: trivial (no effect), recoil (recoil kinematics with two beams)
- ?epa_keep_energy (default: false)
As the splitting kinematics for the EPA structure function violates Lorentz invariance when the recoil is switched on, this flag forces energy conservation when set to true, otherwise violating energy conservation. (cf. also epa, epa_x_min, epa_mass, epa_alpha, epa_q_min, ?epa_recoil, $epa_mode, ?epa_handler, $epa_handler_mode)
- epa_mass (default: 0.00000E+00)
This real parameter allows to set by hand the mass of the incoming particle for the equivalent-photon approximation (EPA). If not set, the mass for the initial beam particle is taken from the model in use. (cf. also epa, epa_x_min, epa_e_max, epa_alpha, epa_q_min, ?epa_recoil, ?epa_keep_energy, $epa_mode. ?epa_handler, $epa_handler_mode)
- $epa_mode (default: "default")
For the equivalent photon approximation (EPA), this string variable defines the mode, i.e. the explicit formula for the EPA distribution. For more details cf. the manual. Possible are default (Budnev_617), Budnev_616e, log_power, log_simple, and log. (cf. also epa, epa_x_min, epa_mass, epa_e_max, epa_q_min, ?epa_recoil, ?epa_keep_energy, ?epa_handler, $epa_handler_mode)
- epa_q_max (default: 0.00000E+00)
This real parameter allows to set the upper energy cutoff for the equivalent-photon approximation (EPA). If not set, WHIZARD simply takes the collider energy, √s. (cf. also epa, epa_x_min, epa_mass, epa_alpha, epa_q_min, ?epa_recoil, $epa_mode, ?epa_keep_energy, ?epa_handler, $epa_handler_mode)
- epa_q_min (default: 0.00000E+00)
In the equivalent-photon approximation (EPA), this real parameters sets the minimal value for the transferred momentum. Either this parameter or the mass of the beam particle has to be non-zero. (cf. also epa, epa_x_min, epa_mass, epa_alpha, epa_q_max, ?epa_recoil, ?epa_keep_energy, $epa_mode, ?epa_handler, $epa_handler_mode)
- ?epa_recoil (default: false)
Flag to switch on recoil, i.e. a non-vanishing pT-kick for the equivalent-photon approximation (EPA). (cf. also epa, epa_x_min, epa_mass, epa_alpha, epa_e_max, epa_q_min, ?epa_keep_energy, $epa_mode, ?epa_handler, $epa_handler_mode)
- epa_x_min (default: 0.00000E+00)
Real parameter that sets the lower cutoff for the energy fraction in the splitting for the equivalent-photon approximation (EPA). This parameter has to be set by the user to a non-zero value smaller than one. (cf. also epa, epa_e_max, epa_mass, epa_alpha, epa_q_min, ?epa_recoil, ?epa_keep_energy, $epa_mode, ?epa_handler, $epa_handler_mode)
- $err_options
Settings for WHIZARD’s internal graphics output: $err_options = "<LaTeX_code>" is a string variable that allows to set specific drawing options for errors in plots and histograms. For more details see the gamelan manual. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?fill_curve, ?draw_histogram, ?draw_errors,
?draw_symbols, $fill_options, ?draw_histogram, $draw_options, $symbol)
- error_goal (default: 0.00000E+00)
Real parameter that allows the user to set a minimal absolute error that should be achieved in the Monte-Carlo integration of a certain process. If that goal is reached, grid and weight adapation stop, and this result is used for simulation. (cf. also integrate, iterations, accuracy_goal, relative_error_goal, error_threshold)
- error_threshold (default: 0.00000E+00)
The real parameter error_threshold = <num> declares that any error value (in absolute numbers) smaller than <num> is to be considered zero. The units are fb for scatterings and GeV for decays. (cf. also integrate, iterations, accuracy_goal, error_goal, relative_error_goal)
- event_callback_interval (default: 0)
Setting this integer variable to a positive integer n instructs simulate to print out a progress summary every n events.
- $event_file_version (default: "")
String variable that allows to set the format version of the WHIZARD internal binary event format.
- event_index_offset (default: 0)
The value event_index_offset = <num> initializes the event counter for a subsequent event sample. By default (value 0), the first event gets index value 1, incrementing by one for each generated event within a sample. The event counter is initialized again for each new sample (i.e., integrate command). If events are read from file, and the event file format supports event numbering, the event numbers will be taken from file instead, and the value of event_index_offset has no effect. (cf. luminosity, $sample, sample_format, ?unweighted, n_events)
- ?ewa_keep_energy (default: false)
As the splitting kinematics for the equivalent W approximation (EWA) violates Lorentz invariance when the recoil is switched on, this flag forces energy conservation when set to true, otherwise violating energy conservation. (cf. also ewa, ewa_x_min, ewa_pt_max, ewa_mass, ?ewa_recoil)
- ewa_mass (default: 0.00000E+00)
This real parameter allows to set by hand the mass of the incoming particle for the equivalent W approximation (EWA). If not set, the mass for the initial beam particle is taken from the model in use. (cf. also ewa, ewa_x_min, ewa_pt_max, ?ewa_keep_energy, ?ewa_recoil)
- ewa_pt_max (default: 0.00000E+00)
This real parameter allows to set the upper pT cutoff for the equivalent W approximation (EWA). If not set, WHIZARD simply takes the collider energy, √s. (cf. also ewa, ewa_x_min, ewa_mass, ?ewa_keep_energy, ?ewa_recoil)
- ?ewa_recoil (default: false)
For the equivalent W approximation (EWA), this flag switches on recoil, i.e. non-collinear splitting. (cf. also ewa, ewa_x_min, ewa_pt_max, ewa_mass, ?ewa_keep_energy)
- ewa_x_min (default: 0.00000E+00)
Real parameter that sets the lower cutoff for the energy fraction in the splitting for the equivalent W approximation (EWA). This parameter has to be set by the user to a non-zero value smaller than one. (cf. also ewa, ewa_pt_max, ewa_mass, ?ewa_keep_energy, ?ewa_recoil)
- $exclude_gauge_splittings (default: "c:b:t:e2:e3")
String variable that allows via $exclude_gauge_splittings = "<prt1>:<prt2>:…" to exclude fermion flavors from gluon/photon splitting into fermion pairs beyond LO. For example $exclude_gauge_splittings = "c:s:b:t" would lead to gl => u U and gl => d D as possible splittings in QCD. It is important to keep in mind that only the particles listed in the string are excluded! In QED this string would additionally allow for all splittings into lepton pairs A => l L. Therefore, once set the variable acts as a replacement of the default value, not as an addition! Note: "<prt>" can be both particle or antiparticle. It will always exclude the corresponding fermion pair. An empty string allows for all fermion flavors to take part in the splitting! Also, particles included in an alias are not excluded by $exclude_gauge_splittings!
- $extension_ascii_long (default: "long.evt")
String variable that allows via $extension_ascii_long = "<suffix>" to specify the suffix for the file name.suffix to which events in the so called long variant of the WHIZARD version 1 style HEPEVT ASCII format are written. If not set, the default file name and suffix is <process_name>.long.evt. (cf. also sample_format, $sample)
- $extension_ascii_short (default: "short.evt")
String variable that allows via $extension_ascii_short = "<suffix>" to specify the suffix for the file name.suffix to which events in the so called short variant of the WHIZARD version 1 style HEPEVT ASCII format are written. If not set, the default file name and suffix is <process_name>.short.evt. (cf. also sample_format, $sample)
- $extension_athena (default: "athena.evt")
String variable that allows via $extension_athena = "<suffix>" to specify the suffix for the file name.suffix to which events in the ATHENA file format are written. If not set, the default file name and suffix is <process_name>.athena.evt. (cf. also sample_format, $sample)
- $extension_default (default: "evt")
String variable that allows via $extension_default = "<suffix>" to specify the suffix for the file name.suffix to which events in a the standard WHIZARD verbose ASCII format are written. If not set, the default file name and suffix is <process_name>.evt. (cf. also sample_format, $sample)
- $extension_hepevt (default: "hepevt")
String variable that allows via $extension_hepevt = "<suffix>" to specify the suffix for the file name.suffix to which events in the WHIZARD version 1 style HEPEVT ASCII format are written. If not set, the default file name and suffix is <process_name>.hepevt. (cf. also sample_format, $sample)
- $extension_hepevt_verb (default: "hepevt.verb")
String variable that allows via $extension_hepevt_verb = "<suffix>" to specify the suffix for the file name.suffix to which events in the WHIZARD version 1 style extended or verbose HEPEVT ASCII format are written. If not set, the default file name and suffix is <process_name>.hepevt.verb. (cf. also sample_format, $sample)
- $extension_hepmc (default: "hepmc")
String variable that allows via $extension_hepmc = "<suffix>" to specify the suffix for the file name.suffix to which events in the HepMC format are written. If not set, the default file name and suffix is <process_name>.hepmc. (cf. also sample_format, $sample)
- $extension_lcio (default: "slcio")
String variable that allows via $extension_lcio = "<suffix>" to specify the suffix for the file name.suffix to which events in the LCIO format are written. If not set, the default file name and suffix is <process_name>.slcio. (cf. also sample_format, $sample)
- $extension_lha (default: "lha")
String variable that allows via $extension_lha = "<suffix>" to specify the suffix for the file name.suffix to which events in the (deprecated) LHA format are written. If not set, the default file name and suffix is <process_name>.lha. (cf. also sample_format, $sample)
- $extension_lha_verb (default: "lha.verb")
String variable that allows via $extension_lha_verb = "<suffix>" to specify the suffix for the file name.suffix to which events in the (deprecated) extended or verbose LHA format are written. If not set, the default file name and suffix is <process_name>.lha.verb. (cf. also sample_format, $sample)
- $extension_mokka (default: "mokka.evt")
String variable that allows via $extension_mokka = "<suffix>" to specify the suffix for the file name.suffix to which events in the MOKKA format are written. If not set, the default file name and suffix is <process_name>.mokka.evt. (cf. also sample_format, $sample)
- $extension_raw (default: "evx")
String variable that allows via $extension_raw = "<suffix>" to specify the suffix for the file name.suffix to which events in WHIZARD’s internal format are written. If not set, the default file name and suffix is <process_name>.evx. (cf. also sample_format, $sample)
- $extension_stdhep (default: "hep")
String variable that allows via $extension_stdhep = "<suffix>" to specify the suffix for the file name.suffix to which events in the StdHEP format via the HEPEVT common block are written. If not set, the default file name and suffix is <process_name>.hep. (cf. also sample_format, $sample)
- $extension_stdhep_ev4 (default: "ev4.hep")
String variable that allows via $extension_stdhep_ev4 = "<suffix>" to specify the suffix for the file name.suffix to which events in the StdHEP format via the HEPEVT/HEPEV4 common blocks are written. <process_name>.up.hep is the default file name and suffix, if this variable not set. (cf. also sample_format, $sample)
- $extension_stdhep_up (default: "up.hep")
String variable that allows via $extension_stdhep_up = "<suffix>" to specify the suffix for the file name.suffix to which events in the StdHEP format via the HEPRUP/HEPEUP common blocks are written. <process_name>.up.hep is the default file name and suffix, if this variable not set. (cf. also sample_format, $sample)
- ?fatal_beam_decay (default: true)
Logical variable that let the user decide whether the possibility of a beam decay is treated as a fatal error or only as a warning. An example is a process b t → X, where the bottom quark as an inital state particle appears as a possible decay product of the second incoming particle, the top quark. This might trigger inconsistencies or instabilities in the phase space set-up.
- $fc (default: "Fortran-compiler")
This string variable gives the Fortran compiler used within WHIZARD. It can only be accessed, not set by the user. (cf. also $fcflags, $fclibs)
- $fcflags (default: "Fortran-flags")
This string variable gives the compiler flags for the Fortran compiler used within WHIZARD. It can only be accessed, not set by the user. (cf. also $fc, $fclibs)
- $fclibs (default: "Fortran-libs")
This string variable gives the linked libraries for the Fortran compiler used within WHIZARD. It can only be accessed, not set by the user. (cf. also $fc, $fcflags)
- ?fill_curve
Settings for WHIZARD’s internal graphics output: flag that tells WHIZARD to fill data curves (e.g. as a histogram). The style can be set with → $fill_options = "<LaTeX_code>". (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max,
$gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?draw_curve, ?draw_histogram, ?draw_errors, ?draw_symbols, $fill_options, $draw_options, $err_options, $symbol)
- $fill_options
Settings for WHIZARD’s internal graphics output: $fill_options = "<LaTeX_code>" is a string variable that allows to set fill options when plotting data as filled curves with the → ?fill_curve flag. For more details see the gamelan manual. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?draw_curve, ?draw_histogram, ?draw_errors,
?draw_symbols, ?fill_curve, $draw_options, $err_options, $symbol)
- ?fixed_order_nlo_events (default: false)
Induces the generation of fixed-order NLO events.
- fks_delta_i (default: 2.00000E+00)
Real parameter for the FKS phase space that applies a cut to the y variable with 0 < δI ≤ 2 for initial state singularities only. The dependence on the parameter vanishes between real subtraction and integrated subtraction term. For debugging purposes.
- fks_delta_o (default: 2.00000E+00)
Real parameter for the FKS phase space that applies a cut to the y variable with 0 < δo ≤ 2 for final state singularities only. The dependence on the parameter vanishes between real subtraction and integrated subtraction term. For debugging purposes.
- fks_dij_exp1 (default: 1.00000E+00)
Fine-tuning parameters of the FKS final state partition functions. The exact meaning depends on the mapping implementation. (cf. also fks_dij_exp2, $fks_mapping_type, fks_xi_min, fks_y_max)
- fks_dij_exp2 (default: 1.00000E+00)
Fine-tuning parameters of the FKS initial state partition functions. The exact meaning depends on the mapping implementation. (cf. also fks_dij_exp1, $fks_mapping_type, fks_xi_min, fks_y_max)
- $fks_mapping_type (default: "default")
Sets the FKS mapping type. Possible values are "default" and "resonances". The latter option activates the resonance-aware subtraction mode and induces the generation of a soft mismatch component. (cf. also fks_dij_exp1, fks_dij_exp2, fks_xi_min, fks_y_max)
- fks_xi_cut (default: 1.00000E+00)
(Experimental) Real parameter for the FKS phase space that applies a cut to ξ variable with 0 < ξcut≤ ξmax. The dependence on the parameter vanishes between real subtraction and integrated subtraction term. Could thus be used for debugging. This is not implemented properly, use at your own risk!
- fks_xi_min (default: 0.00000E+00)
Real parameter for the FKS phase space that sets the numerical lower value of the ξ variable. Valid for the value range [tiny_07,1], where value inputs out of bounds will take the value of the closest bound. Here, tiny_07 = 1E9_default * epsilon (0._default), where epsilon is an intrinsic Fortran function. (cf. also fks_dij_exp1, fks_dij_exp2, $fks_mapping_type, fks_y_max)
- fks_y_max (default: 1.00000E+00)
Real parameter for the FKS phase space that sets the numerical upper value of the |y| variable. Valid for ranges [0,1], where value inputs out of bounds will take the value of the closest bound. Only supported for massless FSR. (cf. also fks_dij_exp1, $fks_mapping_type, fks_dij_exp2)
- form_threads (default: 2)
The number of threads used by Gosam when matrix elements are evaluated using FORM
- form_workspace (default: 1000)
The size of the workspace Gosam requires from FORM. Inside FORM, it corresponds to the heap size used by the algebra processor.
- gaussian_spread1 (default: 0.00000E+00)
Parameter that sets the energy spread (σ value) of the first beam for a Gaussian spectrum. (cf. gaussian)
- gaussian_spread2 (default: 0.00000E+00)
Ditto, for the second beam.
- genkt_algorithm (fixed value: 3)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_for_passive_algorithm, plugin_algorithm, genkt_for_passive_algorithm, ee_[gen]kt_algorithm, jet_r), jet_p
- genkt_for_passive_algorithm (fixed value: 13)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_for_passive_algorithm, plugin_algorithm, genkt_algorithm, ee_[gen]kt_algorithm, jet_r)
- gks_multiplicity (default: 0)
Jet multiplicity for the GKS merging scheme.
- $gmlcode_bg (default: "")
Settings for WHIZARD’s internal graphics output: string variable that allows to define a background for plots and histograms (i.e. it is overwritten by the plot/histogram), e.g. a grid: $gmlcode_bg = "standardgrid.lr(5);". For more details, see the gamelan manual. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_fg, ?draw_histogram, ?draw_base, ?draw_piecewise,
?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols, $fill_options,
$draw_options, $err_options, $symbol)
- $gmlcode_fg (default: "")
Settings for WHIZARD’s internal graphics output: string variable that allows to define a foreground for plots and histograms (i.e. it overwrites the plot/histogram), e.g. a grid: $gmlcode_bg = "standardgrid.lr(5);". For more details, see the gamelan manual. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_bg, ?draw_histogram, ?draw_base, ?draw_piecewise,
?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols, $fill_options,
$draw_options, $err_options, $symbol)
- $gosam_fc (default: "")
The Fortran compiler used by Gosam.
- $gosam_filter_lo (default: "")
The filter string given to Gosam in order to filter out tree-level diagrams. (cf. also $gosam_filter_nlo, $gosam_symmetries)
- $gosam_filter_nlo (default: "")
The same as $gosam_filter_lo, but for loop matrix elements. (cf. also $gosam_filter_nlo, $gosam_symmetries)
- $gosam_symmetries (default: "family,generation")
String variable that is transferred to Gosam configuration file to determine whether certain helicity configurations are considered to be equal. Possible values are flavour, family etc. For more info see the Gosam manual.
- graph_height_mm (default: 90)
Settings for WHIZARD’s internal graphics output: integer value that sets the height of a graph or histogram in millimeters. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_histogram, ?draw_base,
?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols,
$fill_options, $draw_options, $err_options, $symbol)
- graph_width_mm (default: 130)
Settings for WHIZARD’s internal graphics output: integer value that sets the width of a graph or histogram in millimeters. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_histogram, ?draw_base,
?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols,
$fill_options, $draw_options, $err_options, $symbol)
- hadron_enhanced_fraction (default: 1.00000E-02)
Fraction of Lund strings that break with enhanced width. [not yet active]
- hadron_enhanced_width (default: 2.00000E+00)
Enhancement factor for the width of breaking Lund strings. [not yet active]
- ?hadronization_active (default: false)
Master flag to switch hadronization (through the attached PYTHIA package) on or off. As a default, it is off. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ...)
- $hadronization_method (default: "PYTHIA6")
Determines whether WHIZARD’s own hadronization or the (internally included) PYTHIA6 should be used.
- ?helicity_selection_active (default: true)
Flag that decides whether WHIZARD uses a numerical selection rule for vanishing helicities: if active, then, if a certain helicity combination yields an absolute (O’Mega) matrix element smaller than a certain threshold (→ helicity_selection_threshold) more often than a certain cutoff (→ helicity_selection_cutoff), it will be dropped.
- helicity_selection_cutoff (default: 1000)
Integer parameter that gives the number a certain helicity combination of an (O’Mega) amplitude has to be below a certain threshold (→ helicity_selection_threshold) in order to be dropped from then on. (cf. also ?helicity_selection_active)
- helicity_selection_threshold (default: 1.00000E+10)
Real parameter that gives the threshold for the absolute value of a certain helicity combination of an (O’Mega) amplitude. If a certain number (→ helicity_selection_cutoff) of calls stays below this threshold, that combination will be dropped from then on. (cf. also ?helicity_selection_active)
- ?hepevt_ensure_order (default: false)
Flag to ensure that the particle set confirms the HEPEVT standard. This involves some copying and reordering to guarantee that mothers and daughters are always next to each other. Usually this is not necessary.
- $hepmc3_mode (default: "HepMC3")
This specifies the writer mode for HepMC3. Possible values are HepMC2, HepMC3 (default), HepEVT, Root. and RootTree (cf. also hepmc)
- ?hepmc3_write_flows (default: false)
Flag for the HepMC3 event format that decideswhether to write out color flows. The default is false. (cf. also hepmc)
- ?hepmc_output_cross_section (default: false)
Flag for the HepMC event format that allows to write out the cross section (and error) from the integration together with each HepMC event. This can be used by programs like Rivet to scale histograms according to the cross section. (cf. also hepmc)
- ?hoppet_b_matching (default: false)
Flag that switches on the matching between 4- and 5-flavor schemes for hadron collider b-parton initiated processes. Works either with builtin PDFs or with the external LHAPDF interface. Needs the external HOPPET library to be linked. (cf. beams, pdf_builtin, lhapdf)
- $integrate_workspace
Character string that tells WHIZARD the subdirectory where to find the run-specific phase-space configuration and the VAMP and VAMP2 grid files. If undefined (as per default), WHIZARD creates them and searches for them in the current directory. (cf. also $job_id, $run_id, $compile_workspace)
- $integration_method (default: "vamp")
This string variable specifies the method for performing the multi-dimensional phase-space integration. The default is the VAMP algorithm ("vamp"), other options are via the numerical midpoint rule ("midpoint") or an alternate VAMP2 implementation that is MPI-parallelizable ("vamp2").
- integration_results_verbosity (default: 1)
Integer parameter for the verbosity of the integration results in the process-specific logfile.
- ?integration_timer (default: true)
This flag switches the integration timer on and off, that gives the estimate for the duration of the generation of 10,000 unweighted events for each integrated process.
- ?isotropic_decay (default: false)
Flag that – in case of using factorized production and decays using the (→) unstable command – tells WHIZARD to switch off spin correlations completely (isotropic decay). (cf. also unstable, ?auto_decays, decay_helicity, ?diagonal_decay)
- isr_alpha (default: 0.00000E+00)
For lepton collider initial-state QED radiation (ISR), this real parameter sets the value of αem used in the structure function. If not set, it is taken from the parameter set of the physics model in use (cf. also isr, isr_q_max, isr_mass, isr_order, ?isr_recoil, ?isr_keep_energy)
- ?isr_handler (default: false)
Activate ISR handler for event generation (no effect on integration). Requires isr_recoil = false
- ?isr_handler_keep_mass (default: true)
If true (default), force the incoming partons of the hard process (after radiation) on their mass shell. Otherwise, insert massless on-shell momenta. This applies only for event generation (no effect on integration, cf. also ?isr_handler)
- $isr_handler_mode (default: "trivial")
Operation mode for the ISR event handler. Allowed values: trivial (no effect), recoil (recoil kinematics with two photons)
- ?isr_keep_energy (default: false)
As the splitting kinematics for the ISR structure function violates Lorentz invariance when the recoil is switched on, this flag forces energy conservation when set to true, otherwise violating energy conservation. (cf. also isr, isr_q_max, isr_mass, isr_order, ?isr_recoil, ?isr_alpha)
- isr_log_order (default: 0)
For lepton collider initial-state QED radiation (ISR), this integer parameters sets the logarithmic order: 0 (default) is LL, 1 is NLL. (cf. also isr, isr_q_max, isr_mass, isr_alpha, ?isr_recoil, ?isr_keep_energy, isr_order)
- isr_mass (default: 0.00000E+00)
This real parameter allows to set by hand the mass of the incoming particle for lepton collider initial-state QED radiation (ISR). If not set, the mass for the initial beam particle is taken from the model in use. (cf. also isr, isr_q_max, isr_alpha, isr_order, ?isr_recoil, ?isr_keep_energy, isr_log_order)
- isr_order (default: 3)
For lepton collider initial-state QED radiation (ISR), this integer parameter allows to set the order up to which hard-collinear radiation is taken into account. Default is the highest available, namely third order. (cf. also isr, isr_q_max, isr_mass, isr_alpha, ?isr_recoil, ?isr_keep_energy, isr_log_order)
- isr_q_in (default: -1.00000E+00)
This is the starting scale for the running of the QED coupling alpha. If negative, the electron mass is taken. (cf. also isr, isr_q_max, isr_alpha, isr_order, ?isr_recoil, ?isr_keep_energy, isr_log_order)
- isr_q_max (default: 0.00000E+00)
This real parameter allows to set the scale of the initial-state QED radiation (ISR) structure function. If not set, it is taken internally to be √s. (cf. also isr, isr_alpha, isr_mass, isr_order, ?isr_recoil, ?isr_keep_energy)
- ?isr_recoil (default: false)
Flag to switch on recoil, i.e. a non-vanishing pT-kick for the lepton collider initial-state QED radiation (ISR). (cf. also isr, isr, isr_alpha, isr_mass, isr_order, isr_q_max, isr_log_order)
- jet_algorithm (default: 999)
Variable that allows to set the type of jet algorithm when using the external FastJet library. It accepts one of the following algorithms: (→) kt_algorithm,
(→) cambridge_[for_passive_]algorithm, (→) antikt_algorithm, (→) plugin_algorithm, (→) genkt_[for_passive_]algorithm, (→) ee_[gen]kt_algorithm). (cf. also cluster, jet_p, jet_r, jet_ycut)
- jet_dcut (default: 0.00000E+00)
Value for the dij separation measure used in the e+e− kT algorithms that are available via the interface to the FastJet package. (cf. also cluster, combine, kt_algorithm, jet_algorithm, cambridge_[for_passive_]algorithm, antikt_algorithm,
plugin_algorithm, genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_p,
jet_r)
- jet_p (default: 0.00000E+00)
Value for the exponent of the distance measure R in the generalized kT algorithms that are available via the interface to the FastJet package. (cf. also cluster, combine, jet_algorithm, kt_algorithm, cambridge_[for_passive_]algorithm, antikt_algorithm,
plugin_algorithm, genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_r,
jet_ycut)
- jet_r (default: 0.00000E+00)
Value for the distance measure R used in some algorithms that are available via the interface to the FastJet package. (cf. also cluster, combine, jet_algorithm, kt_algorithm, cambridge_[for_passive_]algorithm, antikt_algorithm,
plugin_algorithm, genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_p,
jet_ycut)
- jet_ycut (default: 0.00000E+00)
Value for the y separation measure used in the Cambridge-Aachen algorithms that are available via the interface to the FastJet package. (cf. also cluster, combine, kt_algorithm, jet_algorithm, cambridge_[for_passive_]algorithm, antikt_algorithm,
plugin_algorithm, genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_p,
jet_r)
- $job_id
Arbitrary string that can be used for creating unique names. The variable is initialized with the value of the job_id option on startup. (cf. also $compile_workspace, $run_id)
- ?keep_beams (default: false)
The logical variable ?keep_beams = true/false specifies whether beam particles and beam remnants are included when writing event files. For example, in order to read Les Houches accord event files into PYTHIA, no beam particles are allowed.
- ?keep_failed_events (default: false)
In the context of weighted event generation, if set to true, events with failed kinematics will be written to the event output with an associated weight of zero. This way, the total cross section can be reconstructed from the event output.
- ?keep_flavors_when_clustering (default: false)
The logical variable ?keep_flavors_when_clustering = true/false specifies whether the flavor of a jet should be kept during cluster when a jet consists of one quark and zero or more gluons. Especially useful for cuts on b-tagged jets (cf. also cluster).
- ?keep_flavors_when_recombining (default: true)
The logical variable ?keep_flavors_when_recombining = true/false specifies whether the flavor of a particle should be kept during photon_recombination when a jet/lepton consists of one lepton/quark and zero or more photons (cf. also photon_recombination).
- ?keep_remnants (default: true)
The logical variable ?keep_beams = true/false is respected only if ?keep_beams is set. If true, beam remnants are tagged as outgoing particles if they have been neither showered nor hadronized, i.e., have no children. If false, beam remnants are also included in the event record, but tagged as unphysical. Note that for ISR and/or beamstrahlung spectra, the radiated photons are considered as beam remnants.
- kt_algorithm (fixed value: 0)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also cambridge_[for_passive_]algorithm, plugin_algorithm,
genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_r)
- lambda_qcd (default: 2.00000E-01)
Real parameter that sets the value for ΛQCD used in the internal evolution for running αs in WHIZARD. (cf. also alphas_is_fixed, ?alphas_from_lhapdf, alphas_nf,
?alphas_from_pdf_builtin, ?alphas_from_mz, ?alphas_from_lambda_qcd, alphas_order)
- lcio_run_id (default: 0)
Allows to set an integer run ID for the LCIO event format. Normally, the process ID is taken as run ID, unless the flag (cf.) ?proc_as_run_id is set to false, cf. also process.
- $lhapdf_dir (default: "")
String variable that tells the path where the LHAPDF library and PDF sets can be found. When the library has been correctly recognized during configuration, this is automatically set by WHIZARD. (cf. also lhapdf, $lhapdf_file, lhapdf_photon, $lhapdf_photon_file, lhapdf_member, lhapdf_photon_scheme)
- $lhapdf_file (default: "")
This string variable $lhapdf_file = "<pdf_set>" allows to specify the PDF set <pdf_set> from the external LHAPDF library. It must match the exact name of the PDF set from the LHAPDF library. The default is empty, and the default set from LHAPDF is taken. Only one argument is possible, the PDF set must be identical for both beams, unless there are fundamentally different beam particles like proton and photon. (cf. also lhapdf, $lhapdf_dir, lhapdf_photon, $lhapdf_photon_file, lhapdf_photon_scheme, lhapdf_member)
- lhapdf_member (default: 0)
Integer variable that specifies the number of the corresponding PDF set chosen via the command (→) $lhapdf_file or (→) $lhapdf_photon_file from the external LHAPDF library. E.g. error PDF sets can be chosen by this. (cf. also lhapdf, $lhapdf_dir, $lhapdf_file, lhapdf_photon, $lhapdf_photon_file, lhapdf_photon_scheme)
- $lhapdf_photon_file (default: "")
String variable $lhapdf_photon_file = "<pdf_set>" analagous to (→) $lhapdf_file for photon PDF structure functions from the external LHAPDF library. The name must exactly match the one of the set from LHAPDF. (cf. beams, lhapdf, $lhapdf_dir, $lhapdf_file, $lhapdf_photon_file, lhapdf_member, lhapdf_photon_scheme)
- lhapdf_photon_scheme (default: 0)
Integer parameter that controls the different available schemes for photon PDFs inside the external LHAPDF library. For more details see the LHAPDF manual. (cf. also lhapdf, $lhapdf_dir, $lhapdf_file, lhapdf_photon, $lhapdf_photon_file, lhapdf_member)
- $lhef_extension (default: "lhe")
String variable that allows via $lhef_extension = "<suffix>" to specify the suffix for the file name.suffix to which events in the LHEF format are written. If not set, the default file name and suffix is <process_name>.lhe. (cf. also sample_format, $sample, lhef, $lhef_extension, $lhef_version, ?lhef_write_sqme_prc, ?lhef_write_sqme_ref, ?lhef_write_sqme_alt)
- $lhef_version (default: "2.0")
Specifier for the Les Houches Accord (LHEF) event format files with XML headers to discriminate among different versions of this format. (cf. also $sample, sample_format, lhef, $lhef_extension, $lhef_extension, ?lhef_write_sqme_prc, ?lhef_write_sqme_ref, ?lhef_write_sqme_alt)
- ?lhef_write_sqme_alt (default: true)
Flag that decides whether in the (→) lhef event format alternative weights of the squared matrix element shall be written in the LHE file. (cf. also $sample, sample_format, lhef, $lhef_extension, $lhef_extension, ?lhef_write_sqme_prc, ?lhef_write_sqme_ref)
- ?lhef_write_sqme_prc (default: true)
Flag that decides whether in the (→) lhef event format the weights of the squared matrix element of the corresponding process shall be written in the LHE file. (cf. also $sample, sample_format, lhef, $lhef_extension, $lhef_extension, ?lhef_write_sqme_ref,
?lhef_write_sqme_alt)
- ?lhef_write_sqme_ref (default: false)
Flag that decides whether in the (→) lhef event format reference weights of the squared matrix element shall be written in the LHE file. (cf. also $sample, sample_format, lhef, $lhef_extension, $lhef_extension, ?lhef_write_sqme_prc, ?lhef_write_sqme_alt)
- $library_name
Similar to $model_name, this string variable is used solely to access the name of the active process library, e.g. in printf statements. (cf. compile, library, printf, show, $model_name)
- ?logging (default: true)
This logical – when set to false – suppresses writing out a logfile (default: whizard.log) for the whole WHIZARD run, or when WHIZARD is run with the --no-logging option, to suppress parts of the logging when setting it to true again at a later part of the SINDARIN input file. Mainly for debugging purposes. (cf. also ?openmp_logging, ?mpi_logging)
- $loop_me_method (default: "")
This string variable specifies the method for the matrix elements to be used in the evaluation of the virtual part of the NLO computation. The default is the empty string, i.e. the same as $method. Working options are: "threshold", "openloops", "recola", "gosam". (cf. also $real_tree_me_method, $correlation_me_method and $born_me_method.)
- luminosity (default: 0.00000E+00)
This specifier luminosity = <num> sets the integrated luminosity (in inverse femtobarns, fb−1) for the event generation of the processes in the SINDARIN input files. Note that WHIZARD itself chooses the number from the luminosity or from the n_events specifier, whichever would give the larger number of events. As this depends on the cross section under consideration, it might be different for different processes in the process list. (cf. n_events, $sample, sample_format, ?unweighted)
- max_bins (default: 20)
Integer parameter that modifies the settings of the VAMP integrator’s grid parameters. It sets the maximal number of bins per integration dimension. (cf. iterations, min_bins, min_calls_per_channel, min_calls_per_bin)
- ?me_verbose (default: false)
Flag determining whether the makefile command for generating and compiling the O’Mega matrix element code is silent or verbose. Default is silent.
- $method (default: "omega")
This string variable specifies the method for the matrix elements to be used in the evaluation. The default is the intrinsic O’Mega matrix element generator ("omega"), other options are: "ovm", "unit_test", "template_unity", "threshold". For processes defined "template", with nlo_calculation = ..., please refer to $born_me_method, $real_tree_me_method, $loop_me_method and $correlation_me_method.
- min_bins (default: 3)
Integer parameter that modifies the settings of the VAMP integrator’s grid parameters. It sets the minimal number of bins per integration dimension. (cf. iterations, max_bins, min_calls_per_channel, min_calls_per_bin)
- min_calls_per_bin (default: 10)
Integer parameter that modifies the settings of the VAMP integrator’s grid parameters. It sets the minimal number every bin in an integration dimension must be called. If the number of calls from the iterations is too small, WHIZARD will automatically increase the number of calls. (cf. iterations, min_calls_per_channel, min_bins, max_bins)
- min_calls_per_channel (default: 10)
Integer parameter that modifies the settings of the VAMP integrator’s grid parameters. It sets the minimal number every channel must be called. If the number of calls from the iterations is too small, WHIZARD will automatically increase the number of calls. (cf. iterations, min_calls_per_bin, min_bins, max_bins)
- mlm_ETclusfactor (default: 2.00000E-01)
This real parameter is a factor that enters the calculation of the ycut measure for jet clustering after the parton shower in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_ETclusminE (default: 5.00000E+00)
This real parameter is a minimal energy that enters the calculation of the ycut measure for jet clustering after the parton shower in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_Eclusfactor (default: 1.00000E+00)
This real parameter is a factor that enters the calculation of the ycut measure for jet clustering after the parton shower in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_Emin (default: 0.00000E+00)
Real parameter that sets a minimal energy Emin value as an infrared cutoff in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_Qcut_ME (default: 0.00000E+00)
Real parameter that in the MLM jet matching between hard matrix elements and QCD parton shower sets a possible virtuality cut on jets from the hard matrix element. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_Qcut_PS (default: 0.00000E+00)
Real parameter that in the MLM jet matching between hard matrix elements and QCD parton shower sets a possible virtuality cut on jets from the parton shower. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_Rclusfactor (default: 1.00000E+00)
This real parameter is a factor that enters the calculation of the ycut measure for jet clustering after the parton shower in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_Rmin (default: 0.00000E+00)
Real parameter that sets a minimal R distance value that enters the ycut jet clustering measure in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_etaclusfactor (default: 1.00000E+00)
This real parameter is a factor that enters the calculation of the ycut measure for jet clustering after the parton shower in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_etamax (default: 0.00000E+00)
This real parameter sets a maximal pseudorapidity that enters the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- ?mlm_matching (default: false)
Master flag to switch on MLM (LO) jet matching between hard matrix elements and the QCD parton shower. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_nmaxMEjets (default: 0)
This integer sets the maximal number of jets that are available from hard matrix elements in the MLM jet matching between hard matrix elements and QCD parton shower. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- mlm_ptmin (default: 0.00000E+00)
This real parameter sets a minimal pT that enters the ycut jet clustering measure in the MLM jet matching between hard matrix elements and QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., mlm_ ..., ?hadronization_active)
- $model_name
This variable makes the locally used physics model available as a string, e.g. as show ($model_name). However, the user is not able to change the current model by setting this variable to a different string. (cf. also model, $library_name, printf, show)
- ?mpi_logging (default: false)
This logical – when set to false – suppresses writing out messages about MPI parallelization (number of used workers etc.) on screen and into the logfile (default name whizard.log) for the whole WHIZARD run. Mainly for debugging purposes. (cf. also ?logging, ?openmp_logging)
- ?muli_active (default: false)
Master flag that switches on WHIZARD’s module for multiple interaction with interleaved QCD parton showers for hadron colliders. Note that this feature is still experimental. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ...)
- mult_call_dglap (default: 1.00000E+00)
(Real-valued) multiplier for the number of calls used in the integration of the DGLAP remnant NLO component. This way, a higher accuracy can be achieved for this component, while simultaneously avoiding redundant integration calls for the other components. (cf. also mult_call_real, mult_call_virt)
- mult_call_real (default: 1.00000E+00)
(Real-valued) multiplier for the number of calls used in the integration of the real subtraction NLO component. This way, a higher accuracy can be achieved for the real component, while simultaneously avoiding redundant integration calls for the other components. (cf. also mult_call_dglap, mult_call_virt)
- mult_call_virt (default: 1.00000E+00)
(Real-valued) multiplier for the number of calls used in the integration of the virtual NLO component. This way, a higher accuracy can be achieved for this component, while simultaneously avoiding redundant integration calls for the other components. (cf. also mult_call_dglap, mult_call_real)
- n_bins (default: 20)
Settings for WHIZARD’s internal graphics output: integer value that sets the number of bins in histograms. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_histogram, ?draw_base, ?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols,
$fill_options, $draw_options, $err_options, $symbol)
- n_calls_test (default: 0)
Integer variable that allows to set a certain number of matrix element sampling test calls without actually integrating the process under consideration. (cf. integrate)
- n_events (default: 0)
This specifier n_events = <num> sets the number of events for the event generation of the processes in the SINDARIN input files. Note that WHIZARD itself chooses the number from the n_events or from the luminosity specifier, whichever would give the larger number of events. As this depends on the cross section under consideration, it might be different for different processes in the process list. (cf. luminosity, $sample, sample_format, ?unweighted, event_index_offset)
- $negative_sf (default: "default")
String variable to set the behavior to either keep negative structure function/PDF values or set them to zero. The default ("default") takes the first option for NLO and the second for LO processes. Explicit behavior can be set with "positive" or "negative".
- ?negative_weights (default: false)
Flag that tells WHIZARD to allow negative weights in integration and simulation. (cf. also simulate, ?unweighted)
- $nlo_correction_type (default: "QCD")
String variable which sets the NLO correction type via nlo_correction_type = "<type>" to either "QCD", "EW", or to all with <type> set to "Full". Must be set before the process statement.
- ?nlo_cut_all_real_sqmes (default: false)
Flag that decides whether in the case that the real component does not pass a cut, its subtraction term shall be discarded for that phase space point as well or not. (cf. also ?nlo_use_born_scale)
- ?nlo_reuse_amplitudes_fks (default: false)
Only compute real and virtual amplitudes for subprocesses that give a different amplitude and reuse the result for equivalent subprocesses. Might give a speed-up for some processes. Might break others, especially in cases where resonance histories are needed. Experimental feature, use at your own risk!
- ?nlo_use_born_scale (default: false)
Flag that decides whether a scale expression defined for the Born component of an NLO process shall be applied to all other components as well or not. (cf. also ?nlo_cut_all_real_sqmes)
- ?normalize_bins (default: false)
Settings for WHIZARD’s internal graphics output: flag that determines whether the weights shall be normalized to the bin width or not. (cf. also n_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_histogram,
?draw_base, ?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors, $symbol,
?draw_symbols, $fill_options, $draw_options, $err_options)
- $obs_label (default: "")
Settings for WHIZARD’s internal graphics output: this is a string variable $obs_label = "<LaTeX_Code>" that allows to attach a label to a plotted or histogrammed observable. (cf. also n_bins, ?normalize_bins, $obs_unit, $title, $description, $x_label, $y_label, ?y_log, ?x_log, graph_width_mm, graph_height_mm, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_base, ?draw_histogram, ?draw_piecewise,
?fill_curve, ?draw_curve, ?draw_errors, $symbol, ?draw_symbols, $fill_options, $draw_options, $err_options)
- $obs_unit (default: "")
Settings for WHIZARD’s internal graphics output: this is a string variable $obs_unit = "<LaTeX_Code>" that allows to attach a LATEX physical unit to a plotted or histogrammed observable. (cf. also n_bins, ?normalize_bins, $obs_unit, $title, $description, $x_label, $y_label, ?y_log, ?x_log, graph_width_mm, graph_height_mm, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_base, ?draw_histogram, ?fill_curve, ?draw_piecewise, ?draw_curve, ?draw_errors, $symbol, ?draw_symbols, $fill_options, $draw_options, $err_options)
- $omega_flags (default: "")
String variable that allows to pass flags to the O’Mega matrix element generator. Normally, WHIZARD takes care of all flags automatically. Note that for restrictions of intermediate states, there is a special string variable: (cf. →) $restrictions.
- ?omega_openmp (default: false)
Flag to switch on or off OpenMP multi-threading for O’Mega matrix elements. (cf. also $method, $omega_flag)
- ?omega_write_phs_output (default: false)
This flag decides whether a the phase-space output is produced by the O’Mega matrix element generator. This output is written to file(s) and contains the Feynman diagrams which belong to the process(es) under consideration. The file is mandatory whenever the variable $phs_method has the value fast_wood, i.e. if the phase-space file is provided by cascades2.
- $openloops_allowed_libs (default: "")
String variable to restrict the allowed OpenLoopsprocess libraries for a process. (cf. also $method, openloos_verbosity, ?openloops_use_cms, openloops_stability_log, ?openloops_switch_off_muon_yukawa)
- $openloops_extra_cmd (default: "")
String variable to transfer customized special commands to OpenLoops. The three supported examples $openloops_extra_command = "extra approx top/stop/not" are for selection of subdiagrams in top production. (cf. also $method, openloos_verbosity, ?openloops_use_cms, openloops_stability_log, ?openloops_switch_off_muon_yukawa)
- openloops_phs_tolerance (default: 7)
This integer parameter gives via openloops_phs_tolerance = <n> the relative numerical tolerance 10−n for the momentum conservation of the external particles within OpenLoops. (cf. also openloos_verbosity, $method, ?openloops_switch_off_muon_yukawa,
openloops_stability_log, $openloops_extra_cmd)
- openloops_stability_log (default: 0)
Creates the directory stability_log containing information about the performance of the OpenLoopsmatrix elements. Possible values are 0 (No output), 1 (On finish()-call), 2 (Adaptive) and 3 (Always).
- ?openloops_switch_off_muon_yukawa (default: false)
Sets the Yukawa coupling of muons for OpenLoops to zero. (cf. also openloos_verbosity, $method, ?openloops_use_cms, openloops_stability_log, $openloops_extra_cmd)
- ?openloops_use_cms (default: true)
Activates the complex mass scheme in OpenLoops. (cf. also openloos_verbosity, $method, ?openloops_switch_off_muon_yukawa, openloops_stability_log,
$openloops_extra_cmd)
- openloops_verbosity (default: 1)
Decides how much OpenLoops output is printed. Can have values 0, 1 and 2, where 2 is the highest verbosity level.
- ?openmp_is_active (fixed value: false)
Flag to switch on or off OpenMP multi-threading for WHIZARD. (cf. also ?openmp_logging, openmp_num_threads, openmp_num_threads_default, ?omega_openmp)
- ?openmp_logging (default: true)
This logical – when set to false – suppresses writing out messages about OpenMP parallelization (number of used threads etc.) on screen and into the logfile (default name whizard.log) for the whole WHIZARD run. Mainly for debugging purposes. (cf. also ?logging, ?mpi_logging)
- openmp_num_threads (default: 1)
Integer parameter that sets the number of OpenMP threads for multi-threading. (cf. also ?openmp_logging, openmp_num_threads_default, ?omega_openmp)
- openmp_num_threads_default (fixed value: 1)
Integer parameter that shows the number of default OpenMP threads for multi-threading. Note that this parameter can only be accessed, but not reset by the user. (cf. also ?openmp_logging, openmp_num_threads, ?omega_openmp)
- ?out_advance (default: true)
Flag that sets advancing in the printf output commands, i.e. continuous printing with no line feed etc. (cf. also printf)
- $out_file (default: "")
This character variable allows to specify the name of the data file to which the histogram and plot data are written (cf. also write_analysis, open_out, close_out)
- ?pacify (default: false)
Flag that allows to suppress numerical noise and give screen and log file output with a lower number of significant digits. Mainly for debugging purposes. (cf. also ?sample_pacify)
- $pdf_builtin_set (default: "CTEQ6L")
For WHIZARD’s internal PDF structure functions for hadron colliders, this string variable allows to set the particular PDF set. (cf. also pdf_builtin, pdf_builtin_photon)
- photon_iso_eps (default: 1.00000E+00)
Photon isolation parameter єγ (energy fraction) from hep-ph/9801442 (cf. also photon_iso_n, photon_iso_r0)
- photon_iso_n (default: 1.00000E+00)
Photon isolation parameter n (cone function exponent) from hep-ph/9801442 (cf. also photon_iso_eps, photon_iso_r0)
- photon_iso_r0 (default: 4.00000E-01)
Photon isolation parameter R0γ (isolation cone radius) from hep-ph/9801442 (cf. also photon_iso_eps, photon_iso_n)
- photon_rec_r0 (default: 1.00000E-01)
Photon recombination parameter R0γ for photon recombination in NLO EW calculations
- phs_e_scale (default: 1.00000E+01)
Real parameter that sets the energy scale that acts as a cutoff for parameterizing radiation-like kinematics in the wood phase space method. WHIZARD takes the maximum of this value and the width of the propagating particle as a cutoff. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_off_shell, phs_m_scale, phs_q_scale,
?phs_keep_resonant, ?phs_step_mapping, ?phs_step_mapping_exp, ?phs_s_mapping)
- $phs_file (default: "")
This string variable allows the user to set an individual file name for the phase space parameterization for a particular process: $phs_file = "<file_name>". If not set, the default is <proc_name>_<proc_comp>.<run_id>.phs. (cf. also $phs_method)
- ?phs_keep_nonresonant (default: true)
Flag that decides whether the wood phase space method takes into account also non-resonant contributions. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_off_shell, phs_m_scale, phs_q_scale, phs_e_scale, ?phs_step_mapping,
?phs_step_mapping_exp, ?phs_s_mapping)
- phs_m_scale (default: 1.00000E+01)
Real parameter that sets the mass scale that acts as a cutoff for parameterizing collinear and infrared kinematics in the wood phase space method. WHIZARD takes the maximum of this value and the mass of the propagating particle as a cutoff. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_off_shell, phs_e_scale, phs_q_scale,
?phs_keep_resonant, ?phs_step_mapping, ?phs_step_mapping_exp, ?phs_s_mapping)
- $phs_method (default: "default")
String variable that allows to choose the phase-space parameterization method. The default is the "wood" method that takes into account electroweak/BSM resonances. Note that this might not be the best choice for (pure) QCD amplitudes. (cf. also $phs_file)
- phs_off_shell (default: 2)
Integer parameter that sets the number of off-shell (not t-channel-like, non-resonant) lines that are taken into account to find a valid phase-space setup in the wood phase-space method. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_e_scale, phs_m_scale, phs_q_scale, ?phs_keep_resonant, ?phs_step_mapping,
?phs_step_mapping_exp, ?phs_s_mapping)
- ?phs_only (default: false)
Flag (particularly as optional argument of the → integrate command) that allows to only generate the phase space file, but not perform the integration. (cf. also $phs_method, $phs_file)
- phs_q_scale (default: 1.00000E+01)
Real parameter that sets the momentum transfer scale that acts as a cutoff for parameterizing t- and u-channel like kinematics in the wood phase space method. WHIZARD takes the maximum of this value and the mass of the propagating particle as a cutoff. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_off_shell, phs_e_scale, phs_m_scale, ?phs_keep_resonant, ?phs_step_mapping, ?phs_step_mapping_exp,
?phs_s_mapping)
- ?phs_s_mapping (default: true)
Flag that allows special mapping for s-channel resonances. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_off_shell, phs_e_scale, phs_m_scale,
?phs_keep_resonant, ?phs_q_scale, ?phs_step_mapping, ?phs_step_mapping_exp)
- ?phs_step_mapping (default: true)
Flag that switches on (or off) a particular phase space mapping for resonances, where the mass and width of the resonance are explicitly set as channel cutoffs. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_off_shell, phs_e_scale,
phs_m_scale, ?phs_keep_resonant, ?phs_q_scale, ?phs_step_mapping_exp,
?phs_s_mapping)
- ?phs_step_mapping_exp (default: true)
Flag that switches on (or off) a particular phase space mapping for resonances, where the mass and width of the resonance are explicitly set as channel cutoffs. This is an exponential mapping in contrast to (→) ?phs_step_mapping. (cf. also phs_threshold_t, phs_threshold_s, phs_t_channel, phs_off_shell, phs_e_scale, phs_m_scale,
?phs_q_scale, ?phs_keep_resonant, ?phs_step_mapping, ?phs_s_mapping)
- phs_t_channel (default: 6)
Integer parameter that sets the number of t-channel propagators in multi-peripheral diagrams that are taken into account to find a valid phase-space setup in the wood phase-space method. (cf. also phs_threshold_t, phs_threshold_s, phs_off_shell, phs_e_scale, phs_m_scale, phs_q_scale, ?phs_keep_resonant, ?phs_step_mapping,
?phs_step_mapping_exp, ?phs_s_mapping)
- phs_threshold_s (default: 5.00000E+01)
For the phase space method wood, this real parameter sets the threshold below which particles are assumed to be massless in the s-channel like kinematic regions. (cf. also phs_threshold_t, phs_off_shell, phs_t_channel, phs_e_scale, phs_m_scale,
phs_q_scale, ?phs_keep_resonant, ?phs_step_mapping, ?phs_step_mapping_exp,
?phs_s_mapping)
- phs_threshold_t (default: 1.00000E+02)
For the phase space method wood, this real parameter sets the threshold below which particles are assumed to be massless in the t-channel like kinematic regions. (cf. also phs_threshold_s, phs_off_shell, phs_t_channel, phs_e_scale, phs_m_scale,
phs_q_scale, ?phs_keep_resonant, ?phs_step_mapping, ?phs_step_mapping_exp,
?phs_s_mapping)
- plugin_algorithm (fixed value: 99)
Specifies a jet algorithm for the (→) jet_algorithm command, used in the (→) cluster subevent function. At the moment only available for the interfaced external FastJet package. (cf. also kt_algorithm, cambridge_for_passive_algorithm,
genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_r)
- $polarization_mode (default: "helicity")
String variable that specifies the mode in which the polarization of particles is handled when polarized events are written out. Possible options are "ignore", "helicity", "factorized", and "correlated". For more details cf. the detailed section.
- ?polarized_events (default: false)
Flag that allows to select certain helicity combinations in final state particles in the event files, and perform analysis on polarized event samples. (cf. also simulate, polarized, unpolarized)
- ?powheg_disable_sudakov (default: false)
This flag allows to set the Sudakov form factor to one. This effectively results in a version of the matrix-element method (MEM) at NLO.
- powheg_grid_size_xi (default: 5)
Number of ξ points in the POWHEG grid.
- powheg_grid_size_y (default: 5)
Number of y points in the POWHEG grid.
- powheg_lambda (default: 0.00000E+00)
Reference scale of the αs evolution in the POWHEG matching algorithm. Per default we use ΛMSnf=5.
- ?powheg_matching (default: false)
Activates Powheg matching. Needs to be combined with the ?combined_nlo_integration-method.
- powheg_pt_min (default: 1.00000E+00)
Lower pT-cut-off for the POWHEG hardest emission.
- ?powheg_test_sudakov (default: false)
Performs an internal consistency check on the POWHEG event generation.
- ?powheg_use_singular_jacobian (default: false)
This allows to give a different normalization of the Jacobian, resulting in an alternative POWHEG damping in the singular regions.
- ?proc_as_run_id (default: true)
Normally, for LCIO the process ID (cf. process_num_id) is used as run ID, unless this flag is set to false, cf. also process, lcio_run_id.
- process_num_id
Using the integer process_num_id = <int_var> one can set a numerical identifier for processes within a process library. This can be set either just before the corresponding process definition or as an optional local argument of the latter. (cf. also process, ?proc_as_run_id, lcio_run_id)
- $ps_PYTHIA8_config (default: "")
String variable that allows to pass options for tunes etc. to the attached PYTHIA8 parton shower or hadronization, e.g.: $ps_PYTHIA8_config = "PartonLevel:MPI = off". (cf. also
?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- $ps_PYTHIA8_config_file (default: "")
String variable that allows to pass a filename to a PYTHIA8 configuration file.
- $ps_PYTHIA_PYGIVE (default: "")
String variable that allows to pass options for tunes etc. to the attached PYTHIA parton shower or hadronization, e.g.: $ps_PYTHIA_PYGIVE = "MSTJ(41)=1". (cf. also
?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_fixed_alphas (default: 0.00000E+00)
This real parameter sets the value of αs if it is (cf. → ?ps_isr_alphas_running,
?ps_fsr_alphas_running) not running in initial and/or final-state QCD showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_fsr_active (default: false)
Flag that switches final-state QCD radiation (FSR) on. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_fsr_alphas_running (default: true)
Flag that decides whether a running αs is taken in time-like QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_fsr_lambda (default: 2.90000E-01)
By this real parameter, the value of ΛQCD used in running αs for time-like showers is set (except for showers in the decay of a resonance). (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_isr_active (default: false)
Flag that switches initial-state QCD radiation (ISR) on. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_isr_alphas_running (default: true)
Flag that decides whether a running αs is taken in space-like QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_isr_angular_ordered (default: true)
If switched one, this flag forces opening angles of emitted partons in the QCD ISR shower to be strictly ordered, i.e. increasing towards the hard interaction. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_isr_lambda (default: 2.90000E-01)
By this real parameter, the value of ΛQCD used in running αs for space-like showers is set. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_isr_minenergy (default: 1.00000E+00)
By this real parameter, the minimal effective energy (in the c.m. frame) of a time-like or on-shell-emitted parton in a space-like QCD shower is set. For a hard subprocess that is not in the rest frame, this number is roughly reduced by a boost factor 1/γ to the rest frame of the hard scattering process. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_isr_only_onshell_emitted_partons (default: false)
This flag if set true sets all emitted partons off space-like showers on-shell, i.e. it would not allow associated time-like showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_isr_primordial_kt_cutoff (default: 5.00000E+00)
Real parameter that sets the upper cutoff for the primordial kT distribution inside a hadron. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?hadronization_active, ?mlm_ ...)
- ps_isr_primordial_kt_width (default: 0.00000E+00)
This real parameter sets the width σ = ⟨kT2⟩ for the Gaussian primordial kT distribution inside the hadron, given by: exp[−kT2/σ2] kT dkT. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_isr_pt_ordered (default: false)
By this flag, it can be switched between the analytic QCD ISR shower (false, default) and the pT ISR QCD shower (true). (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_isr_tscalefactor (default: 1.00000E+00)
The Q2 scale of the hard scattering process is multiplied by this real factor to define the maximum parton virtuality allowed in time-like QCD showers. This does only apply to t- and u-channels, while for s-channel resonances the maximum virtuality is set by m2. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_isr_z_cutoff (default: 9.99000E-01)
This real parameter allows to set the upper cutoff on the splitting variable z in space-like QCD parton showers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_mass_cutoff (default: 1.00000E+00)
Real value that sets the QCD parton shower lower cutoff scale, where hadronization sets in. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_max_n_flavors (default: 5)
This integer parameter sets the maxmimum number of flavors that can be produced in a QCD shower g→ qq. It is also used as the maximal number of active flavors for the running of αs in the shower (with a minimum of 3). (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ?ps_taudec_active (default: false)
Flag to switch on τ decays, at the moment only via the included external package TAUOLA and PHOTOS. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?hadronization_active)
- ps_tauola_dec_mode1 (default: 0)
Integer code to request a specific τ decay within TAUOLA for the decaying τ, and – in correlated decays – for the second τ. For more information cf. the comments in the code or the TAUOLA manual. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ps_tauola_dec_mode2 (default: 0)
Integer code to request a specific τ decay within TAUOLA for the decaying τ, and – in correlated decays – for the second τ. For more information cf. the comments in the code or the TAUOLA manual. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ?ps_tauola_dec_rad_cor (default: true)
Flag to switch radiative corrections for τ decays in TAUOLA on or off. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ps_tauola_mh (default: 1.25000E+02)
Real option to set the Higgs mass for Higgs decays into τ leptons in the interface to TAUOLA. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ps_tauola_mix_angle (default: 9.00000E+01)
Option to set the mixing angle between scalar and pseudoscalar Higgs bosons for Higgs decays into τ leptons in the interface to TAUOLA. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ?ps_tauola_photos (default: false)
Flag to switch on PHOTOS for photon showering inside the TAUOLA package. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ?ps_tauola_pol_vector (default: false)
Flag to decide whether for transverse τ polarization, polarization information should be taken from TAUOLA or not. The default is just based on random numbers. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ?ps_tauola_transverse (default: false)
Flag to switch transverse τ polarization on or off for Higgs decays into τ leptons. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ..., ?ps_taudec_active)
- ?read_color_factors (default: true)
This flag decides whether to read QCD color factors from the matrix element provided by each method, or to try and calculate the color factors in WHIZARD internally.
- ?read_raw (default: true)
This flag demands WHIZARD to (try to) read events (from the internal binary format) first before generating new ones. (cf. simulate, ?write_raw, $sample, sample_format)
- real_epsilon (fixed value: 0.00000E+00)
This gives the smallest number E of the same kind as the float type for which 1 + E > 1. It cannot be set by the user. (cf. also real_range, real_tiny, real_precision).
- $real_partition_mode (default: "default")
String variable to choose which parts of the real cross section are to be integrated. With the default value ("default") or "off" the real cross section is integrated as usual without partition. If set to "on" or "all", the real cross section is split into singular and finite part using a partition function F, such that R = [1−F(pT2)]R + F(pT2)R = Rfin + Rsing. The emission generation is then performed using Rsing, whereas Rfin is treated separately. If set to "singular" ("finite"), only the singular (finite) real component is integrated.(cf. also real_partition_scale)
- real_partition_scale (default: 1.00000E+01)
This real variable sets the invariant mass of the FKS pair used as a separator between the singular and the finite part of the real subtraction terms in an NLO calculation, e.g. in e+e− → ttj. (cf. also $real_partition_mode)
- real_precision (fixed value: 15)
This integer gives the precision of the numeric model for the real float type in use. It cannot be set by the user. (cf. also real_range, real_epsilon, real_tiny).
- real_range (fixed value: 307)
This integer gives the decimal exponent range of the numeric model for the real float type in use. It cannot be set by the user. (cf. also real_precision, real_epsilon, real_tiny).
- real_tiny (fixed value: 0.00000E+00)
This gives the smallest positive (non-zero) number in the numeric model for the real float type in use. It cannot be set by the user. (cf. also real_range, real_epsilon, real_precision).
- $real_tree_me_method (default: "")
This string variable specifies the method for the matrix elements to be used in the evaluation of the real part of the NLO computation. The default is the same as the $method, i.e. the intrinsic O’Mega matrix element generator ("omega"), other options are: "ovm", "unit_test", "template", "template_unity", "threshold", "gosam", "openloops". (cf. also $born_me_method, $correlation_me_method, $dglap_me_method and $loop_me_method.)
- ?recover_beams (default: true)
Flag that decides whether the beam particles should be reconstructed when reading event/rescanning files into WHIZARD. (cf. rescan, ?update_event, ?update_sqme,
?update_weight)
- relative_error_goal (default: 0.00000E+00)
Real parameter that allows the user to set a minimal relative error that should be achieved in the Monte-Carlo integration of a certain process. If that goal is reached, grid and weight adaptation stop, and this result is used for simulation. (cf. also integrate, iterations, accuracy_goal, error_goal, error_threshold)
- ?report_progress (default: true)
Flag for the O’Mega matrix element generator whether to print out status messages about progress during matrix element generation. (cf. also $method, $omega_flags)
- ?rescan_force (default: false)
Flag that allows to bypass essential checks on the particle set when reading event/rescanning files into WHIZARD. (cf. rescan, ?update_event, ?update_sqme,
?update_weight)
- $rescan_input_format (default: "raw")
String variable that allows to set the event format of the event file that is to be rescanned by the (→) rescan command.
- resonance_background_factor (default: 1.00000E+00)
The real variable resonance_background_factor controls resonance insertion if a resonance history applies to a particular event. In determining whether event kinematics qualifies as resonant or non-resonant, the non-resonant probability is multiplied by this factor Setting the factor to zero removes the background configuration as long as the kinematics qualifies as on-shell as qualified by resonance_on_shell_limit.
- ?resonance_history (default: false)
The logical variable ?resonance_history = true/false specifies whether during a simulation pass, the event generator should try to reconstruct intermediate resonances. If activated, appropriate resonant subprocess matrix element code will be automatically generated.
- resonance_on_shell_limit (default: 4.00000E+00)
The real variable resonance_on_shell_limit = <num> specifies the maximum relative distance from a resonance peak, such that the kinematical configuration can still be considered on-shell. This is relevant only if ?resonance_history = true.
- resonance_on_shell_turnoff (default: 0.00000E+00)
The real variable resonance_on_shell_turnoff = <num>, if positive, controls the smooth transition from resonance-like to background-like events. The relative strength of a resonance is reduced by a Gaussian with width given by this variable. In any case, events are treated as background-like when the off-shellness is greater than resonance_on_shell_limit. All of this applies only if ?resonance_history = true.
- $resonances_exclude_particles (default: "default")
Accepts a string of particle names. These particles will be ignored when the resonance histories are generated. If $fks_mapping_type is not "resonances", this option does nothing.
- $restrictions (default: "")
This is an optional argument for process definitions for the matrix element method "omega". Using the following construction, it defines a string variable, process
<process_name> = <particle1>, <particle2> => <particle3>, <particle4>, ... { $restrictions = "<restriction_def>" }. The string argument <restriction_def> is directly transferred during the code generation to the ME generator O’Mega. It has to be of the form n1 + n2 + ... ~ <particle (list)>, where n1 and so on are the numbers of the particles above in the process definition. The tilde specifies a certain intermediate state to be equal to the particle(s) in particle (list). An example is process eemm_z = e1, E1 => e2, E2 { $restrictions = "1+2 ~ Z" } restricts the code to be generated for the process e− e+ → µ− µ+ to the s-channel Z-boson exchange. For more details see Sec. 9.3 (cf. also process)
- $rng_method (default: "tao")
String variable that allows to set the method for the random number generation. Default is Donald Knuth’ RNG method TAO.
- $run_id (default: "")
String variable $run_id = "<id>" that allows to set a special ID for a particular process run, e.g. in a scan. The run ID is then attached to the process log file:
<proc_name>_<proc_comp>.<id>.log, the VAMP grid file:
<proc_name>_<proc_comp>.<id>.vg, and the phase space file:
<proc_name>_<proc_comp>.<id>.phs. The run ID string distinguishes among several runs for the same process. It identifies process instances with respect to adapted integration grids and similar run-specific data. The run ID is kept when copying processes for creating instances, however, so it does not distinguish event samples. (cf. also $job_id, $compile_workspace
- safety_factor (default: 1.00000E+00)
This real variable safety_factor = <num> reduces the acceptance probability for unweighting. If greater than one, excess events become less likely, but the reweighting efficiency also drops. (cf. simulate, ?unweighted)
- $sample (default: "")
String variable to set the (base) name of the event output format, e.g. $sample = "foo" will result in an intrinsic binary format event file foo.evx. (cf. also sample_format, simulate, hepevt, ascii, athena, debug, long, short, hepmc, lhef, lha, stdhep, stdhep_up, $sample_normalization, ?sample_pacify, sample_max_tries)
- sample_max_tries (default: 10000)
Integer variable that sets the maximal number of tries for generating a single event. The event might be vetoed because of a very low unweighting efficiency, errors in the event transforms like decays, shower, matching, hadronization etc. (cf. also simulate, $sample, sample_format, ?sample_pacify, $sample_normalization, sample_split_n_evt,
sample_split_n_kbytes)
- $sample_normalization (default: "auto")
String variable that allows to set the normalization of generated events. There are four options: option "1" (events normalized to one), "1/n" (sum of all events in a sample normalized to one), "sigma" (events normalized to the cross section of the process), and "sigma/n" (sum of all events normalized to the cross section). The default is "auto" where unweighted events are normalized to one, and weighted ones to the cross section. (cf. also simulate, $sample, sample_format, ?sample_pacify, sample_max_tries, sample_split_n_evt, sample_split_n_kbytes)
- ?sample_pacify (default: false)
Flag, mainly for debugging purposes: suppresses numerical noise in the output of a simulation. (cf. also simulate, $sample, sample_format, $sample_normalization, sample_max_tries, sample_split_n_evt, sample_split_n_kbytes)
- ?sample_select (default: true)
Logical that determines whether a selection should be applied to the output event format or not. If set to false a selection is only considered for the evaluation of observables. (cf. select, selection, analysis)
- sample_split_index (default: 0)
Integer number that gives the starting index sample_split_index = <split_index> for the numbering of event samples <proc_name>.<split_index>.<evt_extension> split by the sample_split_n_evt = <num>. The index runs from <split_index> to
<split_index> + <num>. (cf. also simulate, $sample, sample_format,
$sample_normalization, sample_max_tries, ?sample_pacify)
- sample_split_n_evt (default: 0)
When generating events, this integer parameter sample_split_n_evt = <num> gives the number <num> of breakpoints in the event files, i.e. it splits the event files into <num> + 1 parts. The parts are denoted by <proc_name>.<split_index>.<evt_extension>. Here, <split_index> is an integer running from 0 to <num>. The start can be reset by (→) sample_split_index. (cf. also simulate, $sample, sample_format, sample_max_tries, $sample_normalization, ?sample_pacify, sample_split_n_kbytes)
- sample_split_n_kbytes (default: 0)
When generating events, this integer parameter sample_split_n_kbytes = <num> limits the file size of event files. Whenever an event file has exceeded this size, counted in kilobytes, the following events will be written to a new file. The naming conventions are the same as for sample_split_n_evt. (cf. also simulate, $sample, sample_format, sample_max_tries, $sample_normalization, ?sample_pacify)
- seed (default: 0)
Integer variable seed = <num> that allows to set a specific random seed num. If not set, WHIZARD takes the time from the system clock to determine the random seed.
- $select_alpha_regions (default: "")
Fixes the αr in the real subtraction as well as the DGLAP component. Allows for testing in a list of selected singular regions.
- ?sf_allow_s_mapping (default: true)
Flag that determines whether special mappings for processes with structure functions and s-channel resonances are applied, e.g. Drell-Yan at hadron colliders, or Z production at linear colliders with beamstrahlung and ISR.
- ?sf_trace (default: false)
Debug flag that writes out detailed information about the structure function setup into the file <proc_name>_sftrace.dat. This file name can be changed with (→) $sf_trace_file.
- $sf_trace_file (default: "")
$sf_trace_file = "<file_name>" allows to change the detailed structure function information switched on by the debug flag (→) ?sf_trace into a different file <file_name> than the default <proc_name>_sftrace.dat.
- $shower_method (default: "WHIZARD")
String variable that allows to specify which parton shower is being used, the default, "WHIZARD", is one of the in-house showers of WHIZARD. Other possibilities at the moment are only "PYTHIA6".
- ?shower_verbose (default: false)
Flag to switch on verbose messages when using shower and/or hadronization. (cf. also ?allow_shower, ?ps_ ..., $ps_ ..., ?mlm_ ...,
- ?slha_read_decays (default: false)
Flag which decides whether WHIZARD reads in the widths and branching ratios from the DCINFO common block of the SUSY Les Houches Accord files. (cf. also read_slha, write_slha, ?slha_read_spectrum, ?slha_read_input)
- ?slha_read_input (default: true)
Flag which decides whether WHIZARD reads in the SM and parameter information from the SMINPUTS and MINPAR common blocks of the SUSY Les Houches Accord files. (cf. also read_slha, write_slha, ?slha_read_spectrum, ?slha_read_decays)
- ?slha_read_spectrum (default: true)
Flag which decides whether WHIZARD reads in the whole spectrum and mixing angle information from the common blocks of the SUSY Les Houches Accord files. (cf. also read_slha, write_slha, ?slha_read_decays, ?slha_read_input)
- sqrts
Real variable in order to set the center-of-mass energy for the collisions (collider energy √s, not hard interaction energy √ŝ): sqrts = <num> [ <phys_unit> ]. The physical unit can be one of the following eV, keV, MeV, GeV, and TeV. If absent, WHIZARD takes GeV as its standard unit. Note that this variable is absolutely mandatory for integration and simulation of scattering processes.
- ?stratified (default: true)
Flag that switches between stratified and importance sampling for the VAMP integration method.
- $symbol
Settings for WHIZARD’s internal graphics output: $symbol = "<LaTeX_code>" is a string variable for the symbols that should be used for plotting data points. (cf. also $obs_label, ?normalize_bins, $obs_unit, $title, $description, $x_label, $y_label,
graph_width_mm, graph_height_mm, ?y_log, ?x_log, x_min, x_max, y_min, y_max,
$gmlcode_fg, $gmlcode_bg, ?draw_base, ?draw_piecewise, ?fill_curve,
?draw_histogram, ?draw_curve, ?draw_errors, $fill_options, $draw_options,
$err_options, ?draw_symbols)
- ?test_anti_coll_limit (default: false)
Sets the fixed values ξ = 0.5 and y = −0.9999999 as radiation variables. This way, only anti-collinear, but non-soft phase space points are generated, which allows for testing subtraction in this region. Can be combined with ?test_soft_limit to probe soft-collinear regions.
- ?test_coll_limit (default: false)
Sets the fixed values ξ = 0.5 and y = 0.9999999 as radiation variables. This way, only collinear, but non-soft phase space points are generated, which allows for testing subtraction in this region. Can be combined with ?test_soft_limit to probe soft-collinear regions.
- ?test_soft_limit (default: false)
Sets the fixed values ξ = 0.00001 and y = 0.5 as radiation variables. This way, only soft, but non-collinear phase space points are generated, which allows for testing subtraction in this region.
- threshold_calls (default: 10)
This integer variable gives a limit for the number of calls in a given channel which acts as a lower threshold for the channel weight. If the number of calls in that channel falls below this threshold, the weight is not lowered further but kept at this threshold. (cf. also channel_weights_power)
- $title (default: "")
This string variable sets the title of a plot in a WHIZARD analysis setup, e.g. a histogram or an observable. The syntax is $title = "<your title>". This title appears as a section header in the analysis file, but not in the screen output of the analysis. (cf. also n_bins, ?normalize_bins, $obs_unit, $description, $x_label, $y_label, ?y_log, ?x_log, graph_width_mm, graph_height_mm, x_min, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_base, ?draw_histogram, ?fill_curve, ?draw_piecewise,
?draw_curve, ?draw_errors, $symbol, ?draw_symbols, $fill_options, $draw_options, $err_options)
- tolerance (default: 0.00000E+00)
Real variable that defines the absolute tolerance with which the (logical) function expect accepts equality or inequality: tolerance = <num>. This can e.g. be used for cross-section tests and backwards compatibility checks. (cf. also expect)
- undefined_jet_algorithm (fixed value: 999)
This is just a place holder for any kind of jet jet algorithm that is not further specified. (cf. also kt_algorithm, cambridge_for_passive_algorithm,
genkt_[for_passive_]algorithm, ee_[gen]kt_algorithm, jet_r, plugin_algorithm)
- ?unweighted (default: true)
Flag that distinguishes between unweighted and weighted event generation. (cf. also simulate, n_events, luminosity, event_index_offset)
- ?update_event (default: false)
Flag that decides whether the events in an event file should be rebuilt from the hard process when reading event/rescanning files into WHIZARD. (cf. rescan, ?recover_beams, ?update_sqme, ?update_weight)
- ?update_sqme (default: false)
Flag that decides whether the squared matrix element in an event file should be updated/recalculated when reading event/rescanning files into WHIZARD. (cf. rescan,
?recover_beams, ?update_event, ?update_weight)
- ?update_weight (default: false)
Flag that decides whether the weights in an event file should be updated/recalculated when reading event/rescanning files into WHIZARD. (cf. rescan, ?recover_beams,
?update_event, ?update_sqme)
- ?use_alphas_from_file (default: false)
Flag that decides whether the current αs definition should be used when recalculating matrix elements for events read from file, or the value that is stored in the file for that event. (cf. rescan, ?update_sqme, ?use_scale_from_file)
- ?use_scale_from_file (default: false)
Flag that decides whether the current energy-scale expression should be used when recalculating matrix elements for events read from file, or the value that is stored in the file for that event. (cf. rescan, ?update_sqme, ?use_alphas_from_file)
- ?use_vamp_equivalences (default: true)
Flag that decides whether equivalence relations (symmetries) between different integration channels are used by the VAMP integrator.
- vamp_grid_checkpoint (default: 1)
Integer parameter for setting checkpoints to save the current state of the grids and the results so far of the integration. Allowed are all positive integer. Zero values corresponds to a checkpoint after each integration pass, a one value to a checkpoint after each iteration (default) and an N value correspond to a checkpoint after N iterations or after each pass, respectively.
- $vamp_grid_format (default: "ascii")
Character string that tells WHIZARD the file format for vamp2 to use for writing and reading the configuration for the multi-channel integration setup and the VAMP2 (only) grid data. The values can be ascii for a single human-readable grid file with ending .vg2 or binary for two files, a human-readable header file with ending .vg2 and binary file with ending .vgx2 storing the grid data.The main purpose of the binary format is to perform faster I/O, e.g. for HPC runs.WHIZARD can convert between the different file formats automatically.
- ?vamp_history_channels (default: false)
Flag that decides whether the history of the grid adaptation of the VAMP integrator for every single channel are written into the process logfiles. Only for debugging purposes. (cf. also ?vamp_history_global_verbose, ?vamp_history_global, ?vamp_verbose,
?vamp_history_channels_verbose)
- ?vamp_history_channels_verbose (default: false)
Flag that decides whether the history of the grid adaptation of the VAMP integrator for every single channel are written into the process logfiles in an extended version. Only for debugging purposes. (cf. also ?vamp_history_global, ?vamp_history_channels, ?vamp_verbose, ?vamp_history_global_verbose)
- ?vamp_history_global (default: true)
Flag that decides whether the global history of the grid adaptation of the VAMP integrator are written into the process logfiles. (cf. also ?vamp_history_global_verbose, ?vamp_history_channels, ?vamp_history_channels_verbose, ?vamp_verbose)
- ?vamp_history_global_verbose (default: false)
Flag that decides whether the global history of the grid adaptation of the VAMP integrator are written into the process logfiles in an extended version. Only for debugging purposes. (cf. also ?vamp_history_global, ?vamp_history_channels, ?vamp_verbose, ?vamp_history_channels_verbose)
- $vamp_parallel_method (default: "simple")
Character string that tells WHIZARD the parallel method to use for parallel integration within vamp2. (i) simple (default) is a local work sharing approach without the need of communication between all workers except for the communication during result collection. (ii) load is a global queue approach where the master worker acts as agovernor listening and providing work for each worker. The queue is filled and assigned with workers a-priori with respect to the assumed computational impact of each channel.Both approaches use the same mechanism for result collection using non-blocking communication allowing for a efficient usage of the computing resources.
- ?vamp_verbose (default: false)
Flag that sets the chattiness of the VAMP integrator. If set, not only errors, but also all warnings and messages will be written out (not the default). (cf. also
?vamp_history_global, ?vamp_history_global_verbose, ?vamp_history_channels,
?vamp_history_channels_verbose)
- ?virtual_collinear_resonance_aware (default: true)
This flag allows to switch between two different implementations of the collinear subtraction in the resonance-aware FKS setup.
- $virtual_selection (default: "Full")
String variable to select either the full or only parts of the virtual components of an NLO calculation. Possible modes are "Full", "OLP" and "Subtraction.". Mainly for debugging purposes.
- ?vis_channels (default: false)
Optional logical argument for the integrate command that demands WHIZARD to generate a PDF or postscript output showing the classification of the found phase space channels (if the phase space method wood has been used) according to their properties: integrate (foo) { iterations=3:10000 ?vis_channels = true }. The default is false. (cf. also integrate, ?vis_history)
- ?vis_diags (default: false)
Logical variable that allows to give out a Postscript or PDF file for the Feynman diagrams for a O’Mega process. (cf. ?vis_diags_color).
- ?vis_diags_color (default: false)
Same as ?vis_diags, but switches on color flow instead of Feynman diagram generation. (cf. ?vis_diags).
- ?vis_fks_regions (default: false)
Logical variable that, if set to true, generates LATEX code and executes it into a PDF to produce a table of all singular FKS regions and their flavor structures. The default is false.
- ?vis_history (default: false)
Optional logical argument for the integrate command that demands WHIZARD to generate a PDF or postscript output showing the adaptation history of the Monte-Carlo integration of the process under consideration. (cf. also integrate, ?vis_channels)
- ?write_raw (default: true)
Flag to write out events in WHIZARD’s internal binary format. (cf. simulate, ?read_raw, sample_format, $sample)
- $x_label (default: "")
String variable, $x_label = "<LaTeX code>", that sets the x axis label in a plot or histogram in a WHIZARD analysis. (cf. also analysis, n_bins, ?normalize_bins, $obs_unit, $y_label, ?y_log, ?x_log, graph_width_mm, graph_height_mm, x_min, x_max, y_min, y_max,
$gmlcode_bg, $gmlcode_fg, ?draw_base, ?draw_histogram, ?fill_curve,
?draw_piecewise, ?draw_curve, ?draw_errors, $symbol, ?draw_symbols, $fill_options, $draw_options, $err_options)
- ?x_log (default: false)
Settings for WHIZARD’s internal graphics output: flag that makes the x axis logarithmic. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_height_mm, graph_width_mm, ?y_log, x_min, x_max, y_min, y_max,
$gmlcode_bg, $gmlcode_fg, ?draw_histogram, ?draw_base, ?draw_piecewise,
?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols, $fill_options,
$draw_options, $err_options, $symbol)
- x_max
Settings for WHIZARD’s internal graphics output: real parameter that sets the upper limit of the x axis plotting or histogram interval. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_height_mm, ?y_log,
?x_log, graph_width_mm, x_min, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_base,
?draw_histogram, ?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors,
?draw_symbols, $fill_options, $draw_options, $err_options, $symbol)
- x_min
Settings for WHIZARD’s internal graphics output: real parameter that sets the lower limit of the x axis plotting or histogram interval. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_height_mm, ?y_log,
?x_log, graph_width_mm, x_max, y_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_base,
?draw_histogram, ?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors,
?draw_symbols, $fill_options, $draw_options, $err_options, $symbol)
- $y_label (default: "")
String variable, $y_label = "<LaTeX_code>", that sets the y axis label in a plot or histogram in a WHIZARD analysis. (cf. also analysis, n_bins, ?normalize_bins, $obs_unit, ?y_log, ?x_log, graph_width_mm, graph_height_mm, x_min, x_max, y_min, y_max,
$gmlcode_bg, $gmlcode_fg, ?draw_base, ?draw_histogram, ?fill_curve,
?draw_piecewise, ?draw_curve, ?draw_errors, $symbol, ?draw_symbols,
$fill_options, $draw_options, $err_options)
- ?y_log (default: false)
Settings for WHIZARD’s internal graphics output: flag that makes the y axis logarithmic. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_height_mm, graph_width_mm, ?y_log, x_min, x_max, y_min, y_max,
$gmlcode_bg, $gmlcode_fg, ?draw_histogram, ?draw_base, ?draw_piecewise,
?fill_curve, ?draw_curve, ?draw_errors, ?draw_symbols, $fill_options,
$draw_options, $err_options, $symbol)
- y_max
Settings for WHIZARD’s internal graphics output: real parameter that sets the upper limit of the y axis plotting or histogram interval. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_height_mm, ?y_log,
?x_log, graph_width_mm, x_max, x_min, y_max, $gmlcode_bg, $gmlcode_fg, ?draw_base,
?draw_histogram, ?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors,
?draw_symbols, $fill_options, $draw_options, $err_options, $symbol)
- y_min
Settings for WHIZARD’s internal graphics output: real parameter that sets the lower limit of the y axis plotting or histogram interval. (cf. also ?normalize_bins, $obs_label, $obs_unit, $title, $description, $x_label, $y_label, graph_height_mm, ?y_log,
?x_log, graph_width_mm, x_max, y_max, x_min, $gmlcode_bg, $gmlcode_fg, ?draw_base,
?draw_histogram, ?draw_piecewise, ?fill_curve, ?draw_curve, ?draw_errors,
?draw_symbols, $fill_options, $draw_options, $err_options, $symbol)
Acknowledgements
We would like to thank E. Boos, R. Chierici, K. Desch, M. Kobel,
F. Krauss, P.M. Manakos, N. Meyer, K. Mönig, H. Reuter, T. Robens,
S. Rosati, J. Schumacher, M. Schumacher, and C. Schwinn who
contributed to WHIZARD by their suggestions, bits of codes and
valuable remarks and/or used several versions of the program for
real-life applications and thus helped a lot in debugging and
improving the code. Special thanks go to A. Vaught and J. Weill for
their continuos efforts on improving the g95 and gfortran compilers,
respectively.
|