| 1 | <HTML>
|
|---|
| 2 | <TITLE>ADG: Introduction</TITLE>
|
|---|
| 3 | <!-- Changed by: Katsuya Amako, 4-Aug-1998 -->
|
|---|
| 4 | <!-- Changed by: Dennis Wright, 10-Dec-2001 -->
|
|---|
| 5 | <!-- Proof read by: Joe Chuma, 9-Jun-1999 -->
|
|---|
| 6 |
|
|---|
| 7 | <BODY>
|
|---|
| 8 | <TABLE WIDTH="100%"><TR>
|
|---|
| 9 | <TD>
|
|---|
| 10 |
|
|---|
| 11 |
|
|---|
| 12 | <A HREF="../index.html">
|
|---|
| 13 | <IMG SRC="../../../../resources/html/IconsGIF/Contents.gif" ALT="Contents"></A>
|
|---|
| 14 | <IMG SRC="../../../../resources/html/IconsGIF/PreviousGR.gif" ALT="Previous">
|
|---|
| 15 | <A HREF="../GettingStarted/index.html">
|
|---|
| 16 | <IMG BORDER="0" SRC="../../../../resources/html/IconsGIF/Next.gif" ALT="Next">
|
|---|
| 17 | </TD>
|
|---|
| 18 | <TD ALIGN="Right">
|
|---|
| 19 | <FONT SIZE="-1" COLOR="#238E23">
|
|---|
| 20 | <B>Geant4 User's Guide</B>
|
|---|
| 21 | <BR>
|
|---|
| 22 | <B>For Application Developers</B>
|
|---|
| 23 | </FONT>
|
|---|
| 24 | </TD>
|
|---|
| 25 | </TR></TABLE>
|
|---|
| 26 | <BR><BR>
|
|---|
| 27 |
|
|---|
| 28 | <P ALIGN="Center">
|
|---|
| 29 | <FONT SIZE="+3" COLOR="#238E23">
|
|---|
| 30 | <B>1. Introduction</B>
|
|---|
| 31 | </FONT>
|
|---|
| 32 | <BR><BR>
|
|---|
| 33 |
|
|---|
| 34 | <HR ALIGN="Center" SIZE="7%">
|
|---|
| 35 | <p>
|
|---|
| 36 |
|
|---|
| 37 | <H2>1.1 Scope of this manual</H2>
|
|---|
| 38 | The User's Guide for Application Developers is the first manual the reader
|
|---|
| 39 | should consult when learning about Geant4 or developing a Geant4-based
|
|---|
| 40 | detector simulation program. This manual is designed to:
|
|---|
| 41 | <UL>
|
|---|
| 42 | <LI>introduce the first-time user to the Geant4 object-oriented detector
|
|---|
| 43 | simulation toolkit,
|
|---|
| 44 | <LI>provide a description of the available tools and how to use them, and
|
|---|
| 45 | <LI>supply the practical information required to develop and run simulation
|
|---|
| 46 | applications which may be used in real experiments.
|
|---|
| 47 | </UL>
|
|---|
| 48 | This manual is intended to be an overview of the toolkit, rather than an
|
|---|
| 49 | exhaustive treatment of it. Related physics discussions are not included
|
|---|
| 50 | unless required for the description of a particular tool. Detailed
|
|---|
| 51 | discussions of the physics included in Geant4 can be found in the
|
|---|
| 52 | <a href="../../../PhysicsReferenceManual/html/PhysicsReferenceManual.html">Physics Reference
|
|---|
| 53 | Manual</a>. Details of the design and functionality of the Geant4 classes
|
|---|
| 54 | can be found in the
|
|---|
| 55 | <a href="../../../ForToolkitDeveloper/html/index.html">User's Guide for Toolkit Developers</a>, and a complete list of all Geant4 classes is given
|
|---|
| 56 | in the <a href="http://pcitapiww.cern.ch/asdcgi/geant4/SRM/G4GenDoc.csh?flag=1">Software
|
|---|
| 57 | Reference Manual</a>.
|
|---|
| 58 | <P>
|
|---|
| 59 | Geant4 is a completely new detector simulation toolkit written in the C++
|
|---|
| 60 | language. The reader is assumed to have a basic knowledge of
|
|---|
| 61 | object-oriented programming using C++. No knowledge of earlier FORTRAN
|
|---|
| 62 | versions of Geant is required. Although Geant4 is a fairly complicated
|
|---|
| 63 | software system, only a relatively small part of it needs to be understood
|
|---|
| 64 | in order to begin developing detector simulation applications.</P>
|
|---|
| 65 |
|
|---|
| 66 | <HR>
|
|---|
| 67 | <H2>1.2 How to use this manual</H2>
|
|---|
| 68 | A very basic introduction to Geant4 is presented in <b>Chapter 2, "Getting
|
|---|
| 69 | Started with Geant4 - Running a Simple Example"</b>. It is a recipe for
|
|---|
| 70 | writing and running a simple Geant4 application program. New users of
|
|---|
| 71 | Geant4 should read this chapter first. It is strongly recommended that this
|
|---|
| 72 | chapter be read in conjunction with a Geant4 system installed and running on
|
|---|
| 73 | your computer. It is helpful to run the provided examples as they are
|
|---|
| 74 | discussed in the manual. To install the Geant4 system on your computer,
|
|---|
| 75 | please refer to the
|
|---|
| 76 | <a href="../../../InstallationGuide/html/index.html">Installation Guide for
|
|---|
| 77 | Setting up Geant4 in Your Computing Environment</a>.
|
|---|
| 78 | <P>
|
|---|
| 79 | <b>Chapter 3, "Toolkit Fundamentals"</b> discusses general Geant4 issues
|
|---|
| 80 | such as class categories and the physical units system. It goes on to
|
|---|
| 81 | discuss runs and events, which are the basic units of a simulation.
|
|---|
| 82 | <P>
|
|---|
| 83 | <b>Chapter 4, "Detector Definition and Response"</b> describes how to
|
|---|
| 84 | construct a detector from customized materials and geometric shapes, and
|
|---|
| 85 | embed it in electromagnetic fields. It also describes how to make the
|
|---|
| 86 | detector sensitive to particles passing through it and how to store this
|
|---|
| 87 | information.
|
|---|
| 88 | <P>
|
|---|
| 89 | How particles are propagated through a material is treated in <b>Chapter
|
|---|
| 90 | 5, "Tracking and Physics"</b>. The Geant4 "philosophy" of particle
|
|---|
| 91 | tracking is presented along with summaries of the physics processes
|
|---|
| 92 | provided by the toolkit. The definition and implementation of Geant4
|
|---|
| 93 | particles is discussed and a list of particle properties is provided.
|
|---|
| 94 | <P>
|
|---|
| 95 | <b>Chapter 6, "User Actions"</b> is a description of the "user hooks" by which
|
|---|
| 96 | the simulation code may be customized to perform special tasks.
|
|---|
| 97 | <P>
|
|---|
| 98 | <b>Chapter 7, "Communication and Control"</b> provides a summary of the
|
|---|
| 99 | commands available to the user to control the execution of the simulation.
|
|---|
| 100 | After Chapter 2, Chapters 6 and 7 are of formeost importance to the new
|
|---|
| 101 | application developer.
|
|---|
| 102 | <P>
|
|---|
| 103 | The display of detector geometry, tracks and events may be incorporated into
|
|---|
| 104 | a simulation application by using the tools described in
|
|---|
| 105 | <b>Chapter 8, "Visualization"</b>.
|
|---|
| 106 | <P>
|
|---|
| 107 | <b>Chapter 9, "Examples"</b> provides a set of novice and advanced simulation
|
|---|
| 108 | codes which may be compiled and run "as is" from the Geant4 source code.
|
|---|
| 109 | These examples may be used as educational tools or as base code from which
|
|---|
| 110 | more complex applications are developed.
|
|---|
| 111 |
|
|---|
| 112 | <HR>
|
|---|
| 113 | <A HREF="../../../../Authors/html/subjectsToAuthors.html">
|
|---|
| 114 | <I>About the authors</I></A>
|
|---|
| 115 |
|
|---|
| 116 | </BODY>
|
|---|
| 117 | </HTML>
|
|---|
| 118 |
|
|---|
| 119 |
|
|---|
| 120 |
|
|---|
| 121 |
|
|---|
| 122 |
|
|---|
