Simulations

Event generators

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

Note: Most of the generators below, the ones listed here, can be used from any Scientific Linux 7 computer with cvmfs configured. This includes both BNL and JLab farms, but also any computer able to use singularity, see instructions here. The only thing you need to do is

setenv EIC_LEVEL dev
source /cvmfs/eic.opensciencegrid.org/x8664_sl7/MCEG/releases/etc/eic_cshrc.csh

or, if you use bash,

export EIC_LEVEL=dev
source /cvmfs/eic.opensciencegrid.org/x8664_sl7/MCEG/releases/etc/eic_bash.sh

Click here for more details.

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

• General information on codes, data files, steering files:
  • ECCE:Where_is_everything?
  • Simulation data files at JLab ifarm:
    • /work/osgpool/eic/
    • /work/osgpool/eic/DATA/YR_SIDIS/
    • /work/osgpool/eic/ATHENA/RECO/master/DIS/

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
  • Comment on SIDIS PID (4 Nov 2021) Media:Whiteboard_PID.png

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

• Notes on light cone vectors and improving resolution by imposing exclusivity constraint
  • File:DVCS t-Resolution Exclusivity.pdf
• 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)

Crossing Angle Implementation

[https://github.com/eic/documents/blob/master/reports/general/Note-Simulations-BeamEffects.pdf tech note on implementing crossing angle]

EIC-smear

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

Delphes

 Click here for details on the Fast MC implementation of CORE in Delphes 

Fun4All

• The current implementation of the CORE detector in the Fun4All framework can be found here:
  • https://github.com/bschmookler/fun4all_eicmacros/tree/CORE/detectors/CORE.
  • Everyone can download (see instructions below). If you want to upload files, please send an email to baraks@ucr.edu.
• The running instructions can be found here:
  • https://github.com/bschmookler/fun4all_eicmacros/tree/CORE#fun4all_eicmacros--core-detector.
• Analysis examples, as well as a template for running batch jobs on the SDCC (BNL) machines and analyzing the simulation output, are included in the repository.
• If running on the SDCC or JLab ifarm, set up the environment as described in the running instructions above. If you want to use the singularity container, see here:
  • Running Fun4All from a singularity container
• General Fun4All tutorials can be found here:
  • Fun4All Tutorials and Documentation
• IR: The CORE simulation can be run without any extended IR, but also supports both IR6 and IR8 (although the implementation of the latter is still ongoing). You can choose the configuration by editing the appropriate flags in the local copy of this file:
  • https://github.com/bschmookler/fun4all_eicmacros/blob/CORE/detectors/CORE/Fun4All_G4_CORE.C#L192

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