xenial (1) compare-histos.1.gz

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).