ALP-ePIC

Simulation and analysis of electrophilic Axion-Like Particle (ALP) production processes at the Electron-Ion Collider (ePIC).

Requirements

0. Please review this page for event generation.
1. eic-shell: Latest installation of the EIC container environment. (Link)
2. MadGraph5_aMC@NLO (v3.5.13): Working installation with the following internal dependencies. (Link)
   • From the MG5 console, ensure the following are installed:

     install lhapdf6
     install pythia8

3. UFO Models: Place the ALP model directories into ./models/ before running the steering cards.
4. Custom PDFs: Copy the provided photon PDF set to your LHAPDF path: ./HEPTools/lhapdf6_py3/share/LHAPDF/

Quick Start

1. Clone this repository:

git clone https://github.com/eic/ALP-ePIC-analysis.git

2. Compile the library:

cd ALP-ePIC-analysis/analysis
make

3. Run the starter macro in ALP-ePIC-analysis/analysis/macros/analysis.C

root -b -q -l macros/analysis.C("$INPUTFILE","$OUTPUTFILE")