Main Page
From UCL HEP PBT Wiki
m |
m |
||
| Line 1: | Line 1: | ||
== Introduction == | == Introduction == | ||
---- | ---- | ||
| - | |||
This is a tutorial about applications of GEANT4 to medical physics. The GEANT4 is installed on the HEP Linux cluster at UCL. You will need an account on that cluster to be able to use this software, run example tutorials and create your own applications. | This is a tutorial about applications of GEANT4 to medical physics. The GEANT4 is installed on the HEP Linux cluster at UCL. You will need an account on that cluster to be able to use this software, run example tutorials and create your own applications. | ||
== Accounts and Registration == | == Accounts and Registration == | ||
---- | ---- | ||
| - | |||
=== Getting a computing account === | === Getting a computing account === | ||
| - | + | ---- | |
| - | Apply for a computing account on the HEP Linux cluster by sending e-mail to [mailto:support@hep.ucl.ac.uk HEPComputingSupport]. In your e-mail you have to state the reason for your application ( | + | Apply for a computing account on the HEP Linux cluster by sending e-mail to [mailto:support@hep.ucl.ac.uk HEPComputingSupport]. In your e-mail you have to state the reason for your application (e.g. medical physics student who will use GEANT4 on the HEP cluster). |
You will receive an e-mail from the HEP computing support with your username and password. Now you can log in to the HEP cluster “plus1” via ssh username@plus1.hep.ucl.ac.uk. | You will receive an e-mail from the HEP computing support with your username and password. Now you can log in to the HEP cluster “plus1” via ssh username@plus1.hep.ucl.ac.uk. | ||
=== Where to get help === | === Where to get help === | ||
| - | + | ---- | |
You can send e-mail to the GEANT4 support at [mailto:ilinavassileva@gmail.com GEANT4Support] or write to the forum. | You can send e-mail to the GEANT4 support at [mailto:ilinavassileva@gmail.com GEANT4Support] or write to the forum. | ||
== The basics of GEANT4 == | == The basics of GEANT4 == | ||
---- | ---- | ||
| - | + | GEANT4 is a toolkit for simulating the passage of particles through matter. The user creates his/her own simulation application using GEANT4 tools. The tools are base classes. There are eight base classes. | |
| - | GEANT4 is a toolkit for simulating the passage of particles through matter. The user creates his/her own simulation application using GEANT4 tools. The tools are base classes. There are eight base classes | + | |
* Three classes are mandatory | * Three classes are mandatory | ||
| Line 46: | Line 43: | ||
You can create your own classes which are derived from the base classes. All of them should be registered with the G4RunManager. In function main() which is the skeleton of the user simulation code you instantiate G4RunManager and notify it of your mandatory and optional classes. | You can create your own classes which are derived from the base classes. All of them should be registered with the G4RunManager. In function main() which is the skeleton of the user simulation code you instantiate G4RunManager and notify it of your mandatory and optional classes. | ||
| - | == Basic | + | == Basic tutorials == |
---- | ---- | ||
| - | |||
=== Monoenergetic photon pencil beam incident on a water cube === | === Monoenergetic photon pencil beam incident on a water cube === | ||
| - | + | ---- | |
* Introduction | * Introduction | ||
| Line 57: | Line 53: | ||
* Setting up the environment | * Setting up the environment | ||
| - | ; | + | ; Connect to plus1 cluster and create folder PhotonPencilBeam in your local area |
<blockquote> | <blockquote> | ||
| - | <span style="color:#800000"> ssh username@plus1.hep.ucl.ac.uk </span> | + | <span style="color:#800000"> ssh username@plus1.hep.ucl.ac.uk </span> <br/> |
| - | <span style="color:#800000"> mkdir PhotonPencilBeam </span> | + | <span style="color:#800000"> cd /home/username/ </span> <br/> |
| + | <span style="color:#800000"> mkdir PhotonPencilBeam </span> <br/> | ||
<span style="color:#800000"> cd PhotonPencilBeam </span> | <span style="color:#800000"> cd PhotonPencilBeam </span> | ||
</blockquote> | </blockquote> | ||
| - | ; | + | ; Setup GEANT4 environment |
<blockquote> | <blockquote> | ||
| Line 76: | Line 73: | ||
<blockquote> | <blockquote> | ||
| - | <span style="color:#800000"> cp /vasileva/BasicExamples/PhotonPencilBeam_source /username/PhotonPencilBeam/ </span> | + | <span style="color:#800000"> cp -r /vasileva/BasicExamples/PhotonPencilBeam_source /username/PhotonPencilBeam/ </span> |
</blockquote> | </blockquote> | ||
* How to run the code | * How to run the code | ||
| - | ; | + | ; Inside /username/PhotonPencilBeam/ create folder: |
<blockquote> | <blockquote> | ||
| Line 87: | Line 84: | ||
</blockquote> | </blockquote> | ||
| - | ; | + | ; Change to this directory and run cmake and make to build the PhotonPencilBeam tutorial: |
<blockquote> | <blockquote> | ||
| - | <span style="color:#800000"> cd PhotonPencilBeam_build </span> | + | <span style="color:#800000"> cd PhotonPencilBeam_build </span> <br/> |
| - | <span style="color:#800000"> cmake -DGeant4_DIR=/unix/pbt/Software/..../ /username/PhotonPencilBeam_source/ </span> | + | <span style="color:#800000"> cmake -DGeant4_DIR=/unix/pbt/Software/..../ /username/PhotonPencilBeam_source/ </span> <br/> |
<span style="color:#800000"> make </span> | <span style="color:#800000"> make </span> | ||
</blockquote> | </blockquote> | ||
| Line 98: | Line 95: | ||
=== Monoenergetic proton pencil beam incident on a water cube === | === Monoenergetic proton pencil beam incident on a water cube === | ||
| - | + | ---- | |
* Introduction | * Introduction | ||
* Setting up the environment | * Setting up the environment | ||
| Line 107: | Line 104: | ||
=== Proton beam with realistic geometry incident on a water cube === | === Proton beam with realistic geometry incident on a water cube === | ||
| - | + | ---- | |
* Introduction | * Introduction | ||
* Setting up the environment | * Setting up the environment | ||
| Line 116: | Line 113: | ||
=== Several proton beams with spread out Bragg peaks === | === Several proton beams with spread out Bragg peaks === | ||
| - | + | ---- | |
* Introduction | * Introduction | ||
* Setting up the environment | * Setting up the environment | ||
| Line 123: | Line 120: | ||
* How to analyze data | * How to analyze data | ||
| - | == Advanced | + | == Advanced tutorials == |
---- | ---- | ||
| - | |||
=== Cherenkov simulation === | === Cherenkov simulation === | ||
| - | + | ---- | |
* Introduction | * Introduction | ||
* Setting up the environment | * Setting up the environment | ||
| Line 135: | Line 131: | ||
=== Computed tomography === | === Computed tomography === | ||
| - | + | ---- | |
* Introduction | * Introduction | ||
* Setting up the environment | * Setting up the environment | ||
| Line 143: | Line 139: | ||
=== High-precision dosimetry === | === High-precision dosimetry === | ||
| - | + | ---- | |
* Introduction | * Introduction | ||
* Setting up the environment | * Setting up the environment | ||
