Core Wiki - User contributions [en]

Howto

2021-08-10T17:54:35Z

Munoz:

To use (at BNL or through the MCEG singularity container):
* Set up the environment:

setenv EIC_LEVEL dev

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

or

export EIC_LEVEL=dev

source /cvmfs/eic.opensciencegrid.org/x8664_sl7/MCEG/releases/etc/eic_bash.sh

* Prepare a directory:

cp $EICDIRECTORY/PACKAGES/Milou3d/dvcs.steer .

ln -s $EICDIRECTORY/PACKAGES/Milou3d/*.dat .

* Run!

$EICDIRECTORY/bin/milou3d

A description of the output and legacy info on the old code are given here: https://wiki.bnl.gov/eic/index.php/MILOU

Simulations

2021-08-10T17:53:36Z

Munoz: /* Exclusive reactions */

= [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).
== 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

* 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)

= [https://eic.github.io/software/eicsmear.html EIC-smear] =

* [https://eic.github.io/software/eicsmear_generators_singularity.html 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]]

= [https://eic.github.io/software/fun4all.html Fun4All ] =
* [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]

2021-08-10T17:24:43Z

Munoz:

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

Please contact the Physics Benchmarks Team conveners for general questions or requests

== 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

* 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: 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 ==
[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. 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)

= [[ Delphes ]] =
*[[Delphes_EIC_CORE_2.5T_Grassi.tcl]]
* ATHENA (template for 3T Magnet): [[Athena.tcl]]

= [[ Fun4All ]] =
* [https://ecce-eic.github.io/ ECCE@EIC Software Documentation]
* [https://ecce-eic.github.io/tutorials_day1.html Day-1 checklist]
* [https://indico.bnl.gov/event/11112/contributions/47260/attachments/33415/53698/Kauder_eicsmear_generators_ECCE_Apr2021.pdf K. Kauder's talk at the ECCE software worshop]
* [https://indico.bnl.gov/category/346/ ECCE Physics Work Group Indico Agenda]

Simulations

2021-08-10T17:23:26Z

Munoz:

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

Please contact the Physics Benchmarks Team conveners for general questions or requests

== 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

* 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: 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 ==
[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. 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)

= Fun4all Simulation and Other Important Common Resources=

* [https://ecce-eic.github.io/ ECCE@EIC Software Documentation]
* [https://ecce-eic.github.io/tutorials_day1.html Day-1 checklist]
* [https://indico.bnl.gov/event/11112/contributions/47260/attachments/33415/53698/Kauder_eicsmear_generators_ECCE_Apr2021.pdf K. Kauder's talk at the ECCE software worshop]
* [https://indico.bnl.gov/category/346/ ECCE Physics Work Group Indico Agenda]

= [[ Delphes ]] =
*[[Delphes_EIC_CORE_2.5T_Grassi.tcl]]
* ATHENA (template for 3T Magnet): [[Athena.tcl]]

= [[ Fun4All ]] =