[904] | 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 |
---|
[1211] | 46 | <ulink url="http://cern.ch/geant4/support/userdocuments.shtml"> |
---|
[904] | 47 | Physics Reference Manual</ulink>. |
---|
| 48 | Details of the design and functionality of the Geant4 classes can be found in the |
---|
[1211] | 49 | <ulink url="http://cern.ch/geant4/support/userdocuments.shtml"> |
---|
[904] | 50 | User's Guide for Toolkit Developers</ulink>, and a complete list of |
---|
| 51 | all Geant4 classes is given in the |
---|
[1211] | 52 | <ulink url="http://geant4.cern.ch/bin/SRM/G4GenDoc.csh?flag=1"> |
---|
[904] | 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 |
---|
[1211] | 86 | url="http://cern.ch/geant4/support/userdocuments.shtml"> |
---|
[904] | 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> |
---|