Skip to content

hipo-split

Split large HIPO files into smaller files by event count.

Synopsis

hipo-split [options] <input.hipo>

Description

hipo-split divides a large HIPO file into multiple smaller files, each containing a specified number of events. Output files are named with a sequential suffix.

Options

Option Description Default
-o, --output-dir <dir> Output directory .
-p, --prefix <prefix> Output filename prefix input filename
-n, --events <n> Events per output file 10000
-q, --quiet Suppress progress output -
--no-color Disable colored output -

Examples

Basic Split

# Split into 10000-event files (default)
hipo-split large.hipo

# Split into 5000-event files
hipo-split -n 5000 large.hipo

Output Location

# Split to specific directory
hipo-split -n 10000 -o output_dir/ large.hipo

# Custom prefix
hipo-split -n 5000 -p run_001 data.hipo
# Creates: run_001_0000.hipo, run_001_0001.hipo, ...

Large Event Count

# Split into 50000-event files
hipo-split --events 50000 -o /data/splits/ combined.hipo

Output Naming

Files are named {prefix}_{NNNN}.hipo where:

  • {prefix} is the input filename (without extension) or custom prefix
  • {NNNN} is a zero-padded sequential number

Example: data.hipo split with -n 1000 creates: 

data_0000.hipo
data_0001.hipo
data_0002.hipo
...

See Also