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