NAME¶

compare-histos - generate comparison histograms

SYNOPSIS¶

compare-histos [options] aidafile1[:'PlotOption1=Value':'PlotOption2=Value'] [aidafile2 ...]

OPTIONS¶

-h, --help

show this help message and exit

-R, --rivet-refs

use Rivet reference data files (default)

--no-rivet-refs

don't use Rivet reference data files

-o OUTDIR, --outdir=OUTDIR

write data files into this directory

--hier-out

write output dat files into a directory hierarchy which matches the analysis paths

--plotinfodir=PLOTINFODIR

directory which may contain plot header information (in addition to standard Rivet search paths)

--no-rmgapbins

disable attempting to remove 'gap' bins from MC histos when they don't appear in the ref file

--refid=REF_ID

ID of reference data set (file path for non-REF data)

--linear

plot with linear scale

--logarithmic

plot with logarithmic scale (default behaviour)

--mc-errs

show vertical error bars on the MC lines

--no-ratio

disable the ratio plot

--rel-ratio

show the ratio plots scaled to the ref error

--abs-ratio

show the ratio plots with an absolute scale

--no-plottitle

don't show the plot title on the plot (useful when the plot description should only be given in a caption)

--style=STYLE

change plotting style: default|bw|talk

-c CONFIGFILES, --config=CONFIGFILES

additional plot config file(s). Settings will be included in the output configuration.

--show-single=SHOW_SINGLE

control if a plot file is made if there is only one dataset to be plotted [default=mc]. If the value is 'no', single plots are always skipped, for 'ref' and 'mc', the plot will be written only if the single plot is a reference plot or an MC plot respectively, and 'all' will always create single plot files. The 'ref' and 'all' values should be used with great care, as they will also write out plot files for all reference histograms without MC traces: combined with the -R /--rivet-refs flag, this is a great way to write out several thousand irrelevant reference data histograms!

--show-mc-only, --all

make a plot file even if there is only one dataset to be plotted and it is an MC one. Deprecated and will be removed: use --show-single instead, which overrides this.

-m PATHPATTERNS, --match=PATHPATTERNS

Only write out histograms whose $path/$name string matches these regexes. The argument may also be a text file.

-M PATHUNPATTERNS, --unmatch=PATHUNPATTERNS

Exclude histograms whose $path/$name string matches these regexes

-q, --quiet

Suppress normal messages

-v, --verbose

Add extra debug messages

The plot options are described in the make-plots manual in the HISTOGRAM section.

AUTHOR¶

This manual page was written by Lifeng Sun <lifongsun@gmail.com> for the Debian system (but may be used by others).