| 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 | |
|---|
