TP2: Installation de Géant4 et travailler
des examples
Le but de ce deuxième TP est d’installer Geant4 sur Ubuntu et travailler sur des exemples
basiques.
1 I NSTALLATION DE G ÉANT 4 DANS L INUX
1. Assurez-vous que votre système est à jour en utilisant la commande "sudo apt update"
suivie de "sudo apt upgrade".
2. Installez les paquets nécessaires pour compiler Geant4 en utilisant la commande :
sudo apt-get install libxerces-c-dev qt4-dev-tools freeglut3-dev libmotif-dev tk-dev cmake
libxpm-dev libxmu-dev libxi-dev
3. Téléchargez la version 9.6.0 de Geant4 depuis le site officiel et extrayez l’archive dans un
répertoire de votre choix. [Link]
4. Créez un nouveau répertoire pour la construction de Geant4 en utilisant la commande
"mkdir build" depuis le répertoire Geant4 que vous venez d’extraire.
5. Accédez au répertoire de construction en utilisant la commande "cd build" 6. Configurez
Geant4 en utilisant la commande :
" cmake -DCMAKE_INSTALL_PREFIX= /chemin vers geant4/geant9.6.0/geant9.6.0-install
-DGEANT4_USE_GDML=ON -DCMAKE_BUILD_TYPE=Debug -DGEANT4_INSTALL_DATA=ON
-DGEANT4_USE_OPENGL_X11=ON -DGEANT4_USE_XM=ON -DGEANT4_USE_QT=ON
-DGEANT4_BUILD_MULTITHREADED=ON /chemin vers geant4/geant9.6.0"
7. Compilez Geant4 en utilisant la commande "make -j4" (4 étant le nombre de cœurs de
votre processeur. Vous pouvez le remplacer par un nombre différent si nécessaire).
8. Installez Geant4 en utilisant la commande "make install".
Une fois l’installation terminée, vous pouvez tester Geant4 en exécutant un exemple fourni
avec l’installation. Vous pouvez trouver des exemples dans le répertoire Geant4 que vous
avez extrait précédemment.
1
2 G ÉANT 4 ET M ACHINE V IRTUELLE V G ATE
Si vous avez installé la machine virtuelle vgate, vous n’avez pas besoin d’installer Geant4 sé-
parément car il est déjà intégré dans la machine virtuelle. Vous pouvez trouver Geant4 dans
le répertoire "/home/vgate/Software/Geant4".
3 G ÉANT 4 RÉPERTOIRE
Geant4 est une boîte à outils logicielle permettant de simuler le passage de particules à travers
la matière. Le code source de Geant4 est organisé en différents dossiers, chacun ayant un rôle
spécifique. Voici un bref aperçu du rôle de chaque dossier :
-"config" : Ce dossier contient des fichiers de configuration pour différents systèmes d’exploitation,
compilateurs et options de compilation. Il comprend également des fichiers de configuration
pour divers packages externes dont dépend Geant4. -"examples" : Ce dossier contient des
exemples d’applications qui montrent comment utiliser Geant4 pour différentes simulations
de physique.
-"graphics" : Ce dossier contient le code source pour la visualisation de la simulation, tels
que dessiner des trajectoires de particules et des détecteurs.
-"physics_lists" : Ce dossier contient le code source pour définir les processus de physique
qui seront utilisés dans la simulation, tels que les interactions électromagnétiques ou les in-
teractions hadroniques.
-"source" : Ce dossier contient la majeure partie du code source de Geant4, organisé en
différents sous-dossiers par fonctionnalité. "tests" : Ce dossier contient le code source pour
tester la fonctionnalité de Geant4, y compris les tests unitaires et les tests d’intégration.
4 E XÉCUTION DUN EXAMPLE G EANT 4
Pour exécuter un exemple dans Geant4, vous devez suivre les étapes suivantes :
1. Tout d’abord, ouvrez un terminal et accédez au répertoire d’installation de Geant4. Vous
pouvez utiliser la commande suivante pour cela :"cd /chemin/vers/geant4-install/"
2. Une fois que vous êtes dans le répertoire d’installation de Geant4, accédez au répertoire
"examples/basic/B1". Vous pouvez utiliser la commande suivante pour cela :
"cd examples/basic/B1/"
3. Créer un dossier "build"
3. A l’intérieur du dossier build, vous pouvez compiler l’exemple en utilisant ces deux com-
mandes :
- cmake -DGeant4_DIR= /chemin/vers/geant4-install/lib/Geant4-10.7.1 ../
- make
Maintenant vous devez voir un nouveau fichier en vert "exampleB1"
2
4. Lancer la commande suivante pour exécuter le code:
./exampleB1
5 E XPLICATION DU CONTENU DE L’ EXEMPLE BASIQUE : B1
Les fichiers principaux de l’exemple B1 sont les suivants :
Le dossier src:
-[Link] : Ce fichier définit la géométrie du détecteur en utilisant des
volumes solides de Geant4 tels que des boîtes et des tubes. Il définit également les matériaux
utilisés dans le détecteur.
-[Link] : Ce fichier définit la particule incidente et ses propriétés
telles que l’énergie et la direction. Dans cet exemple, une particule de rayonnement gamma
est utilisée comme particule incidente.
-[Link] : Ce fichier définit les actions qui sont prises à chaque début et fin d’une
simulation. Dans cet exemple, il n’y a pas d’actions définies.
-[Link] : Ce fichier définit les actions qui sont prises à chaque événement de la
simulation. Dans cet exemple, l’énergie et la position des particules détectées sont enreg-
istrées dans un fichier de sortie.
-[Link] : Ce fichier définit les actions qui sont prises à chaque pas de la partic-
ule dans la simulation. Dans cet exemple, il n’y a pas d’actions définies.
- Le fichier [Link] : Ce fichier contient le code principal de l’exemple. Il instancie
les différentes classes et définit les paramètres de la simulation.
L’exemple B1 affiche les résultats de la simulation dans un fichier de sortie [Link].
Ce fichier contient l’énergie et la position des particules détectées dans chaque événement
de la simulation.
- Le fichier [Link]: contient La définition du faisceau de particules, comprenant des
paramètres tels que l’énergie, le type de particule et le nombre de particules dans le faisceau.
Le fichier [Link] est un fichier d’entrée de données au format ASCII (texte brut) et
peut être modifié en utilisant un éditeur de texte. Les données dans le fichier sont lues par
le programme de simulation Geant4 et sont utilisées pour initialiser la simulation avant son
exécution.
- Le fichier [Link] est utilisé pour exécuter la simulation en mode interactif. Lorsque vous
exécutez le fichier [Link], une interface graphique s’ouvre et vous permet d’interagir avec
la simulation en temps réel. Vous pouvez modifier les paramètres de la simulation et visu-
aliser les résultats de la simulation à mesure qu’ils sont générés. Pour le tester , utilser cette :
./exampleB1 [Link]
Lorsque vous exécutez la commande, l’application Geant4 démarrera et une interface util-
isateur graphique (GUI) apparaîtra. Vous pouvez utiliser la GUI pour interagir avec la sim-
ulation et modifier les paramètres de la simulation comme vous le souhaitez. La simulation
s’exécutera en continu jusqu’à ce que vous fermiez la fenêtre de la GUI.
Voici le rôle de certaines commandes à l’intérieur "[Link]": -Changement du nombre
d’événements simulés :
3
/run/beamOn 100 , Cela changera le nombre d’événements simulés à 100. Vous pouvez rem-
placer "100" par le nombre d’événements que vous souhaitez simuler.
- Changement du type de particule primaire :
/gun/particle e- , Cela changera le type de particule primaire à un électron. Vous pouvez
remplacer "e-" par le type de particule que vous souhaitez utiliser.
- Changement de l’énergie de la particule primaire :
/gun/energy 10 MeV , Cela changera l’énergie de la particule primaire à 10 MeV. Vous pouvez
remplacer "10 MeV" par l’énergie que vous souhaitez utiliser.
- Affichage des informations sur le détecteur :
/vis/scene/create
/vis/scene/add/volume
/vis/drawVolume
, Ces commandes créeront une scène de visualisation et afficheront des informations sur le
détecteur dans la fenêtre de visualisation.
- Le fichier [Link] est utilisé pour exécuter la simulation en mode batch (sans interface
graphique). Lorsque vous exécutez le fichier [Link], la simulation est exécutée sans inter-
vention de l’utilisateur et les résultats sont stockés dans des fichiers de sortie spécifiés dans
le fichier de commande.
-Pour le tester , utilser ces deux commandes :
./exampleB1 [Link]
./exampleB1 [Link] > [Link]
- Le fichier README: fournit des informations sur l’exemple et comment l’utiliser. Il contient
des instructions sur la façon de compiler et d’exécuter l’exemple, ainsi que des explications
sur les fichiers d’entrée et de sortie utilisés dans la simulation.
D EVOIR : EN GROUPE
Chaque groupe doit préparer un rapport et une présentation sur l’un des exemples novices.
Vous disposez d’un délai d’un mois pour réaliser ce travail.
Exemples avec lesquels travailler :
-Groupe1: ExampleB2 basic/B2
-Group2: ExampleB4 basic/B4
-Groupe3: ExampleRE05 extended/runAndEvent/RE05
Veuillez le télécharger dans la boîte suivante: [Link]