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

Rivet                                               June 2012                                   RIVET-RESCALE(1)