Import Geant4 10.5.0 source tree

examples/basic/B3/README

@@ -1,4 +1,3 @@
-$Id: README 99559 2016-09-27 07:02:21Z gcosmo $
 -------------------------------------------------------------------
 
      =========================================================
@@ -85,6 +84,10 @@ $Id: README 99559 2016-09-27 07:02:21Z gcosmo $
    two G4MultiFunctionalDetector objects: one for the Crystal (EnergyDeposit), 
    and one for the Patient (DoseDeposit)
 
+   The scorers hits are saved in form of ntuples in a Root file using Geant4 
+   analysis tools. This feature is activated in the main () function with instantiating
+   G4ScoreNtupleWriter. 
+
    Two variants of accumulation event statistics in a run are demonstrated 
    in this example:
 
@@ -108,6 +111,15 @@ $Id: README 99559 2016-09-27 07:02:21Z gcosmo $
    B3bRun::RecordEvent(), called at end of event, collects informations 
    event per event from the hits collections, and accumulates statistic for 
    B3bRunAction::EndOfRunAction().	
+   In addition, results for dose are accumulated in a
+   standard floating-point summation and using a new lightweight statistical
+   class called G4StatAnalysis. The G4StatAnalysis class records four values:
+   (1) the sum, (2) sum^2, (3) number of entries, and (4) the number of entries
+   less than mean * machine-epsilon (the machine epsilon is the difference
+   between 1.0 and the next value representable by the floating-point type).
+   From these 4 values, G4StatAnalysis provides the mean, FOM, relative error,
+   standard deviation, variance, coefficient of variation, efficiency, r2int,
+   and r2eff.
    
    In multi-threading mode the statistics accumulated per workers is merged 
    to the master in B3bRun::Merge().
@@ -170,7 +182,7 @@ $Id: README 99559 2016-09-27 07:02:21Z gcosmo $
 C- HOW TO RUN
 
     - Execute exampleB3a in the 'interactive mode' with visualization
-        % exampleB3a
+        % ./exampleB3a
       and type in the commands from run1.mac line by line:  
         Idle> /control/verbose 2
         Idle> /tracking/verbose 2
@@ -184,7 +196,7 @@ C- HOW TO RUN
 
     - Execute exampleB3a in the 'batch' mode from macro files 
      (without visualization)
-        % exampleB3a run2.mac
-        % exampleB3a exampleB3.in > exampleB3.out
+        % ./exampleB3a run2.mac
+        % ./exampleB3a exampleB3.in > exampleB3.out