LCIO Command Line Tool

Overview

The LCIO command line tool provides a number of useful utilities from the command line.

...

• compare - Perform a diff on two LCIO files, reporting the differences.
• concat - Concatenate two or more LCIO files together.
• validate - Perform some very simple validation of an LCIO file.
• siodump - Print low-level LCIO information using the SIO interface.
• print - Format and print all the collections and metadata of an LCEvent.
• stdhep - Convert StdHep events into LCIO MCParticle collection.
• split - Split an LCIO file into smaller chunks.
• random - Generate a random LCIO event. (e.g. for testing purposes)
• count - Count event and run headers of 1 or more LCIO files and report statistics.
• merge - Merge 2 or more LCIO files together.

compare

The compare command takes 2 or more input LCIO files and compares them to find differences.

usage: compare
 -f    Add a file to compare (Must have at least 2).
 -n    Set number of events to compare.
 -s    Set number of events to skip.
 -v    Set verbosity level (must be between 1 and 4).

For instance, this command will compare the second events of files file1 and file2, with high verbosity.

lcio compare -f file1.slcio -f file2.slcio -n 1 -s 1 -v 4