rivet-rescale - Online in the Cloud

PROGRAM:

NAME

rivet-rescale - Rescale histos in observable-file of AIDAFILE to the area of the
corresponding histos in REFDATAPATH

SYNOPSIS

rivet-rescale [-r <REFDATAPATH>] [-O <observable-file>] [-b <bindef> [-b ...]] <AIDAFILE>
[<OUTFILE>]

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)

rivet-rescale -r path/to/CDF_2000_S4155203.aida -b "/CDF_2000_S4155203/d01-x01-y01:2:5"
out.aida
For this Z-boson pT-distribution, the normalisation to the provided ref data file
is only applied between 2 < x < 5 GeV.

Use rivet-rescale online using onworks.net services