Warning, /geant4/examples/extended/medical/dna/AuNP/README.md is written in an unsupported language. File is not indexed.
0001 \page ExampleAuNP Example AuNP
0002
0003 \author D. Sakata (a) \n
0004 (a) email: sakata.dousatsu@qst.go.jp, dosatsu.sakata@cern.ch \n
0005
0006 ## INTRODUCTION
0007
0008 The AuNP example simulates the track-structure of electrons in microscopic gold volume.
0009 The example also simulates that in liquid water medium surrounding the gold volume.
0010
0011 This example is provided by the Geant4-DNA collaboration.
0012
0013 These processes and models are further described at:\n
0014 http://geant4-dna.org \n\n
0015
0016 Any report or published results obtained using the Geant4-DNA software shall
0017 cite the following Geant4-DNA collaboration publications:\n
0018 Phys. Med. 31 (2015) 861-874 \n
0019 Med. Phys. 37 (2010) 4692-4708 \n\n
0020
0021 We also suggest these other references related to this example:\n
0022 Phys. Med. 63 (2019), 98-104 \n
0023 Med. Phys. 45 (2018), 2230-2242 \n
0024 J. App. Phys. 120 (2016), 244901 \n\n
0025
0026 The AuNP example simulates the track-structure of electrons
0027 in microscopic gold volume.The example also simulates that
0028 in liquid water medium surrunding the gold volume.
0029
0030 The details of the physics models are described in the following paper:
0031 J. Appl. Phys. 120 (2016) 244901
0032
0033 The details of the application are described in the following paper:
0034 Phys. Med. 63 (2019) 98-104
0035 Med. Phys. 45(5) (2018) 2230-2242
0036
0037 ## GEOMETRY SET-UP
0038
0039 The geometry is a sphere (World) made of liquid water containing a smaller
0040 sphererical target volume of Gold.
0041
0042 The default geometry is constructed in DetectorConstruction class.
0043
0044 ## PHYSICS LIST
0045
0046 The default physics list is constructed in PhysicsList class.
0047
0048 ## DETECTOR RESPONSE : Scorers
0049
0050 This scorer computes following quantities.
0051
0052 - the energy spectra of secondary particles generated in AuNP
0053 - the energy spectra of secondary particles at AuNP surface
0054 - the energy spectra of secondary particles generated in liquid water
0055 - the energy deposit and the position in the absorber surrunding AuNP
0056
0057 Run::RecordEvent(), called at end of event, collects informations
0058 event per event from the hits collections, and accumulates statistic for
0059 RunAction::EndOfRunAction().
0060
0061 In multi-threading mode the statistics accumulated per workers is merged
0062 to the master in Run::Merge().
0063
0064 The information is scored in a ROOT ntuple file AuNP.root.
0065
0066 ## HOW TO RUN THE EXAMPLE
0067
0068 This example shows:
0069 - how to use the Geant4-DNA processes for gold
0070 - how to count and save occurrences of processes
0071
0072 The code can be compiled with cmake.
0073 It works in MT mode.
0074
0075 Two user macro files can be used:
0076 ```
0077 ./AuNP AuNP.mac
0078 ```
0079
0080 ## SIMULATION OUTPUT AND RESULT ANALYSIS
0081
0082 The output results consists in an AuNP.root file, containing for the run:
0083 - the energy spectra of secondary particles generated in AuNP
0084 - the energy spectra of secondary particles at AuNP surface
0085 - the energy spectra of secondary particles generated in liquid water
0086 - the energy deposit and the position in the absorber surrounding AuNP
0087
0088 This file can be easily analyzed using for example the provided ROOT macro
0089 file plot.C. The plot.C is for for study of physics only.
0090 Make sure the chemistry is disactivated as "/chem/activate False".
0091
0092 to do so :
0093 - be sure to have ROOT installed on your machine
0094 - be sure to be in the build directory of the AuNP example
0095 - launch ROOT by typing root
0096 - under your ROOT session, type in: .X plot.C to execute the macro file
0097 - alternatively you can type directly under your session: root plot.C
