SYNOPSIS

DESCRIPTION

Rescale histos in observable-file of AIDAFILE to the area of the
corresponding histos in REFDATAPATH. REFDATAPATH can either be
a single AIDA-file or a directory containing AIDA-files. By default
the standard Rivet reference files are used.

Observable definitions of the form
/CDF_2000_S4155203/d01-x01-y01 1.0
can be used to specify an absolute normalisation (1.0, here) for a
histogram rather than using the reference histo. If the --multiply
switch is used, the ref histo area will be scaled by the given factor
to give the target normalisation.

You can also define bins to chop out in the observable-file in the
same way as in chop_bins:
/CDF_2000_S4155203/d01-x01-y01:0:35 1.0
This will chop the bins with Z-pT > 35 GeV and obtain a rescaling factor
from that restricted bin range: note that the output histograms will
be rescaled but *unchopped*.

Only one bin definition can be used for each histogram, so the last bindef
specified for that histo path will be the one which is applied. The bindefs
are constructed in order from those in the obsfile, and then those given on
the command line with the -b flag, like this:

-b "/CDF_2000_S4155203/d01-x01-y01:5:135 2.0"

OPTIONS

-h, --help

show this help message and exit

-O OBSFILE, --obsfile=OBSFILE

Specify a file with histograms (and bin ranges) that
are to be normalised.

-b BINRANGES, --bins=BINRANGES

Specify a histogram and bin range that is to be used.
The format is `AIDAPATH:start:stop'.

-r REFDIR, --refdir=REFDIR

File of folder with reference histos

-a

Produce AIDA output rather than FLAT

-f

Produce FLAT output rather than AIDA

--multiply

Rescale histos using weight given as factor rather
than new area

-i, --in-place

Overwrite input file rather than making inputrescaled.aida

--fast

Try loading only reference files from refpath that
match analyses in input-file

EXAMPLES

rivet-rescale out.aida

This will return the histos in out.aida, scaled to match the overall
normalisations of the Rivet ref data.

rivet-rescale -O observables.obs out.aida

This will return the histos in out.aida, scaled by the bin definitions
specified in observables.obs (and using the Rivet ref data again)