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.
AUTHOR¶
This manual page was written by Lifeng Sun <lifongsun@gmail.com> for the
Debian system (but may be used by others).