VINCIA Output Utilities
VINCIA inherits most of its output capabilities directly from
PYTHIA. For instance, PYTHIA's methods for event listing and for
output to LHEF, HepMC, or other formats, can be used exactly as for
ordinary PYTHIA runs. The relevant methods are described in the
PYTHIA documentation and in the PYTHIA 8 examples included with
standalone PYTHIA. Here, we only describe a few additional utilities
that are specific to VINCIA.
Verbose Level
mode
Vincia:verbose
(default = 1
; minimum = 0
; maximum = 9
)
Level of detail of
information written to standard output on what goes on inside
VINCIA
. Settings different from zero and one are intended
for debugging purposes and hence should not be used for normal runs.
option
0 : No runtime output.
Note: options 1-3 only generate output when something goes wrong, i.e., a check
fails, etc.
option
1 : Normal runtime output. Warnings and errors are
printed, but no additional diagnostic output is given.
option
2 : Enhanced runtime output. As for =1, but limited
additional diagnostic info is given. Also, internal VINCIA
diagnostics histograms are booked and filled, especially for
matching. These can be printed by the user at any time (e.g., after
a run) using the VinciaPlugin::printHistos()
method.
option
3 : As for =2, but as much diagnostic
output as possible is given for each error or warning.
Also, a consistency check is added
to each branching by reclustering the resulting momenta back using the
corresponding inverse kinematics map and checking that the original
momenta are recovered within the desired numerical
precision.
Note: options above 4 will always generate output for each event, so will
cause very large amounts of output.
option
4 : As for =3. And: each prepare()
and pTnext()
call is explicitly announced, with system
number and restart scale printed out, respectively. .
option
5 : As for =4. And: momentum listings are printed for
each configuration that violates P < 1.
option
6 : As for =5. And: each main function call is
explicitly announced with begin and end printed to output.
option
7 : As for =6. And: most function calls are explicitly
announced with begin and end printed to output
(still only partly implemented).
option
8 : As for =7. And: last semi-sensible level of output.
option
9 : As for =8. And: all possible output.
Text Output Utilities
string num2str(x, int width)
converts a
number, x
(int
or double
) to a
string of width width
for formatted output.
string bool2str(bool b)
converts a
bool to a string ("y"/"n") for formatted output.
void printOut(int verbLevel, string place, string
message);
if the current verbose
setting is
greater than or equal to verbLevel
, this command
prints the string message
to stdout
,
prefaced by place
in parenthesis.
void printErr(int verbLevel, string place, string
message);
same as above but prints to stderr
instead of stdout
.