Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

...

Commands

Compare Command

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

...

The comparison is quite detailed, so LCIO files will not be considered identical unless they are basically exact copies of each other.

...

Concat Command

The concat command takes 2 or more input LCIO files and concatenates them together into a single output file.

...

No Format
lcio concat -i flist.txt -o outputfile

...

Validate Command

The validate command takes 1 or more LCIO files as input and performs two simple checks on them. Firstly, a simple read test is done. If the read test fails, the LCIO file is considered invalid. Secondly, a comparison is performed between the major and minor LCIO version numbers in the file and from command line arguments. Any version mismatches are printed to the terminal.

...

No Format
lcio validate file1.slcio -M 1 -m 5 -n 1

...

Siodump Command

The siodump command prints out detailed information about the SIO blocks in LCIO files using the SIODump utility (written by Tony Johnson).

...

This command accepts only a single input LCIO file, so extra arguments are ignored, not treated as additional input files.

...

Print Command

The print command prints detailed information about LCEvents, including tables of records for each LCCollection of LCObjects. This command is a rewrite of the C++ dumpevent utility (written by Frank Gaede).

...

This command accepts a single file. If there is no "-f" argument, the first extra argument is inpretted as the input LCIO file.

...

StdHep Command

The stdhep command reads in a StdHep file and converts the HEPEVT blocks into LCCollections of MCParticles according to an algorithm by Ron Cassell (Java implementation by Tony Johnson).

...

This command ignores extra arguments.

...

Split Command

The split command takes a single LCIO file and splits it into smaller chunks.

...

This command ignores extra arguments.

...

Random Command

The random command generates LCIO events filled with random data (which is basically nonsensical!). These LCIO files can be used for testing purposes.

...

If the "-o" argument is omitted, the default output file name of "random_events" is used.

...

Count Command

The count command counts the number of event and/or run headers found in the input LCIO files.

...

Extra command line arguments are interpretted as additional LCIO input files.

...

Merge Command

The merge command overlays events from different LCIO files into one output file. It is a rather complicated command with a lot of possible options.

...

In general, any arguments in the file list will override those from the command line.

...

Select Command

No Format
usage: select
 -f    Set the input LCIO file.
 -h    Print select usage.
 -i    Add a pattern to include.
 -o    Set the output LCIO file.
 -t    Add an LCIO type to include.

...