Import Geant4 10.0.0 source tree

examples/basic/B3/.README

@@ -1,4 +1,4 @@
-//$Id$
+//$Id: .README 78001 2013-12-02 08:24:53Z gcosmo $
 
 ///\file "B3/.README"
 ///\brief Example B3 README page
@@ -42,10 +42,27 @@
      the G4RADIOACTIVEDATA envirnoment variable.
  	 
    See more on installation of the datasets in
-   <a href="http://geant4.web.cern.ch/geant4/UserDocumentation/UsersGuides/InstallationGuide/html/ch03s03.html">
+   <a href="http://geant4.web.cern.ch/geant4/UserDocumentation/UsersGuides
+                                         /InstallationGuide/html/ch03s03.html">
    Geant4 Installation Guide, Chapter 3.3: Note On Geant4 Datasets </a>.
+   
+\section B3_s3  ACTION INITALIZATION
 
-\section B3_s3 PRIMARY GENERATOR
+   A newly introduced class, B1ActionInitialization, instantiates and registers 
+   to Geant4 kernel all user action classes.
+
+   While in sequential mode the action classes are instatiated just once,
+   via invoking the method:
+      B3ActionInitialization::Build() 
+   in multi-threading mode the same method is invoked for each thread worker
+   and so all user action classes are defined thread-local.
+
+   A run action class is instantiated both thread-local 
+   and global that's why its instance is created also in the method
+      B3ActionInitialization::BuildForMaster() 
+   which is invoked only in multi-threading mode.
+     
+\section B3_s4 PRIMARY GENERATOR
 
    The default particle beam is an ion (F18), at rest, randomly distributed 
    within a zone inside a patient and is defined in 
@@ -53,22 +70,25 @@
    The type of a primary particle can be changed with G4ParticleGun commands 
    (see run2.mac).
    
-\section B3_s4 DETECTOR RESPONSE : scorers
+\section B3_s5 DETECTOR RESPONSE : scorers
 
    A 'good' event is an event in which an identical energy of 511 keV is 
    deposited in two separate Crystals. A count of the number of such events 
    corresponds to a measure of the efficiency of the PET system. 
    The total dose deposited in a patient during a run is also computed. 
    
-   Scorers are defined in DetectorConstruction::CreateScorers(). There are
+   Scorers are defined in DetectorConstruction::ConstructSDandField(). There are
    two G4MultiFunctionalDetector objects: one for the Crystal (EnergyDeposit), 
    and one for the Patient (DoseDeposit)
 	
-   EventAction::EndOfEventAction() collects informations event per event
+   B3Run::RecordEvent() collects informations event per event
    from the hits collections, and accumulates statistic for 
    RunAction::EndOfRunAction().	
+   
+   In multi-threading mode the statistics accumulated per workers is merged 
+   to the master in Run::Merge().
    	
-\section B3_s5 STACKING ACTION
+\section B3_s6 STACKING ACTION
 
    Beta decay of Fluor generates a neutrino. One wishes not to track this
    neutrino; therefore one kills it immediately, before created particles