Skip to content

hipo-dump

Print bank data to stdout in various formats (plain text, CSV, JSON).

Synopsis

hipo-dump [options] <file.hipo>

Description

hipo-dump exports bank data from HIPO files to stdout in configurable formats. Useful for data extraction, piping to other tools, and scripting workflows.

Options

Option Description Default
-b, --banks <names> Banks to dump (comma-separated) all
-c, --columns <names> Columns to include (comma-separated) all
-e, --events <range> Event range (e.g., 0-100, 50) all
-f, --format <fmt> Output format: plain, csv, json plain
-d, --delimiter <char> Delimiter for plain format \t
--no-header Omit column headers -
-E, --event-index Include event index column -
-R, --row-index Include row index column -
-q, --quiet Suppress metadata output -
--no-color Disable colored output -

Examples

Basic Usage

# Dump all banks as plain text
hipo-dump data.hipo

# Dump specific bank
hipo-dump -b REC::Particle data.hipo

Export to CSV

# Export specific bank as CSV
hipo-dump -b REC::Particle -f csv data.hipo > particles.csv

# Export specific columns only
hipo-dump -b REC::Particle -c pid,px,py,pz -f csv data.hipo > momenta.csv

Export to JSON

# Export as JSON with event indices
hipo-dump -b REC::Particle -f json -E data.hipo

Event Selection

# Dump specific columns from events 0-99
hipo-dump -b REC::Particle -c pid,px,py,pz -e 0-99 data.hipo

# Dump starting from event 50
hipo-dump -b REC::Particle -e 50 data.hipo

Scripting

# Tab-delimited without headers for piping
hipo-dump -b REC::Track --no-header data.hipo | awk '{print $1}'

# Quiet mode (no metadata)
hipo-dump -b REC::Particle -f csv -q data.hipo > clean.csv

See Also