Warning, /snippets/Tracking/BackgroundStudy/README.md is written in an unsupported language. File is not indexed.
0001 # Example scripts for tracking performance study with beam background
0002 * See https://indico.bnl.gov/event/29753/
0003 * contact: Shujie Li, shujieli@lbl.gov
0004
0005 ## run_merger.sh:
0006 This is an example script to generate small sample of background mixed hepmc file locally.
0007
0008 Pleae always use background files from the simulation campaign data (https://eic.github.io/epic-prod/) when possible
0009
0010 ### pre-requists:
0011 1. install SignalBackgroundMerger from https://github.com/eic/HEPMC_Merger
0012 2. recommend to run within eic-shell to use the xrdfs command
0013
0014 run as: ./run_merger.sh, then follow the options.
0015
0016 * Mixing frequencies can be found on [ePIC background Wiki](https://wiki.bnl.gov/EPIC/index.php?title=Background)
0017 * Explanations on [mixing scheme](https://github.com/eic/eic.github.io/blob/master/_resources/background_mixed_samples.md)
0018
0019 * For SR and electron beam gas, please also read README files under JLab ifarm (contact: Andrii Natochii):
0020 SynRad: /volatile/eic/andrii/SynradG4_HepMC_Files_SR_on_IP6
0021 ESR beam losses: /volatile/eic/andrii/Xsuite_HepMC_Files_ESR_BeamLoss_on_ePIC
0022
0023 * 1000 merged events at 18GeV takes about 2 hours for dd4hep+eicrecon. The 5 and 10 GeV mixed events will be 10x slower due to higher SR freq. Use the simulation campaign file if you can.
0024
0025 * You need then run npsim with the generated hepmc file and corresponding flags.
0026
0027
0028 ## epic_analysis-ak_example.ipynb
0029 example python script to pull out background particle distributions, track efficiency and purity etc. It uses uproot (>2.7), seaborn, particle, and a few other python modules. You may need to pip install them.
0030
0031 Hopefully one can convert desired functions to plain python script, of ROOT/C easily with chatgpt.
0032
0033 * please run this within eic-shell if you want to use any podio modules:
0034 1. in eic-shell, type jupyer-lab to start the server (may take a minute)
0035 2. copy the localhost link to your browser or editor to open the notebook.
0036
0037 * key functions: get_traj_hits, get_part_hits. Most interesting plots are under subsection "efficiency" and "track purity"
0038
0039 * suggestion to general physics analysis: only use tracks with at least 4 hits, e.g. __CentralCKFTrajectories.nMeaurements>3__
0040
0041
