What is all the output?
After having run pinefarm run DATASET THEORY
(see pinefarm command line interface), the script
prints a table, which is useful to quickly validate the MC uncertainty and the
interpolation error of PineAPPL. The last line shows the directory where all
results are stored, which has the form DATASET-DATE
, where DATASET
is
the value given to the run script and DATE
is a numerical date when the
generation was started. The date is added so runs for the same dataset do not
overwrite each other’s output.
The most important file in the output directory is
DATASET-DATE/DATASET.pineappl.lz4
which is the final PineAPPL grid.
The remaining contents of this directory are useful for testing and debugging:
results.log
: The numerical results of the run, comparing the results of the grid against the results frommg5_aMC
. The first column (PineAPPL) are the interpolated results, which should be similar to the Monte Carlo (MC) results in the second column. The third column gives the relative MC uncertainty (sigma). The next column gives the differences in terms of multiples of sigma. The final three columns give the per mille differences of the central, minimum, and maximum scale varied results. Ideally the first two columns are the same and the remaining columns are zero.time.log
: Totaltime
needed for the run
Note
The resulting PineAPPL grid will contain the metadata written in the
metadata.txt
file.
In addition, the script run.sh
and PineAPPL will automatically add the
following metadata:
initial_state_{1,2}
: The hadronic initial states of the grid, given as PDG ids, typically2212
for protons,-2212
for anti-protons, and so on.lumi_id_types
: The meaning of the luminosities IDs in the definition of the luminosity function of a PineAPPL grid. This is set topdg_mc_ids
to signal they are PDG ids (with a possible exception of the gluon, for which0
may be used).mg5amc_repo
andmg5amc_revno
(only Mg5aMC@NLO grids): The repository and revision number of the Madgraph5_aMC@NLO version that was used to generate the grid.pineappl_gitversion
: The PineAPPL version that was used to generate the grid.results
: The comparison of the HwU results against a convolution of the PineAPPL grid with the PDF selected inlaunch.txt
. This is the same table printed at the end byrun.sh
, and is used to verify the contents of each grid. It also stores the MC uncertainties.pinecard
: Madgraph5_aMC@NLO’s pinecard that was used to generate the grid. Here all parameters are documented.pinecard_gitversion
: The git version of this repository that was used to generate the grid.yadism_version
(only Yadism grids): The yadism version used to generate the grid (if not a released version have been used it includes also git details).
Runner dependent output
Part of the output is specific to the selected runner, and described in the corresponding section.