Simulations

2021-09-03T19:59:24Z

Kkauder:

= [https://eic.github.io/software/mcgen.html 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 [https://eic.github.io/software/mcgen.html 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 [https://github.com/eic/Singularity/blob/master/README.md#option-1-mount-eic-cvmfs 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 [https://eic.github.io/software/eicsmear_generators_singularity.html details].

== Inclusive reactions ==

[Information on this section taken from [https://wiki.bnl.gov/eicug/index.php/Yellow_Report_Physics_Inclusive_Reactions#Inclusive_neutral_current_electron-proton_scattering here]]

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

* Pythia 6 ([https://eic.github.io/software/pythia6.html Documentation], [https://gitlab.com/eic/mceg/PYTHIA-RAD-CORR Code]), for inclusive neutral current electron-proton scattering
** Input Cards and Plotting Macro: [https://drive.google.com/file/d/1P7Cxcq3aYia-pLylBsZxG-aD3wCYjOlG/view?usp=sharing 5+41 card], [https://drive.google.com/file/d/1PSQQz0biHMUmVLL95NEaREDDOFQi2vMh/view?usp=sharing 5+100 card], [https://drive.google.com/file/d/1MArZYJ-qkhW53Nk9_EOk-9SYC4R2GxWV/view?usp=sharing 10+100 card], [https://drive.google.com/file/d/1z2pCIUoq8BdZsS_F8xSDroMxLRlO-RRO/view?usp=sharing 18+275 card], [https://drive.google.com/file/d/11LzXO7HTTIZPX1dh8Pfc-ulntv7pagya/view?usp=sharing Macro]
** EIC-smear ROOT Files: '/gpfs02/eic/baraks/pythia/outfiles/yellow_report/' on BNL RACF machines (generator level: ep_*_newtune_*.root, after [https://github.com/eic/eicsmeardetectors/blob/master/SmearMatrixDetector_0_1.cxx eic-smear v0.1]: ep_*_newtune_*_matrixsmear.root)
** Q2 > 0.5 GeV2 
** Contact : Barak Schmookler
**Sample data files on bnl serverL file:///gpfs02/eic/DATA/PYTHIA/ep/YellowReport/

* BeAGLE ([https://eic.github.io/software/beagle.html Documentation], [https://gitlab.com/eic/mceg/DPMJetHybrid Code]), for inclusive neutral current electron-nucleus scattering
** Species and energies used: e+Au 5x41, 10x110, 18x110 GeV
** Generator used: BeAGLE
** Input Cards: [https://drive.google.com/drive/folders/1_tNvWaRMb70OmLmRpgLCJ1serLv9nLhZ?usp=sharing 18x110] (Others energies similar)
** ROOT Files: '/gpfs02/eic/baraks/BeAGLE/outForPythiaMode/rootfiles/' on BNL RACF machines
** Q2 > 0.5 GeV2 
** Contact : Barak Schmookler and Dmitriy Kim

* Djangoh ([https://eic.github.io/software/djangoh.html Documentation], [https://gitlab.com/eic/mceg/DJANGOH-4.6.10 Code]), for inclusive neutral-current ep scattering and charge current electron scattering
** Input cards for neutral-current ep scattering [https://drive.google.com/drive/folders/1Zbdp-7sbOoSw43aN_A03VOurXokgBW29?usp=sharing 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 ([https://eic.github.io/software/pythia6.html Documentation], [https://gitlab.com/eic/mceg/PYTHIA-RAD-CORR Code])
** Input cards and output files from YR (by R. Seidl) at: /gpfs/mnt/gpfs02/eic/DATA/YR_SIDIS/ (README file included)
** [https://wiki.bnl.gov/eicug/images/e/ef/Input.data.ep_noradcor.18x275.eic.gz Input card] for gluon Sivers at 18 GeV x 275 GeV (by L. Zheng)
* Pythia 8 + DIRE ([https://gitlab.com/eic/mceg/pythia8-dire-hepmc3 Code])
** [https://wiki.bnl.gov/eicug/images/8/82/Pythia8dire.cmnd.gz Input card] (by A. Vossen)
* elSpectro ([https://github.com/dglazier/elSpectro Code])
** Generator for incorporating Spectroscopy into electro/photoproduction reactions, by D. Glazier
** Sample steering cards at: [https://github.com/dglazier/elSpectro https://github.com/dglazier/elSpectro]

== Jets & HQ ==
* Pythia 6 ([https://eic.github.io/software/pythia6.html Documentation], [https://gitlab.com/eic/mceg/PYTHIA-RAD-CORR Code])
** [https://wiki.bnl.gov/eicug/images/6/63/Pythia6.steer.gz Sample steering card]
** MC files: /gpfs02/eic/DATA/PYTHIA/ep/YellowReport/
** Contact: B. Page

* Pythia 6 ([https://eic.github.io/software/pythia6.html Documentation], [https://gitlab.com/eic/mceg/PYTHIA-RAD-CORR Code])
** [https://wiki.bnl.gov/eicug/images/2/28/Input.data.eAu_noradcor.10x100.eic.gz Steering card]
** Used for Fig. 7.21 and 7.60 of YR
** More details: [https://arxiv.org/abs/2102.08337 arXiv:2102.08337]
** Contact: Matthew Kelsey

* Pythia 6 ([https://eic.github.io/software/pythia6.html Documentation], [https://gitlab.com/eic/mceg/PYTHIA-RAD-CORR Code])
** [https://wiki.bnl.gov/eicug/index.php/Yellow_Report_Physics_Jets-HF#AllInclusivePing Steering cards]
** Contact: Cheuk-Ping Wong

* Pythia 8
** [https://wiki.bnl.gov/eicug/index.php/Yellow_Report_Physics_Jets-HF#EIC_kinHeavy_XuanLi Steering cards]
** Contact: Xuan Li

* Analysis code for groomed jet substructure and some PID studies: [https://github.com/osbornjd/EICJetSubstructure by J. Orborn], [https://github.com/dillfitz/EICJetSubstructure by D. Fitzgerald]

==Exclusive reactions==

* TOPEG ([https://gitlab.in2p3.fr/dupre/nopeg Code and documentation]): nuclear DVCS (including proton)
** Contact: R. Dupré

* DVCS
** Generator: [https://github.com/eic/Milou3d 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 ==
[https://wiki.bnl.gov/eicug/index.php/Yellow_Report_Physics_Diffractive_Reactions_-_Tagging Yellow Report Diffractive & Tagging Page]

[https://wiki.bnl.gov/eicug/index.php/Yellow_Report_Physics_Diffractive_Reactions_-_Tagging Yellow Report Exclusive Reaction Page]

* eSTARlight ([https://github.com/eic/estarlight#estarlight Code and documentation]): coherent vector meson photo- and electro-production
** Contact: S. Klein
** [https://github.com/eic/estarlight/tree/master/templates Sample input cards]
** Analysis plugin:

* RAPGAP ([https://gitlab.com/eic/mceg/RAPGAP-3.302 Code], [https://eic.github.io/software/rapgap.html Documentation]): inclusive diffraction
** Contact: W. Slominski
** [http://th-www.if.uj.edu.pl/~wojteks/EIC-pub/Rapgap/#_steering_cards_and_commands Steering cards]
** MC samples: /gpfs/mnt/gpfs02/eic/YR/RAPGAP
** Analysis plugin:

* EIC_mesonMC ([https://github.com/JeffersonLab/EIC_mesonMC Code], [https://github.com/JeffersonLab/EIC_mesonMC/blob/develop/eic_SF/README.ipynb Documentation]): Sullivan process (meson structure)
** Contact: R. Trotta
** More info: [https://wiki.bnl.gov/eicug/index.php/Yellow_Report_Physics_Diffractive_Reactions_-_Tagging#Sullivan_Process_.28Meson_Structure.29 YR wiki], [https://arxiv.org/pdf/2102.11788.pdf arXiv:2102.11788]
** MC samples:
*** [https://drive.google.com/file/d/1Qv4RLHimO1o--Wculb3j_d705K_XyYbc/view 5 on 41 ]
*** [https://drive.google.com/file/d/1e5narT2U5N3yzPgY9miHJDfWTGl8Kwke/view 10 on 100 ]
*** [https://drive.google.com/file/d/1YnqnukCI9c6UPeJZBdNkuIMEHuZqfWxP/view 10 on 135]
*** Fun4all instruction: passing through EIC Smear first. Interface script is under work.
** Analysis plugin:

* u-channel π0 Production
** Contact: Wenliang (Bill) Li (wenliang.billlee@gmail.com)
** Generator: [https://github.com/sjdkay/DEMPgen DEMPgen]
** MC samples:
*** 5 on 100: [https://drive.google.com/file/d/1GNb5pbTMF1JYhcfcfuolSXW4Eg6lcOtL/view?usp=sharing 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: [https://github.com/sjdkay/DEMPgen DEMPgen]
** MC samples:
*** [https://drive.google.com/file/d/1l97MoXN_0tjj1_STQ_F2Wvln7aa12fQp/view?usp=sharing 5 on 41]
*** [https://drive.google.com/file/d/1jcqsJQ2Efv45wfr39e3xFOX_hI04j02v/view?usp=sharing 5 on 100]
*** [https://drive.google.com/file/d/1M0HHk-Y11MN8iIj01kp7f3TaSBCNGLZf/view?usp=sharing 10 on 100]
*** [https://drive.google.com/file/d/1c40NL8C1HNm32Ay_FYiVgr9WHliNBh-V/view?usp=sharing 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:
*** [https://drive.google.com/file/d/1HEAt3guCXj3NowzKtBNhIdXQ1-Ot2oJv/view?usp=sharing Electron-Cabon data 5 on 41]
*** [https://drive.google.com/file/d/1jbNsAp6qwhQCc3zAQNx2YmhV6Ghq83S9/view?usp=sharing Electron-Cabon data 10 on 110]
*** [https://drive.google.com/file/d/1h9WiScv6APhqQfAiTaNKxIL2vm9QHYLF/view?usp=sharing e-D data 5 on 41]
*** [https://drive.google.com/file/d/17aDgw-RwESJO7o3HoFITZ7nWhC0hDW_y/view?usp=sharing 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 =
* [https://eic.github.io/software/eicsmear.html EIC-smear github repository]
* [https://eic.github.io/software/eicsmear_generators_singularity.html Running EIC-smear and event generators from a singularity container]

= [[ Delphes ]] =

= [https://eic.github.io/software/fun4all.html 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 https://github.com/bschmookler/fun4all_eicmacros/tree/CORE/detectors/CORE].
** Everyone can download. If you want to upload files, please send an email to barak.schmookler@stonybrook.edu.
* 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 ]]
** [https://github.com/ECCE-EIC/Singularity Running Fun4All from a singularity container]
** [https://eic-detector.github.io/tutorials_landing_page.html 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 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.

Core Wiki - User contributions [en]

Simulations