5. Output Formats & Analysis#

Achilles writes generated events to disk in one of three formats, configured via the Format key in the Output sub-node of the run card (see Run Card Structure for details). This page describes each format and how to use the output with external analysis tools.

5.2. Using Output with NUISANCE#

NUISANCE is a cross-section comparison framework for neutrino event generators. It can read Achilles NuHepMC output directly and compare generated distributions against published experimental data.

NUISANCE3 is the next-generation rewrite of NUISANCE with native NuHepMC support and a modernised analysis framework. Both versions accept HepMC3/NuHepMC files as input.

A typical workflow:

  1. Generate events with Achilles in NuHepMC format.

  2. Pass the output file to NUISANCE to produce comparison plots against data.

  3. Iterate on the run card or nuclear model settings as needed.

5.3. HepMC Format (Legacy)#

Deprecated since version 0.2: The plain HepMC format is retained for backward compatibility. New users should use NuHepMC instead.

Plain HepMC3 output without NuHepMC metadata. The event record structure is identical but the neutrino-specific convention attributes are omitted. Select this format by setting Format: HepMC in the run card.

5.4. Achilles Native Format#

The native Achilles binary format is a compact representation intended for internal debugging and post-processing within the Achilles framework. It is not designed for external analysis and its layout may change between versions. Select this format by setting Format: Achilles in the run card.