1. Introduction#

Achilles (A CHIcago Land Lepton Event Simulator) is a Monte Carlo event generator for the simulation of lepton-nucleus and neutrino-nucleus interactions. This manual provides information to help users understand and apply Achilles for their physics studies.

The general organization of the manual is as follows. First, the generator and the overarching goals are introduced. Secondly, a detailed description of installing and running the program are outlined. Finally, methods of developing plugins to extend the functionality are covered, along with detailed documentation of the needed interfaces. The various options and parameters specifying how the program is to be compiled and run, and their meanings are explained.

Note: This document is meant as a tool for using and running the code, therefore, a complete detailed description of the physics content of Achilles is not available here. For those interested in the physics details, the authors refer the reader to the following publications, [IJL+25], [IJL+23], [IHocheLGR22], and [IJL+21].

1.1. Introduction to Achilles#

Achilles is a Monte Carlo event generator that provides fully exclusive final states in simulations for lepton-nucleus and neutrino-nucleus interactions. The produced events may be passed into detector simulations used by the various experiments, or analyzed for comparisons to data. The Achilles code consists of a main C++ code, with extensions to include nuclear models implemented in modern Fortran90 (see Fortran Interface for more details).

The main goals of the Achilles event generator are:

  1. Theory driven: ensure that the guiding principles are to reproduce our understanding of the Standard Model with appropriate uncertainties.

  2. Leverage experiences from the LHC event generator community

  3. Develop a modular and extensible neutrino event generator

  4. Provide automated Beyond the Standard Model calculations for neutrino experiments

  5. Fully evaluate theory uncertainties

In addition to lepton-nucleus and neutrino-nucleus run modes, Achilles provides a setup to benchmark the intranuclear cascade. This enables running nucleon-nucleus and pion-nucleus reaction cross-sections as well. The list of allowed nuclear physics interactions currently includes coherent scattering, quasielastic scattering, and resonance production. Ongoing efforts are aimed at developing models for coherent single pion production, meson exchange currents (MEC), shallow inelastic scattering (SIS), and deep inelastic scattering (DIS). In terms of allowed leptonic initial and final states, it is possible to simulate any set of colorless particles, including those beyond the Standard Model (SM) through the use of an interface to Sherpa, the UFO output format [Darme+23, DDF+12] from FeynRules[ACD+14, CdAD+11, CD09].

This manual aims to provide all the needed information to get started with Achilles as quickly as possible. It lists all available options for controlling the physics aspects of the simulation. It does not describe the details of the physics simulated, and only minor details of the underlying structure as it pertains to enabling user extensions.

The MCnet Guidelines apply to Achilles. Therefore, you are kindly reminded that the guidelines recommend the citation of all works used for their continued development. We kindly ask that you cite [IJL+25, IJL+23] for all works using Achilles. Additionally, the Achilles generator outputs a bibtex file containing additional works that should be cited based upon the run configuration used to generator your events, and also included in the NuHepMC[GIP23] output format.

The Achilles authors strongly recommend a detailed review of the manuals and many excellent publications on different aspects of event generation within the neutrino community and beyond. An excellent resource for those interested in seeing the current state and future goals of event generators in the community is the white paper written for Snowmass [C+24].

The remainder of this manual is organized as follows: Getting Started contains information and instructions on obtaining, building, installing, and running the event generator. The Run Card Structure is discussed, and the ability to control the parameters and physics within the generator are elucidated. Finally, the Interfaces for extending the code or to external tools are explained.

Note: The construction of Monte Carlo event generators requires several assumptions, approximations, and simplifications. It is therefore imperative that the results of event generators should be verified and cross-checked with results from other programs, and they should be interpreted with care and common sense. For a list of other neutrino event generators, please see the following sub-section.

1.1.1. Other Generators#

Other neutrino event generators that exist with various states of support, extensibility, goals, and level of open-access include: