ENL_Optical_Sim for Studies of light detectors [[email protected], [email protected]]

INSTRUCTIONS TO USE THE SIMULATION

- Download the VMWare Geant4.11.0.0 from https://heberge.lp2ib.in2p3.fr/G4VM/index.html

- Copy all the files from ENL_Optical_Simulation folder (https://github.com/ahuber33/ENL_Optical_Simulation)

- Create a build folder in the ENL_Optical_Simulation folder and go inside.

- Use this command : "cmake -DGeant4_DIR=$G4COMP ../" and compile it with make

- The executable ENLOpticalSim will be add to your bin folder

- If you want to have a visualization, launch this command : "./ENLOpticalSim [name of ROOT file ]". It will generate 1 particle according to the vis.mac with QT and you will have a ROOT file with the name you gave in response located in the Resultats folder.

- If you want to have statistics without the visualization, use this command : "./ENLOpticalSim [name of ROOT file] [number of events generated] [name of macro]". Personnaly, I used the vrml.mac but you can create another one. Just to remember that you need to write the name of your macro when you launch the simulation.

- If you want to change the geometry (HPD to PMT or something else), you just need to choose the correct geometryfile.cc in the CMakeLists.cc. Don't forget to comment the other one.

- You can change the lighyield in the Materials.cfg located in the bin folder without re-compile the code.

- DO NOT HESITATE TO REPORT BUGS OR ANY IDEAS THAT WILL IMPROVE THE SIMULATION !!!!

#- For information :

- Scintillation properties are defined in the ENLOpticalSimMaterials.cc

- Index or length attenuation are defined in the ENLOpticalSimMaterials.cc

- All the reflectors & PMT properties are defined in the ENLOpticalGeometryxxx.cc used.

- theRunTree corresponds to general optical datas from 1 event (number of photons generated, ect)

- theRunTree_bis corresponds to information attached to all single photons created. Be careful if you launch big simulations because the ROOT file will be fat... Don't hesitate to comment the "runac->UpdateStatisticsbis(Statisticsbis);" in the ENLOpticalSimEventAction.cc if you don't need these informations

- Tree_electrons corresponds to basic information about electrons as a primary particle.

Commit #1 le 07/03/2022 (First commit)

- Simulation issue du commit #5 de TPSim avec nettoyage pour simplifier la lecture du code

Commit #2 le 07/03/2022 (additional commit)

- Ajout de l'information sur l'énergie du photoélectrons crée à la photocathode dans le RunTreeBis au niveau de la détection.

- Ajout des commentaires nécessaires à l'installation et à l'utilisation de la simulation au début de ce fichier.

Commit #3 le 08/03/2022 (Split absorption/scattering length)

- Ajout de la propriété Rayleigh scattering et donc split de l'attenuation length en absorption length et scattering length selon [https://www.researchgate.net/publication/254060762_Optical_Absorption_Length_Scattering_Length_and_Refractive_Index_of_LaBr3Ce3]

- Selon cette référence, l'absorption entraine quasi à chaque fois la réémission d'un photon derrière donc à investiguer dans le futur !!!

-> commit 3 bis rétablit juste certains commentaires pour éviter de polluer l'affichage lors de la simulation

-> commit 3 ter est juste un mini patch résolvant un petit soucis dans l'obtention des résultats

Commit #4 le 09/01/2024

- Passage du code sur la version 11.2.0 de GEANT4

- Passage de Atom vers Visual Code Studio avec notamment création d'une branche save permettant de push les changements d'une journée avant demerge sur la branche principale