Documentation, examples and user support

Transcription

1 Documentation, examples and user support Makoto Asai (SLAC PPA/SCA) November 12th, 2014 Geant4 ANS Winter Meeting 2014

2 Geant4 User Documenta0on Four manuals distributed at every Geant4 release Installa0on Guide Applica0on Developer s Guide Toolkit Developer s Guide Physics Reference Manual Many validated examples of varying complexity Basic Examples: core components of toolkit Extended Examples: extensions, configura0on op0ons Advanced Examples: complete prac0cal applica0ons Online discussion forums for users and collaborators

3 Geant4 User Documenta0on The four Users Guides are generally updated and published at the same 0me as the toolkit is released. userdocuments.shtml! All four Users Guides are available as PDF documents (some of them quite long). The Installa'on, Applica'on and Toolkit Guides are also available in HTML form, broken into chapters.

4 Geant4 User Documenta0on

5 Applica0on Developer s Guide The Applica'on Developer s Guide covers all of the classes, and all of the sosware categories, you might need when wri0ng your own user applica0on. Geometry: shapes, materials, and structure Physics processes and physics lists Genera0ng par0cles for events User ac0ons: customizing the event loop Collec0ng data during events User interface: macros and commands Visualiza0on

6 Toolkit Developer s Guide and Physics Reference Manual The Toolkit Developer s Guide covers the design philosophy and organiza0on of the toolkit, with informa0on useful to both Geant4 collabora0on members and users who want to add new features not available in the distribu0on. Defining special purpose solids for complex geometries Crea0ng new physics processes or models Crea0ng run or event managers with special features The Toolkit Developer s Guide is currently being revised to provide more complete and up to date guidance. The Physics Reference Manual provides a detailed summary of the physics implemented in each of the processes and models (EM, hadronic, and op0cal) with references to the source publica0ons.

7 Geant4 Example Applica0ons As part of the toolkit distribu0on, Geant4 provides an extensive set of examples covering a wide range of complexity. Basic: complete applica0ons demonstra0ng simple features of toolkit, useful for tutorial purposes Extended: demonstrate specific, more complex use cases; some require use of external (non- Geant4) libraries Advanced: complex, experiment- level applica0ons with complex geometries and physics focused on par0cular user communi0es Documenta0on is in README files and Web pages

8 Basic Examples Example B1 Few simple solids, simple placements Scoring total dose in a selected volume user action classes Example B2 Magnetic field, parametrised placements Scoring within tracker via G4 sensitive detector and hits Geant4 physics list (FTFP_BERT) with step limiter Example B3 (Schematic PET system) Simple placements with rotations Scoring within Crystals via G4 scorers Radioactive source, modular physics list using builders Example B4 (Layered calorimeter) Geometry with replicas (G4PVReplica) Multiple scoring methods Histograms (1D) and ntuple saved in the output file Example B5 (Double-arm spectrometer) Complex geometry with rotation, replicas and parametrisation Scoring within multiple volumes via G4 sensitive detector and hits Local UI commands defined using G4GenericMessenger Histograms (1D, 2D) and ntuple saved in the output file

9 Extended Examples analysis biasing common Histogramming through G4tools Examples of event biasing, scoring and reverse- MC A set of common classes which can be reused in other extended examples demonstraang just a paracular feature electromagneac errorpropagaaon eventgenerator Specific EM physics simulaaon with histogramming Use of the error propagaaon uality (Geant4e) ApplicaAons demonstraang various ways of primary event generaaon: using Geant4 paracle gun, Geant4 general paracle source, using interface to HepMC, Pythia

10 Extended Examples (con0nued) exoacphysics field g3tog4 geometry hadronic medical opacal parallel parameterisaaon ExoAc simulaaon applicaaons (classical magneac monopole, phonon, etc...) Specific simulaaon setups in magneac field Examples of usage of the g3tog4 converter tool Specific geometry examples and tools Specific hadronic physics simulaaon with histogramming Specific examples for medical physics applicaaons Examples of generic opacal processes simulaaon setups Examples of event- level parallelism in Geant4 using the TOP- C distribuaon, and TBB and MPI techniques Examples for fast shower parameterisaaons according to specific models (gflash)

