page plotting

Plotting ##

Rivet comes with three commands —rivet-mkhtml, compare-histos and make-plots— for comparing and plotting data files. These commands produce nice comparison plots of publication quality from the YODA format text files.

The high-level program rivet-mkhtml will automatically create a plot webpage from the given YODA files. It searches for reference data automatically and uses the other two commands internally. Example:

rivet-mkhtml withUE.yoda:'Title=With UE' withoutUE.yoda:'LineColor=blue'

Run rivet-mkhtml –help to find out about all features and options.

Plotting options will be taken from *.plot files installed in Rivet’s share directory. These contain plotting instructions according to the make-plots syntax as documented in make-plots.md. Such files can also be written for any plugin analysis and will be found if they are in the RIVET_ANALYSIS_PATH.

You can also run the other two commands separately:

compare-histos will accept a number of YODA files as input (ending in .yoda, identify which plots are available in them, and combine the MC and reference plots appropriately into a set of plot data files ending with .dat. More options are described by running compare-histos –help.

Incidentally, the reference files for each Rivet analysis are to be found in the installed Rivet shared data directory, installdir/share/Rivet. You can find the location of this by using the rivet-config command:

rivet-config --datadir

You can plot the created data files using the make-plots command:

make-plots --pdf *.dat

The –pdf flag makes the output plots in PDF format: by default the output is in postscript (.ps), and flags for conversion to EPS and PNG are also available.

Note that the plotting tools internally use LaTeX for drawing, and for very complex plots it might sometimes fail with an error message like “TeX memory exceeded” (or “DVI file can’t be opened”). In such a case it is recommended to increase the allowed TeX memory size as described e.g. in the pgfplots manual in Section 6.2.

Furthermore, imagemagick’s convert is used to convert .pdf files into .png files for the plot website. Some versions of imagemagick might cause error messages like not authorized @ error/constitute.c/ReadImage/412, which can be fixed by giving rights=“read|write” for both PS and PDF formats in /etc/ImageMagick-7/policy.xml.

Updated on 2022-08-21 at 16:46:27 +0100