rivet-rescale(1) [debian man page]

RIVET-RESCALE(1)						   User Commands						  RIVET-RESCALE(1)

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)

Check Out this Related Man Page

RIVET(1)							   User Commands							  RIVET(1)

NAME

       rivet - Robust Independent Validation of Experiment and Theory

SYNOPSIS

       rivet [options] myfifo

OPTIONS

       --version
	      show program's version number and exit.

       -h, --help
	      show this help message and exit.

       -l NATIVE_LOG_STRS
	      set a log level in the Rivet library.

       -a ANA, --analysis=ANA
	      add an analysis to the processing list.

       --list-analyses
	      show the list of available analyses' names. With -v, it shows the descriptions, too.

       --list-used-analyses
	      list the analyses used by this command (after subtraction of inappropriate ones).

       --show-analysis=SHOW_ANALYSES, --show-analyses=SHOW_ANALYSES
	      show the details of an analysis.

       --analysis-path=PATH
	      specify the analysis search path (cf.  $RIVET_ANALYSIS_PATH).

       --analysis-path-append=PATH
	      append to the analysis search path (cf.  $RIVET_ANALYSIS_PATH).

       --pwd  append the current directory (pwd) to the analysis search path (cf. $RIVET_ANALYSIS_PATH).

       -H HISTOFILE, --histo-file=HISTOFILE
	      specify the output histo file path (default = Rivet.aida).

       -x XS, --cross-section=XS
	      specify the signal process cross-section in pb.

       -n NUM, --nevts=NUM
	      restrict the max number of events to read.

       --runname=NAME
	      give an optional run name, to be prepended as a 'top level directory' in histo paths.

       --ignore-beams
	      Ignore input event beams when checking analysis compatibility.

       --event-timeout=NSECS
	      max time in whole seconds to wait for an event to be generated from the specified source (default = 21600)

       --run-timeout=NSECS
	      max  time  in  whole  seconds  to  wait for the run to finish. This can be useful on batch systems such as the LCG Grid where tokens
	      expire on a fixed wall-clock and can render long Rivet runs unable to write out the final histogram file (default = unlimited).

       --histo-interval=HISTO_WRITE_INTERVAL
	      [experimental!] specify the number of events between histogram file updates. Default is to only write out at the	end  of  the  run.
	      Note  that intermediate histograms will be those from the analyze step only: analysis finalizing is currently not executed until the
	      end of the run.

       -v, --verbose
	      print debug (very verbose) messages.

       -q, --quiet
	      be very quiet.

EXAMPLES

	      mkfifo hepmc.fifo

	      my-generator -o myfifo &

	      rivet --analysis=ANALYSIS_NAME hepmc.fifo

ENVIRONMENT
:
       RIVET_ANALYSIS_PATH
	      list of paths to be searched for plugin analysis libraries at runtime.

       RIVET_REF_PATH
	      list of paths to be searched for reference data files.

       RIVET_INFO_PATH
	      list of paths to be searched for analysis metadata files.

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(1)

Linux and UNIX Man Pages

rivet-rescale(1) [debian man page]

Check Out this Related Man Page