~ubuntu-branches/ubuntu/quantal/rivet/quantal

.TH AIDA2FLAT "1" "June 2012" "Rivet" "User Commands"

.SH NAME

aida2flat \- Convert AIDA data files to a flat format

.SH SYNOPSIS

.B aida2flat

[\fIoptions\fR] \fIaidafile \fR[\fIaidafile2 \fR...]

.SH DESCRIPTION

Convert AIDA data files to a flat format which is more human\-readable then the

XML (and by default also plottable directly using make\-plots). The output is by

default written out to standard output unless the \fB\-\-split\fR, \fB\-\-smart\-output\fR,

\fB\-\-gnuplot\fR, or \fB\-\-output\fR options are specified. When specifying either input or

output filenames, a '\-' is used to refer to stdin or stdout as appropriate.

.PP

Histograms can also be filtered by AIDA path, using the \fB\-m\fR or \fB\-M\fR options for a

positive or negative regex pattern patch respectively.

.SH OPTIONS

.TP

\fB\-h\fR, \fB\-\-help\fR

show this help message and exit

.TP

\fB\-o\fR OUTPUT, \fB\-\-output\fR=\fIOUTPUT\fR

Write all histos to a single output file, rather than

the default writing to stdout. stdout can be

explicitly specified by setting '\-' as the output

filename. This option will be disregarded if \fB\-\-split\fR,

\fB\-\-smart\-output\fR, or \fB\-\-gnuplot\fR is specified.

.TP

\fB\-s\fR, \fB\-\-split\fR

Write each histo to a separate output file, with names

based on the histo path

.TP

\fB\-S\fR, \fB\-\-smart\-output\fR

Write to output files with names based on the

corresponding input filename. This option will be

disregarded if \fB\-\-split\fR is specified.

.TP

\fB\-g\fR, \fB\-\-gnuplot\fR

Provide output suitable for Gnuplot's 'plot "foo.dat"

with xye'. This option implies \fB\-\-split\fR and will

override \fB\-\-output\fR or \fB\-\-smart\-output\fR

.TP

\fB\-\-plotinfodir\fR=\fIPLOTINFODIR\fR

directory which may contain plot header information

.TP

\fB\-m\fR PATHPATTERNS, \fB\-\-match\fR=\fIPATHPATTERNS\fR

Only write out histograms whose $path/$name string

matches these regexes

.TP

\fB\-M\fR PATHUNPATTERNS, \fB\-\-unmatch\fR=\fIPATHUNPATTERNS\fR

Exclude histograms whose $path/$name string matches

these regexes

.SH AUTHOR

This manual page was written by Lifeng Sun <lifongsun@gmail.com> for the Debian system (but may be used by others).