Expand description
A library for interacting with files in the Les Houches Event File (LHEF) format.
Lhef supports both reading and writing via the Reader
and Writer
structs. Information about the generator run is provided in a HEPRUP
object and each event is stored in a HEPEUP
object. These structs
correspond to the Fortran common blocks of the same names in the
original proposal, but contain
extra info
fields corresponding to the “optional information”
specified in the LHEF standard.
As of now, only version 1.0 of
the LHEF format is fully supported. Files in version
2.0
and 3.0 are
parsed exactly like for version 1.0. This means that the additional XML
tags have to be extracted manually from the info
fields of the
HEPRUP
and HEPEUP
objects.
Examples
use lhef::Reader;
use std::fs::File;
use std::io::BufReader;
let input = BufReader::new(File::open("events.lhe")?);
let mut reader = Reader::new(input)?;
println!("Information in comment header:\n{}", reader.header());
println!("Information in xml header:\n{:?}", reader.xml_header());
println!("Generator run information:\n{:?}", reader.heprup());
let event = reader.hepeup()?;
if let Some(event) = event {
println!("Found an event: {:?}", event);
}
Re-exports
Modules
- LHEF reader
- Particle status codes
- LHEF writer
Structs
- Event information
- Generator run information