pylhe: A Lightweight Python Interface to Les Houches Event Files

Abstract

Les Houches Event files are a standard format for Monte Carlo event generators in high-energy physics. pylhe is a pure-Python library for reading and writing LHE event data, supporting .lhe and compressed .lhe.gz files, the widely used LHE 3.0 features including multiple event weights and generator metadata, and the recent HDF5-based LHEH5 format. By exposing events through a pythonic iterator and shared data structures, pylhe enables memory-efficient processing of large event samples without loading entire files into memory, and supports format conversion and integration with modern analysis workflows, including columnar analysis with Awkward Array and downstream machine-learning applications.