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
  • Sample data files on bnl serverL file:///gpfs02/eic/DATA/PYTHIA/ep/YellowReport/

• 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
  • Howto
  • 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.

(You may not even need to run these generators; the ROOT files from the Yellow Report might already have what you need)

EIC-smear

• EIC-smear github repository
• Running EIC-smear and event generators from a singularity container

Fun4All

• The current implementation of the CORE detector in the Fun4All framework can be found here.
• On the SDCC (BNL) machines, you can use the files located in '/sphenix/user/baschmoo/analysis/CORE' as a template for running batch jobs and analyzing the simulation output.
• To run on the JLab ifarm, use a singularity container.
  • Installing the CORE simulation in a singularity container on the JLab ifarm
  • Running Fun4All from a singularity container
  • Fun4All Tutorials and Documentation

Note: more info is available by clicking on each headline.