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