1 | <!-- ******************************************************** --> |
---|
2 | <!-- --> |
---|
3 | <!-- [History] --> |
---|
4 | <!-- Changed by: Katsuya Amako, 4-Aug-1998 --> |
---|
5 | <!-- Changed by: Dennis Wright, 10-Dec-2001 --> |
---|
6 | <!-- Proof read by: Joe Chuma, 9-Jun-1999 --> |
---|
7 | <!-- Converted to DocBook: Katsuya Amako, Aug-2006 --> |
---|
8 | <!-- --> |
---|
9 | <!-- ******************************************************** --> |
---|
10 | |
---|
11 | |
---|
12 | <!-- ******************* Section (Level#1) ****************** --> |
---|
13 | <sect1 id="sect.scope"> |
---|
14 | <title> |
---|
15 | Scope of this manual |
---|
16 | </title> |
---|
17 | |
---|
18 | <para> |
---|
19 | The User's Guide for Application Developers is the first manual the |
---|
20 | reader should consult when learning about Geant4 or developing a |
---|
21 | Geant4-based detector simulation program. This manual is designed |
---|
22 | to: |
---|
23 | </para> |
---|
24 | |
---|
25 | <itemizedlist spacing="compact"> |
---|
26 | <listitem><para> |
---|
27 | introduce the first-time user to the Geant4 object-oriented |
---|
28 | detector simulation toolkit, |
---|
29 | </para></listitem> |
---|
30 | <listitem><para> |
---|
31 | provide a description of the available tools and how to use |
---|
32 | them, and |
---|
33 | </para></listitem> |
---|
34 | <listitem><para> |
---|
35 | supply the practical information required to develop and run |
---|
36 | simulation applications which may be used in real experiments. |
---|
37 | </para></listitem> |
---|
38 | </itemizedlist> |
---|
39 | |
---|
40 | <para> |
---|
41 | This manual is intended to be an overview of the toolkit, rather |
---|
42 | than an exhaustive treatment of it. Related physics discussions are |
---|
43 | not included unless required for the description of a particular |
---|
44 | tool. Detailed discussions of the physics included in Geant4 can be |
---|
45 | found in the |
---|
46 | <ulink url="http://cern.ch/geant4/support/userdocuments.shtml"> |
---|
47 | Physics Reference Manual</ulink>. |
---|
48 | Details of the design and functionality of the Geant4 classes can be found in the |
---|
49 | <ulink url="http://cern.ch/geant4/support/userdocuments.shtml"> |
---|
50 | User's Guide for Toolkit Developers</ulink>, and a complete list of |
---|
51 | all Geant4 classes is given in the |
---|
52 | <ulink url="http://geant4.cern.ch/bin/SRM/G4GenDoc.csh?flag=1"> |
---|
53 | Software Reference Manual</ulink>. |
---|
54 | </para> |
---|
55 | |
---|
56 | <para> |
---|
57 | Geant4 is a completely new detector simulation toolkit written |
---|
58 | in the C++ language. The reader is assumed to have a basic |
---|
59 | knowledge of object-oriented programming using C++. No knowledge of |
---|
60 | earlier FORTRAN versions of Geant is required. Although Geant4 is a |
---|
61 | fairly complicated software system, only a relatively small part of |
---|
62 | it needs to be understood in order to begin developing detector |
---|
63 | simulation applications. |
---|
64 | </para> |
---|
65 | |
---|
66 | </sect1> |
---|
67 | |
---|
68 | <!-- ****************** Section (Level#1) **************************** --> |
---|
69 | <sect1 id="sect.howto"> |
---|
70 | <title> |
---|
71 | How to use this manual |
---|
72 | </title> |
---|
73 | |
---|
74 | <para> |
---|
75 | A very basic introduction to Geant4 is presented in |
---|
76 | <emphasis role="bold">Chapter 2, "Getting Started with Geant4 - |
---|
77 | Running a Simple Example"</emphasis>. |
---|
78 | It is a recipe for writing and running a simple Geant4 application |
---|
79 | program. New users of Geant4 should read this chapter first. It is |
---|
80 | strongly recommended that this chapter be read in conjunction with |
---|
81 | a Geant4 system installed and running on your computer. It is |
---|
82 | helpful to run the provided examples as they are discussed in the |
---|
83 | manual. To install the Geant4 system on your computer, please refer |
---|
84 | to the |
---|
85 | <ulink |
---|
86 | url="http://cern.ch/geant4/support/userdocuments.shtml"> |
---|
87 | Installation Guide for Setting up Geant4 in Your Computing Environment</ulink>. |
---|
88 | </para> |
---|
89 | |
---|
90 | <para> |
---|
91 | <emphasis role="bold">Chapter 3, "Toolkit Fundamentals"</emphasis> |
---|
92 | discusses generalGeant4 issues such as class categories and the physical |
---|
93 | units system. It goes on to discuss runs and events, which are the basic |
---|
94 | units of a simulation. |
---|
95 | </para> |
---|
96 | |
---|
97 | <para> |
---|
98 | <emphasis role="bold">Chapter 4, "Detector Definition and Response"</emphasis> |
---|
99 | describes how to construct a detector from customized materials and geometric |
---|
100 | shapes, and embed it in electromagnetic fields. It also describes |
---|
101 | how to make the detector sensitive to particles passing through it |
---|
102 | and how to store this information. |
---|
103 | </para> |
---|
104 | |
---|
105 | <para> |
---|
106 | How particles are propagated through a material is treated in |
---|
107 | <emphasis role="bold">Chapter 5, "Tracking and Physics"</emphasis>. |
---|
108 | The Geant4 "philosophy" of particle tracking is presented along with |
---|
109 | summaries of the physics processes provided by the toolkit. The definition |
---|
110 | and implementation of Geant4 particles is discussed and a list of |
---|
111 | particle properties is provided. |
---|
112 | </para> |
---|
113 | |
---|
114 | <para> |
---|
115 | <emphasis role="bold">Chapter 6, "User Actions"</emphasis> is a description |
---|
116 | of the "user hooks" by which the simulation code may be customized to perform |
---|
117 | special tasks. |
---|
118 | </para> |
---|
119 | |
---|
120 | <para> |
---|
121 | <emphasis role="bold">Chapter 7, "Communication and Control"</emphasis> |
---|
122 | provides a summary of the commands available to the user to control the |
---|
123 | execution of the simulation. After Chapter 2, Chapters 6 and 7 are of formeost |
---|
124 | importance to the new application developer. |
---|
125 | </para> |
---|
126 | |
---|
127 | <para> |
---|
128 | The display of detector geometry, tracks and events may be incorporated |
---|
129 | into a simulation application by using the tools described in |
---|
130 | <emphasis role="bold">Chapter 8, "Visualization"</emphasis>. |
---|
131 | </para> |
---|
132 | |
---|
133 | <para> |
---|
134 | <emphasis role="bold">Chapter 9, "Examples"</emphasis> provides a set of |
---|
135 | novice and advanced simulation codes which may be compiled and run "as is" |
---|
136 | from the Geant4 source code. These examples may be used as |
---|
137 | educational tools or as base code from which more complex |
---|
138 | applications are developed. |
---|
139 | </para> |
---|
140 | |
---|
141 | </sect1> |
---|