[904] | 1 | <!-- ******************************************************** --> |
---|
| 2 | <!-- Docbook Version: For Toolkit Developers Guide --> |
---|
| 3 | <!-- ******************************************************** --> |
---|
| 4 | |
---|
| 5 | <!-- ******************* Section (Level#1) ****************** --> |
---|
| 6 | <sect1 id="sect.DsgnFuncParti"> |
---|
| 7 | <title> |
---|
| 8 | Particles |
---|
| 9 | </title> |
---|
| 10 | |
---|
| 11 | |
---|
| 12 | <!-- ******************* Section (Level#2) ****************** --> |
---|
| 13 | <sect2 id="sect.DsgnFuncParti.DsgPhlsp"> |
---|
| 14 | <title> |
---|
| 15 | Design Philosophy |
---|
| 16 | </title> |
---|
| 17 | |
---|
| 18 | <para> |
---|
| 19 | The particles category implements the facilities necessary to describe the |
---|
| 20 | physical properties of particles for the simulation of particle-matter |
---|
| 21 | interactions. All particles are based on the |
---|
| 22 | <emphasis role="italic"></emphasis>G4ParticleDefinition class, |
---|
| 23 | which describes basic properties such as mass, charge, etc., and also allows |
---|
| 24 | the particle to carry a list of processes to which it is sensitive. A |
---|
| 25 | first-level extension of this class defines the interface for particles that |
---|
| 26 | carry cuts information, for example range cut versus energy cut equivalence. |
---|
| 27 | A set of virtual, intermediate classes for leptons, bosons, mesons, baryons, |
---|
| 28 | etc., allows the implementation of concrete particle classes which define the |
---|
| 29 | actual particle properties and, in particular, implement the actual range |
---|
| 30 | versus energy cuts equivalence. All concrete particle classes are |
---|
| 31 | instantiated as singletons to ensure that all physics processes refer to the |
---|
| 32 | same particle properties. |
---|
| 33 | </para> |
---|
| 34 | |
---|
| 35 | </sect2> |
---|
| 36 | |
---|
| 37 | <!-- ******************* Section (Level#2) ****************** --> |
---|
| 38 | <sect2 id="sect.DsgnFuncParti.ClassDsg"> |
---|
| 39 | <title> |
---|
| 40 | Class Design |
---|
| 41 | </title> |
---|
| 42 | |
---|
| 43 | <para> |
---|
| 44 | The object-oriented design of the 'particles' related classes |
---|
| 45 | is shown in the following class diagrams. The diagrams are |
---|
| 46 | described in the Booch notation. |
---|
| 47 | <xref linkend="fig.DsgnFuncParti_1" /> shows a general overview of the particle |
---|
| 48 | classes. |
---|
| 49 | <xref linkend="fig.DsgnFuncParti_2" /> shows classes related to the |
---|
| 50 | particle table. <xref linkend="fig.DsgnFuncParti_3" /> shows the classes related |
---|
| 51 | to the particle decay table. |
---|
| 52 | </para> |
---|
| 53 | |
---|
| 54 | <figure id="fig.DsgnFuncParti_1"> |
---|
| 55 | <title> |
---|
| 56 | Particle classes |
---|
| 57 | </title> |
---|
| 58 | <mediaobject> |
---|
| 59 | <imageobject role="fo"> |
---|
[921] | 60 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticlesMain.jpg" |
---|
| 61 | format="JPG" contentwidth="10.0cm" align="center" /> |
---|
[904] | 62 | </imageobject> |
---|
| 63 | <imageobject role="html"> |
---|
[921] | 64 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticlesMain.jpg" |
---|
[1208] | 65 | format="JPG" contentwidth="120%" align="center" /> |
---|
[904] | 66 | </imageobject> |
---|
| 67 | </mediaobject> |
---|
| 68 | </figure> |
---|
| 69 | |
---|
| 70 | |
---|
| 71 | <figure id="fig.DsgnFuncParti_2"> |
---|
| 72 | <title> |
---|
| 73 | Particle Table |
---|
| 74 | </title> |
---|
| 75 | <mediaobject> |
---|
| 76 | <imageobject role="fo"> |
---|
[921] | 77 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleTable.jpg" |
---|
| 78 | format="JPG" contentwidth="10.0cm" align="center" /> |
---|
[904] | 79 | </imageobject> |
---|
| 80 | <imageobject role="html"> |
---|
[921] | 81 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleTable.jpg" |
---|
[1208] | 82 | format="JPG" contentwidth="120%" align="center" /> |
---|
[904] | 83 | </imageobject> |
---|
| 84 | </mediaobject> |
---|
| 85 | </figure> |
---|
| 86 | |
---|
| 87 | |
---|
| 88 | <figure id="fig.DsgnFuncParti_3"> |
---|
| 89 | <title> |
---|
| 90 | Particle Decay Table |
---|
| 91 | </title> |
---|
| 92 | <mediaobject> |
---|
| 93 | <imageobject role="fo"> |
---|
[921] | 94 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleDecay.jpg" |
---|
| 95 | format="JPG" contentwidth="10.0cm" align="center" /> |
---|
[904] | 96 | </imageobject> |
---|
| 97 | <imageobject role="html"> |
---|
[921] | 98 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleDecay.jpg" |
---|
[1208] | 99 | format="JPG" contentwidth="120%" align="center" /> |
---|
[904] | 100 | </imageobject> |
---|
| 101 | </mediaobject> |
---|
| 102 | </figure> |
---|
| 103 | |
---|
| 104 | <!-- ******* Bridgehead ******* --> |
---|
| 105 | <bridgehead role="revisionHistory" renderas="sect4"> |
---|
| 106 | [Status of this chapter] |
---|
| 107 | </bridgehead> |
---|
| 108 | <para> |
---|
| 109 | <simplelist type="var"> |
---|
| 110 | <member> |
---|
| 111 | 27.06.05 section on design philosophy added (from Geant4 general paper) by |
---|
| 112 | D.H. Wright |
---|
| 113 | </member> |
---|
| 114 | <member> |
---|
| 115 | Dec. 2006 Conversion from latex to Docbook verson by K. Amako |
---|
| 116 | </member> |
---|
| 117 | </simplelist> |
---|
| 118 | </para> |
---|
| 119 | |
---|
| 120 | |
---|
| 121 | </sect2> |
---|
| 122 | </sect1> |
---|
| 123 | |
---|
| 124 | |
---|
| 125 | |
---|