Import Geant4 9.6.0 source tree

examples/extended/hadronic/Hadr02/README

@@ -5,26 +5,35 @@
 
                                HADR02
 
-		     V.Ivanchenko, A.Ivanchenko
+		     Example and DMJET: V.Ivanchenko, A.Ivanchenko, 
+		     UrQMD: Kh Abdel-Waged et al, A. Dotti
                        CERN, Geneva, Switzerland
         	     Geant4 Associate International
 		University of Bordeaux, CENBG/IN2P3/CNRS
                      (ESA contract 22712/09/NL/AT)
 
 
-This example application iproviding simulation of ion beam interaction with different 
-targets. Hadronic aspects of beam target interaction are demonstrating in the example 
+This example application is providing simulation of ion beam interaction with different 
+targets. Hadronic aspects of beam target interaction are demonstrated in the example 
 including longitudinal profile of energy deposition, spectra of secondary  particles,
 isotope production spectra. The results are presenting in a form of average numbers 
 and histograms. All ion/ion models of Geant4 are available and also the interface to
 the FORTRAN code DPMJET-2.5 developed by J.Ranft for FLUKA. The interface was developed
-by P.Truscott (QinetiQ, UK) under European Space Agency (ESA) contract 19770/06/NL/JD. 
+by P.Truscott (QinetiQ, UK) under European Space Agency (ESA) contract 19770/06/NL/JD.
+In addition an interface to the FORTRAN code UrQMD-1.3rc developed by Kh, Abdel-Waged et al
+for the KACST/NCMP. UrQMD model by S.A.Bass et al. Prog.Part.Nucl.Phys. 41 (1998) 225
+and M.Bleicher et al. J.Phys. G25 (1999) 1859.
+UrQMD can be used only for ion-ion physics or for all hadronic inelastic interactions.
 
 
 	                  INSTALLATION
 
 For simulation with Geant4 native models installation procedure is the same as for 
-other examples. In order to use DPMJET additional installation steps are required.
+other examples.
+
+			  ACTIVATION OF DPMJET INTERFACE
+
+In order to use DPMJET additional installation steps are required.
 It is recommended to use DPMJET with SLC5 64 bit PC with gcc4.3.2 or newer compiler. 
 
 Two environment variables should be defined:
@@ -35,7 +44,7 @@ Two environment variables should be defined:
 
 To run the example with DPMJET:
 
-  	$G4WORKDIR/bin/Linux-g++/hadr02 dpmjet.in QGSP_BIC
+  	Hadr02 dpmjet.in QGSP_BIC
 
 The last parameter is optional. It is the name of Geant4 reference Physics List on
 top of which a new ion physics is added. Alternatively Physics List can be defined via 
@@ -43,6 +52,42 @@ environment variable
 
         setenv PHYSLIST QGSP_BIC
 
+			   ACTIVATION OF URQMD INTERFACE
+
+UrQMD 1.3 FORTRAN code is NOT provided with Geant4 code-base.
+You can get UrQMD code from UrQMD code website: http://urqmd.org
+The Geant4 interface has been developed and tested against urqmd-1.3cr
+Once the tarball urqmd-1.3cr.tar.gz has been downloaded copy it in the 
+urqmd1_3 directory of this example.
+To compile support for UrQMD interface in the example define the environment
+variable G4_USE_URQMD. i.e. by typing:
+
+	setenv G4_USE_URQMD 1
+
+Two possible uses of UrQMD interface are possible: use UrQMD code only for
+ion-ion interactions or use the provided UrQMD physics list (all hadron inelastic interactions
+use UrQMD).
+To run the example with UrQMD only for ion-ion physics:
+
+	Hadr02 urqmd.in QGSP_BIC
+
+The last parameter is optional. It is the name of Geant4 reference Physics List on
+top of which a new ion physics is added. Alternatively Physics List can be defined via 
+environment variable
+
+        setenv PHYSLIST QGSP_BIC
+
+To run the examplw with the full UrQMD physics:
+
+	Hadr02 default.in UrQMD
+or:
+	setenv PHYSLIST UrQMD
+	Hadr02 default.in
+
+UrQMD physics list can be used in any application, releavant headers and source files (*UrQDM*)
+should be copied in your application source tree, together with the urqmd1_3 sub-directory.
+Your application makefile should also be modified following the example of the makefile for this 
+example.
 
                            GEOMETRY