Main Page
From UCL HEP PBT Wiki
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 === | ||
| Line 14: | Line 16: | ||
== 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: | ||
| Line 42: | Line 45: | ||
== Basic examples == | == Basic examples == | ||
| + | ---- | ||
| + | |||
| + | === Monoenergetic photon pencil beam incident on a water cube === | ||
| + | |||
| + | * Introduction | ||
| + | |||
| + | This example shows the dose distribution in water along the incident photon beam. The beam hits the water cube surface and deposits a dose under the surface of the water. The volume of the water cube is divided into voxels. At each voxel the dose contribution from the pencil beams is summed up and yields the total dose along the beam axis. | ||
| + | |||
| + | * Setting up the environment | ||
| + | |||
| + | ** Connect to plus1 cluster and create a folder PhotonPencilBeam in your local area: | ||
| + | |||
| + | <blockquote> | ||
| + | ssh username@plus1.hep.ucl.ac.uk | ||
| + | mkdir PhotonPencilBeam | ||
| + | cd PhotonPencilBeam | ||
| + | </blockquote> | ||
| + | |||
| + | ** Setup GEANT4 environment: | ||
| + | |||
| + | <blockquote> | ||
| + | source ... (GEANT4 script) | ||
| + | </blockquote> | ||
| + | |||
| + | * How to get the code | ||
| + | |||
| + | ** Copy the code to your area: | ||
| + | |||
| + | <blockquote> | ||
| + | cp /vasileva/BasicExamples/PhotonPencilBeam_source /username/PhotonPencilBeam/ | ||
| + | </blockquote> | ||
| + | |||
| + | * How to run the code | ||
| + | |||
| + | ** Inside /username/PhotonPencilBeam/ create a folder: | ||
| + | |||
| + | <blockquote> | ||
| + | mkdir PhotonPencilBeam_build | ||
| + | </blockquote> | ||
| + | |||
| + | ** Change to this build directory and run cmake and make to build the PhotonPencilBeam example: | ||
| + | |||
| + | <blockquote> | ||
| + | cd PhotonPencilBeam_build | ||
| + | cmake -DGeant4_DIR=/unix/pbt/Software/..../ /username/PhotonPencilBeam_source/ | ||
| + | make | ||
| + | </blockquote> | ||
| + | |||
| + | * How to analyze data | ||
| + | |||
| + | === Monoenergetic proton pencil beam incident on a water cube === | ||
| + | |||
| + | * Introduction | ||
| + | * Setting up the environment | ||
| + | * How to get the code | ||
| + | * How to run the code | ||
| + | * How to analyze data | ||
| + | * Comparison with data from The Clatterbridge Cancer Centre | ||
| + | |||
| + | === Proton beam with realistic geometry incident on a water cube === | ||
| + | |||
| + | * Introduction | ||
| + | * Setting up the environment | ||
| + | * How to get the code | ||
| + | * How to run the code | ||
| + | * How to analyze data | ||
| + | * Comparison with data from The Clatterbridge Cancer Centre | ||
| + | |||
| + | === Several proton beams with spread out Bragg peaks === | ||
| + | |||
| + | * Introduction | ||
| + | * Setting up the environment | ||
| + | * How to get the code | ||
| + | * How to run the code | ||
| + | * How to analyze data | ||
== Advanced examples == | == Advanced examples == | ||
| + | ---- | ||
| - | == | + | === Cherenkov simulation === |
| + | * Introduction | ||
| + | * Setting up the environment | ||
| + | * How to get the code | ||
| + | * How to run the code | ||
| + | * How to analyze data | ||
| + | === Computed tomography === | ||
| + | * Introduction | ||
| + | * Setting up the environment | ||
| + | * How to get the code | ||
| + | * How to run the code | ||
| + | * How to analyze data | ||
| - | + | === High-precision dosimetry === | |
| - | * | + | |
| - | * | + | * Introduction |
| - | * | + | * Setting up the environment |
| + | * How to get the code | ||
| + | * How to run the code | ||
| + | * How to analyze data | ||
| + | |||
| + | == Installing GEANT4 software locally == | ||
| + | ---- | ||
