Gabriele Cosmo
129 lines
5.2 KiB
Plaintext
129 lines
5.2 KiB
Plaintext
|
|
=========================================================
|
|
Geant4 - ICRP145_HumanPhantoms example
|
|
=========================================================
|
|
|
|
README
|
|
---------------------
|
|
|
|
|
|
********************************************************************
|
|
* The ICRP145 Phantoms are used in Geant4 with permission from the *
|
|
* International Commission on Radiological Protection * *
|
|
********************************************************************
|
|
|
|
Authors' list:
|
|
• Haeginh Han / Hanyang University, Republic of Korea
|
|
• Min Cheol Han / Yonsei University Health System, Republic of Korea
|
|
• Banho Shin / Hanyang University, Republic of Korea
|
|
• Chansoo Choi / University of Florida, USA
|
|
• Yeon Soo Yeom / Yonsei University, Republic of Korea
|
|
• Jonghwi Jeong / National Cancer Center, Republic of Korea
|
|
• Chan Hyeong Kim / Hanyang University, Republic of Korea
|
|
|
|
Bibliographic references - please refer to this reference when using the Advanced Example
|
|
• ICRP, 2020. Adult mesh-type reference computational phantoms. ICRP Publication 145. Ann. ICRP 49(3).
|
|
|
|
Geant4 Contributors: J. Allison and S. Guatelli
|
|
|
|
e-mail inquiries to: haeginh@hanyang.ac.kr, susanna@uow.edu.au, MRCP.ICRP@gmail.com
|
|
|
|
1- HOW TO BUILD AND RUN THE EXAMPLES
|
|
|
|
Please note that the guides below are based on Linux/MacOSX, which are the
|
|
recommended platforms for Geant4.
|
|
|
|
1) Compile and link to generate an executable (with CMake)
|
|
|
|
% cd path_to_example
|
|
% mkdir example_build
|
|
% cd example_build
|
|
% cmake ..
|
|
% make
|
|
This should make two executables - ICRP145phantoms and ICRP145standalone.
|
|
|
|
2) How to run
|
|
|
|
a) For the irradiation with external beams:
|
|
|
|
% ./ICRP145phantoms [options]
|
|
|
|
Options:
|
|
-m [input file name] optional provided->batch mode
|
|
not provided->interactive mode
|
|
-o [output file name] optional (default: [macro file name].out)
|
|
-f optional switch to change the phantom to MRCP-AF
|
|
(default: MRCP-AM)
|
|
|
|
ex) MRCP-AM: % ./External -m example.in -o example.out
|
|
ex) MRCP-AF: % ./External -m example.in -o example.out -f
|
|
|
|
*** The radiation source can be specified in source.mac file by using
|
|
macro commands for G4GeneralParticleSource (/gps/)
|
|
|
|
b) For the case of internal radiation sources:
|
|
|
|
% ./ICRP145phantoms [options]
|
|
|
|
Options:
|
|
-i [ID of source organ] mandatory (ID of each organ can be found in Appendix A)
|
|
-m [input file name] optional provided->batch mode
|
|
not provided->interactive mode
|
|
-o [output file name] optional (default: [macro file name].out)
|
|
-f optional switch to change the phantom to MRCP-AF
|
|
(default: MRCP-AM)
|
|
|
|
ex) MRCP-AM: % ./Internal -i 9500 -m example.in -o example.out
|
|
ex) MRCP-AF: % ./Internal -i 9500 -m example.in -o example.out -f
|
|
|
|
*** source organ can be defined by using -i option.
|
|
*** source particle and the particle energy can be specified
|
|
in source.mac file by using macro commands for G4ParticlGun (/gun/)
|
|
|
|
c) To see the phantom alone:
|
|
|
|
% ./ICRP145standalone
|
|
|
|
This allows you to visualise the phantom without the overhead of
|
|
the run manager and physics tables and geometry initialisation.
|
|
Of course, you cannot run or visualise trajectories.
|
|
|
|
d) Notes
|
|
|
|
- Regarding the interactive mode with visualisation:
|
|
|
|
* you can run the codes in interactive mode with visualisation by
|
|
omitting -m option.
|
|
* with "special mesh rendering" (see vis.mac) the memory required
|
|
for the visualisation about 1.5 GB (without, it's ~35 GB!).
|
|
* original data takes about 3 GB, physics tables and geometry
|
|
voxelisation consume about 5 GB, so a typical app is about 10 GB.
|
|
* in interactive mode, user should start a run by using
|
|
/run/beamOn command. (Idle> /run/beamOn [number of events])
|
|
|
|
|
|
- Regarding the multi-threaded mode:
|
|
|
|
* these examples can be run in multi-threaded mode when Geant4 was
|
|
compiled in multi-threaded mode.
|
|
* the number of threads can be set in input file (see example.in)
|
|
|
|
- Regarding the path to phantom data:
|
|
|
|
* the default path to phantom data is "(build_directory)/../../phantoms".
|
|
* to specify the path please change a PHANTOM_PATH environment variable.
|
|
(export PHANTOM_PATH="path_to_phantom_data")
|
|
|
|
2- RESULT FILE
|
|
|
|
example_male.out and example_female.out files in each folder is the result file
|
|
for example.in. The result file provides absorbed doses for all organ IDs for TM
|
|
model listed in Appendix A.
|
|
|
|
3- LICENSE
|
|
|
|
This code is based on Geant4 toolkit, and therefore follows the 'The Geant4
|
|
Software License' (http://geant4.web.cern.ch/license/LICENSE.html).
|
|
|
|
|