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

The command line tool is launched with the script ./bin/lcio from the LCIO base directory.

$LCIO/bin/lcio [command] [arguments]

The script is runnable from anyplace on the host system and will setup the Java CLASSPATH before executing the main method of the class hep.lcio.util.CommandLineTool.

With no arguments, the usage statement is printed.

usage: LcioCommandLineTool
Commands:
compare
concat
validate
siodump
print
stdhep
split
random
count
merge
 -h    Print lcio command-line tool usage.
 -v    Set the verbosity.

Similar to the cvs command, the LCIO command line tool takes the name of command as its first argument. The command should be one of the following.

• 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.