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"> |
---|
60 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticlesMain.jpg" |
---|
61 | format="JPG" contentwidth="10.0cm" align="center" /> |
---|
62 | </imageobject> |
---|
63 | <imageobject role="html"> |
---|
64 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticlesMain.jpg" |
---|
65 | format="JPG" align="center" /> |
---|
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"> |
---|
77 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleTable.jpg" |
---|
78 | format="JPG" contentwidth="10.0cm" align="center" /> |
---|
79 | </imageobject> |
---|
80 | <imageobject role="html"> |
---|
81 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleTable.jpg" |
---|
82 | format="JPG" align="center" /> |
---|
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"> |
---|
94 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleDecay.jpg" |
---|
95 | format="JPG" contentwidth="10.0cm" align="center" /> |
---|
96 | </imageobject> |
---|
97 | <imageobject role="html"> |
---|
98 | <imagedata fileref="./AllResources/OOAnalysisDesign/Particles/classDgmParticleDecay.jpg" |
---|
99 | format="JPG" align="center" /> |
---|
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 | |
---|