3 releases (breaking)

0.3.0 Nov 29, 2023
0.2.0 Sep 5, 2023
0.1.0 Sep 2, 2023

#1733 in Parser implementations

Download history 31/week @ 2024-01-12 1/week @ 2024-01-19 5/week @ 2024-02-16 10/week @ 2024-02-23 3/week @ 2024-03-01 3/week @ 2024-03-08 2/week @ 2024-03-15 44/week @ 2024-03-29 16/week @ 2024-04-05

60 downloads per month


181 lines


Generic event file reader.

This crate provides the [EventFileReader] struct for reading scattering event files in different formats. See the Features section for a list of supported formats and the avery crate for the format of the returned events.


use event_file_reader::EventFileReader as Reader;

let reader = Reader::new("events.lhe.gz")?;
for event in reader {
  let event = event?;
  // do something with the event


Default Features

  • lhef: Support for event files in the Les Houches Event File format.
  • hepmc2: Support for event files in the HepMC 2 format.
  • flate2: Support for DEFLATE compressed event files, e.g. gzip.
  • zstd: Support for event files compressed with zstd.

Non-default Features

  • all: Enable all mutually compatible features. Use --features all instead of --all-features.
  • bzip2: Support for bzip2 compressed event files.
  • ntuple: Support for ntuple event files.
  • lz4: Support for lz4 compressed event files using the lz4 crate. Incompatible with the lz4_flex feature.
  • lz4_flex: Support for lz4 compressed event files using the lz4_flex crate. Incompatible with the lz4 feature.

License: GPL-3.0-or-later


~122K SLoC