Warning, /epic-analysis/deps/delphes_EIC/docs/index.rst is written in an unsupported language. File is not indexed.
0001 .. Documentation master file
0002
0003 Delphes EIC
0004 ===========
0005
0006 .. toctree::
0007 :maxdepth: 2
0008 :caption: Getting started:
0009
0010 install.md
0011
0012
0013 .. toctree::
0014 :maxdepth: 2
0015 :caption: Links:
0016
0017 GitHub <https://github.com/eic/delphes_EIC>
0018 Delphes <https://github.com/delphes/delphes>
0019
0020
0021 .. Add main page text here
0022
0023
0024 Welcome to the **Delphes EIC** project. This code aims to deliver a fast-simulation model of baseline or specific detectors for studies to support the Electron-Ion Collider (EIC) project. This code has been used in a few publications and papers and parts of it are available for citation through Zenodo:
0025
0026 - Charm jets as a probe for strangeness at the future Electron-Ion Collider. Miguel Arratia (UC Riverside amd Jefferson Lab), Yulia Furletova (Jefferson Lab), T. J. Hobbs (Southern Methodist U. and Jefferson Lab), Frederick Olness (Southern Methodist U.), Stephen J. Sekula (Southern Methodist U.). https://arxiv.org/abs/2006.12520 [hep-ph]
0027 - A Delphes card for the EIC yellow-report detector. Miguel Arratia (UC Riverside amd Jefferson Lab) and Stephen J. Sekula (Southern Methodist U.). https://arxiv.org/abs/2103.06886 [physics.ins-det]. DOI: https://doi.org/10.5281/zenodo.4592887.
0028 - Science Requirements and Detector Concepts for the Electron-Ion Collider: EIC Yellow Report.R. Abdul Khalek, A. Accardi, J. Adam, D. Adamiak, W. Akers et al. e-Print: https://arxiv.org/abs/2103.05419 [physics.ins-det]
0029
0030
0031 .. image:: https://github.com/eic/delphes_EIC/raw/master/images/EICDetector_3D_CCDIS_CharmJet.png
0032
0033 .. image:: https://github.com/eic/delphes_EIC/raw/master/images/EICDetector_3D_CCDIS_CharmJet_DisplacedVtx.png
0034
0035 ====
0036 What's New?
0037 ====
0038
0039 * EIC PID code has been used to create IdentificationMaps for the mRICH, barrelDIRC, and dualRICH. No more external code needed!
0040
0041 ====
0042 Installation Instructions
0043 ====
0044
0045 #. OPTIONAL (but recommended): Install LHAPDF
0046 #. Install PYTHIA8.3 (if you installed LHAPDF, build with LHAPDF support)
0047 #. Install Delphes3 following: https://github.com/delphes/delphes
0048
0049
0050 ====
0051 EIC Yellow-Report Detector Models
0052 ====
0053
0054 The current model we recommend is ```delphes_card_allsilicon_3T.tcl```. Is is based on detector studies from the EIC Yellow Report (https://arxiv.org/abs/2103.05419). This model incorporates all-silicon tracking, as well as an EMCAL and HCAL. PID system responses are provided by efficiency maps based on EIC PID code (https://gitlab.com/preghenella/pid/).
0055
0056 - Magnetic field: 1.5 T or 3.0 T
0057 - Solenoid length: 2.0 m
0058 - Tracker radius: 80 cm
0059 - An HCAL and and EMCAL
0060 - Particle ID systems: based on the mRICH, barrel DIRC, and dual RICH concepts articulated by the EIC community; implemented using IdentificationMaps
0061
0062 We currently simulate DIS using Pythia8 within Delphes. The command file (ending in `.cmnd`) shown here and available in the project is suitable for DIS at EIC.
0063
0064 ====
0065 Using the project
0066 ====
0067
0068 Generating Events
0069 ----
0070
0071 We recommend PYTHIA 8.3 for event generation, and the latest version of Delphes builds and links against 8.3 without incident, allowing for seamless generation and then detector response modeling all in one step using the ```DelphesPythia8``` binary:
0072
0073 .. code:: bash
0074
0075 DelphesPythia8 delphes_card_allsilicon_3T.tcl pythia8cards/CC_DIS.cmnd out.root
0076
0077 For examples of other detector configurations, analysis code, etc. see the main Delphes project site.
0078
0079 Visualizing Events
0080 ----
0081
0082 Run the Delphes visualization script on your ROOT file, using the input Delphes card (TCL) file to help it structure the detector in the display:
0083
0084 .. code:: bash
0085
0086 root -l examples/EventDisplay.C'("delphes_card_allsilicon_3T.tcl","out.root")'
0087
0088 The two examples shown here are for neutral-current and charged-current event for beam energies of 10 GeV electron on 100 GeV proton (63 GeV center-of-mass energy).
0089
0090 EIC Collider Variations
0091 ----
0092
0093 Beam energy recommended benchmarking points are (the order is hadron on lepton):
0094
0095 * 275 on 18 GeV
0096 * 100 on 10 GeV
0097 * 100 on 5 GeV
0098 * 41 on 5 GeV
0099
0100
0101 The "SimpleAnalysis" framework
0102 ----
0103
0104 See the dedicated SimpleAnalysis_ Documentation.
0105
0106 .. _SimpleAnalysis: SimpleAnalysis/README.md
