Simulations

Event generators

The following sections list the events generators used during the YR, with their steering cards and MC samples (when available).

Inclusive reactions

[Information on this section taken from here]

For inclusive reactions, two main event generators were used during the Yellow Report exercise:

• Pythia 6 (Documentation, Code), for inclusive neutral current electron-proton scattering
  • Input Cards and Plotting Macro: 5+41 card, 5+100 card, 10+100 card, 18+275 card, Macro
  • EIC-smear ROOT Files: '/gpfs02/eic/baraks/pythia/outfiles/yellow_report/' on BNL RACF machines (generator level: ep_*_newtune_*.root, after eic-smear v0.1: ep_*_newtune_*_matrixsmear.root)
  • Q² > 0.5 GeV²
    
  • Contact : Barak Schmookler

• BeAGLE (Documentation, Code), for inclusive neutral current electron-nucleus scattering
  • Species and energies used: e+Au 5x41, 10x110, 18x110 GeV
  • Generator used: BeAGLE
  • Input Cards: 18x110 (Others energies similar)
  • ROOT Files: '/gpfs02/eic/baraks/BeAGLE/outForPythiaMode/rootfiles/' on BNL RACF machines
  • Q² > 0.5 GeV²
    
  • Contact : Barak Schmookler and Dmitriy Kim

• Djangoh (Documentation, Code), for inclusive neutral-current ep scattering and charge current electron scattering
  • Input cards for neutral-current ep scattering 5x41, 5x100, 10x100, 18x275
  • ROOT files: '/eic/data/baraks/dis-reconstruction/djangoh/outfiles/yellow/' on BNL RACF machines (generator level files, not smeared)
  • Contact : Barak Schmookler

Semi-inclusive reactions

• Pythia 6 (Documentation, Code)
  • Input cards and output files from YR (by R. Seidl) at: /gpfs/mnt/gpfs02/eic/DATA/YR_SIDIS/ (README file included)
  • Input card for gluon Sivers at 18 GeV x 275 GeV (by L. Zheng)
• Pythia 8 + DIRE (Code)
  • Input card (by A. Vossen)
• elSpectro (Code)
  • Generator for incorporating Spectroscopy into electro/photoproduction reactions, by D. Glazier
  • Sample steering cards at: https://github.com/dglazier/elSpectro

Jets & HQ

• Pythia 6 (Documentation, Code)
  • Sample steering card
  • MC files: /gpfs02/eic/DATA/PYTHIA/ep/YellowReport/
  • Contact: B. Page

• Pythia 6 (Documentation, Code)
  • Steering card
  • Used for Fig. 7.21 and 7.60 of YR
  • More details: arXiv:2102.08337
  • Contact: Matthew Kelsey

• Pythia 6 (Documentation, Code)
  • Steering cards
  • Contact: Cheuk-Ping Wong

• Pythia 8
  • Steering cards
  • Contact: Xuan Li

• Analysis code for groomed jet substructure and some PID studies: by J. Orborn, by D. Fitzgerald

Exclusive reactions

• TOPEG (Code and documentation): nuclear DVCS (including proton)
  • Contact: R. Dupré

• DVCS
  • Generator: Milou / Milou3D
  • MC samples: /gpfs02/eic/DATA/MILOU/newfiles/NEWMILOU/*.out
  • Contact: Salvatore Fazio

• DVMP
  • YR Contact: Sylvester Joosten
  • lAger (https://eicweb.phy.anl.gov/monte_carlo/lager)

• Diffractive dijets
  • Generator: Pythia8
  • Contact: Latiful Kabir
• Exclusive J/Psi and Phi Production
  • Generators: Sartre and eSTARlight, ???
  • Working Wiki Page

Diffractive & Tagging

Yellow Report Diffractive & Tagging Page

Yellow Report Exclusive Reaction Page

• eSTARlight (Code and documentation): coherent vector meson photo- and electro-production
  • Contact: S. Klein
  • Sample input cards
  • Analysis plugin:

• RAPGAP (Code, Documentation): inclusive diffraction
  • Contact: W. Slominski
  • Steering cards
  • MC samples: /gpfs/mnt/gpfs02/eic/YR/RAPGAP
  • Analysis plugin:

• EIC_mesonMC (Code, Documentation): Sullivan process (meson structure)
  • Contact: R. Trotta
  • More info: YR wiki, arXiv:2102.11788
  • MC samples:
    • 5 on 41
    • 10 on 100
    • 10 on 135
    • Fun4all instruction: passing through EIC Smear first. Interface script is under work.
  • Analysis plugin:

• u-channel π⁰ Production
  • Contact: Wenliang (Bill) Li (wenliang.billlee@gmail.com)
  • Generator: DEMPgen
  • MC samples:
    • 5 on 100: 1M test data
    • Fun4all instruction: passing through EIC Smear first. Interface script is under work.
  • Analysis plugin:

• Pion and Kaon Form Factors via DEMP
  • YR Contact: Garth Huber and Stephen Kay
  • Generator: DEMPgen
  • MC samples:
    • 5 on 41
    • 5 on 100
    • 10 on 100
    • 18 on 275
    • Fun4all instruction: passing through EIC Smear first. Interface script is under work.
  • Analysis plugin:

• SRC Related studies (C, D, He4, H3):
  • YR Contact: Florian Hauenstein, Tyler Kutz and Jackson Pybus
  • Generator: gcf-src
  • MC samples:
    • Electron-Cabon data 5 on 41
    • Electron-Cabon data 10 on 110
    • e-D data 5 on 41
    • e-D data 10 on 100
    • Fun4all instruction: data in beagle output format, feed into Fun4all directly? Interface script is under work.
  • Analysis plugin:

It is not recommended to try and install these generators. They are installed on BNL machines, and they can be accessed through the Singularity container. For more information on this: (You may not even need to run these generators; the ROOT files from the Yellow Report might already have what you need)

EIC-smear

Running EIC-smear and event generators from a singularity container

Delphes

• Delphes_EIC_CORE_2.5T_Grassi.tcl
• ATHENA (template for 3T Magnet): Athena.tcl

Fun4All

• Running Fun4All from a singularity container
• Fun4All Tutorials and Documentation
• K. Kauder's talk at the ECCE software worshop