11 Extended Examples (con0nued) persistency polarisaaon radioacavedecay Persistency of geometry (GDML or ASCII) and simulaaon output Use of physics processes including polarizaaon Examples to simulate the decays of radioacave isotopes and induced radioacavity resulted from nuclear interacaons runandevent Examples to demonstrate Geant4 kernels, i.e. run and event categories, and sensiave detector and scoring funcaonaliaes visualizaaon Specific visualizaaon features and graphical customisaaons

12 Advanced Examples amsecal Brachytherapy ChargeExchangeMC Composite calorimeter Dnaphysics SimulaAon of an ElectromagneAc calorimeter allowing precise and three dimensional imaging of a lateral and longitudinal shower development Dosimetry for endocavitary, intersaaal and superficial brachytherapy SimulaAon of charge exchange real experiment performed at the Petesburg Nuclear Physics InsAtute (PNPI, Russia) A composite electromagneac and hadronic calorimeter, similar to a CMS test beam set- up SimulaAon of a track structure in liquid water using the Geant4 DNA very low energy processes

13 Advanced Examples (con0nued) Dnageometry SimulaAon of a realisac cell nucleus, including DNA content erosita PIXE simulaaon with Geant4? Gamma- knife Gamma- ray telescope Hadrontherapy A device for StereotacAc Radiosurgery with Co60 sources for treatment of cerebral diseases A simplified typical gamma- ray telescope (such as GLAST), with advanced descripaon of the detector response SimulaAon of a transport beam line for proton and ion therapy Human_phantom iort_therapy

14 Advanced Examples (con0nued) Medical Linac Microbeam Microdosimetry Microelectronics Nanobeam Purging magnet RadioprotecAon A typical LINAC accelerator for IMRT, simular to one used in the clinical pracace SimulaAon of a cellular irradiaaon microbeam line using a high resoluaon cellular phantom CombinaAon of Geant4 EM processes with Geant4- DNA processes CombinaAon of Geant4 EM processes with G4MicroElec processes SimulaAon of a nanobeam line facility Electrons traveling through the magneac field of a strong purging magnet in a radiotherapy treatment head Dose distribuaons in interplanetary space radiaaon enviroment, for the radioprotecaon of astronauts in space vehicles and planetary habitat.

15 Advanced Examples (con0nued) RICH Underground physics X- ray fluorescence X- ray telescope A RICH detector in a set- up similar to the LHCb test beam A simplified typical dark ma]er detector (such as the Boulby Mine experiment) Elemental composiaon of material samples through X- ray fluorescence spectra A simplified typical X- ray telescope (such as XMM- Newton or Chandra)

16 Hypernews Discussion Forums Mul0ple topical sec0ons for discussion among users and between users and Geant4 developers geant4/cindex!

17 LXR Source Code Browser A Web interface to all of the Geant4 source code is available through KEK Code selectable by release number Annotated: headers, classes, func0ons hyperlinks A Doxygen generated interface is also available, but not all code has necessary annota0ons

18 Following up Please keep maintaining your Geant4 installation updated. Irregular patch releases may be more important than regular releases. Check our web page regularly to find release news, or register to Geant4 announcement mailing list.

19 Following up If you have a question 1. Look for our documents. Users guides, Twiki pages, tips pages, examples and their READMEs 2. Post your question on Geant4 HyperNews Please make sure to do a bit of survey that no one has already asked the same question before. 3. As the final method, write us a mail. Avoid anonymous mail account such as hotmail, gmail, etc., if possible. 4. Or, catch us at meetings/conferences. Apologies if we cannot recognize you

20 Past tutorials