Skip to content

hipo-stats

Compute statistical analysis on bank data columns including min, max, mean, standard deviation, and histograms.

Synopsis

hipo-stats [options] <file.hipo>

Description

hipo-stats performs statistical analysis on HIPO bank data, computing summary statistics and optional visualizations like ASCII histograms and correlation matrices.

Options

Option Description Default
-b, --banks <names> Banks to analyze (comma-separated) all
-c, --columns <names> Columns to analyze (comma-separated) all
-n, --sample <n> Sample N events (0 = all) 0
-H, --histogram Show ASCII histograms -
--bins <n> Number of histogram bins 20
-C, --correlations Show correlation matrix -
--json Output as JSON -
-q, --quiet Suppress progress output -
--no-color Disable colored output -

Examples

Basic Statistics

# Show statistics for all banks
hipo-stats data.hipo

# Statistics for specific bank
hipo-stats -b REC::Particle data.hipo

Histograms

# Statistics with ASCII histograms
hipo-stats -b REC::Particle -H data.hipo

# More histogram bins
hipo-stats -b REC::Particle -H --bins 30 data.hipo

Specific Columns

# Analyze specific columns
hipo-stats -b REC::Particle -c px,py,pz data.hipo

# With correlation matrix
hipo-stats -b REC::Particle -c px,py,pz -C data.hipo

Sampling

# Sample 10000 events for faster analysis
hipo-stats -n 10000 data.hipo

# Sample with histograms
hipo-stats -n 10000 --histogram --bins 30 data.hipo

Machine-Readable Output

# JSON output for scripting
hipo-stats --json data.hipo

See Also