//$Id$

///\file "hadronic/Hadr07/.README.txt"
///\brief Example Hadr07 README page

/*! \page ExampleHadr07 Example Hadr07

   Survey energy deposition and particle's flux from an hadronic cascade.
   Use PhysicsConstructor objects rather than predefined G4 PhysicsLists.
   How to plot a depth dose profile in a rectangular box.    

\section Hadr07_s1 MATERIALS AND GEOMETRY DEFINITION

  The geometry consists of a stack of one or several blocks of homogenous
  material, called absorbers.

  A minimum of 4 parameters define the geometry :
     - the number of absorbers (NbOfAbsor)	
     - the material of each absorber,
     - the thickness of each absorber,
     - the tranverse dimension of the stack (sizeYZ)

  In addition a transverse uniform magnetic field can be applied.
      eg: /globalField/setValue 0 0 5 tesla

  The absorber is surrounded by a World volume (vacuum)

  A function, and its associated UI command, allows to build a material
  directly from a single isotope.

  The default geometry is built in DetectorConstruction, but the above parameters 
  can be changed interactively via commands defined in DetectorMessenger.

  To be identified by the ThermalScattering module, the elements composing a
  material must have a specific name (see G4ParticleHPThermalScatteringNames.cc)
  Examples of such materials are build in Hadr06/src/DetectorConstruction.
 	
\section Hadr07_s2 PHYSICS LIST
   
  "Full" set of physics processes are registered, but via PhysicsConstructor
  objects rather than complete pre-defined G4 physics lists. This alternative 
  way gives more freedom to register physics.
  
  PhysicsConstructors are either predefined G4 PhysicsConstructors or 'local'. 
  They include : HadronElastic (including neutronHP), HadronInelastic,
  IonsInelastic, GammaNuclear physics, RadioactiveDecay and Electomagnetic physics.
  (see geant4/source/physics_lists/constructors)
  
  ElectromagneticPhysics is a variante of EmStandard. No step constraint is imposed for 
  energy loss mechanism (ionisation and brems). This is enough when spatial distribution
  of deposited energy do not need to be accurate.
  (see param->SetStepFunction(1., 1*mm))
  
  Several hadronic physics options are controlled by environment variables.
  To trigger them, an envHadronic.csh has been added in this example.
  One must select the options wished, and do
\verbatim
        source envHadronic.csh  (or sh)
\endverbatim

\section Hadr07_s3 AN EVENT : THE PRIMARY GENERATOR

  The primary kinematic consists of a single particle starting at the
  left face of the box. The type of the particle and its energy are set 
  in the PrimaryGeneratorAction class, and can be changed via the G4 
  build-in commands of G4ParticleGun class (see the macros provided with 
  this example).

  In addition one can choose randomly the impact point of the incident
  particle. The corresponding interactive command is built in
  PrimaryGeneratorMessenger class.

 A RUN is a set of events.
 
\section Hadr07_s4 PHYSICS

  The program computes the energy deposited in each absorber,
  and the flux of particles emerging in the world.
  Processes invoked and particles generated are listed.

\section Hadr07_s5 HISTOGRAMS
         
  The test has several built-in 1D histograms, which are managed by
  G4AnalysisManager and its Messenger. The histos can be individually 
  activated with the command :
\verbatim
  /analysis/h1/set id nbBins  valMin valMax unit
\endverbatim
  where unit is the desired unit for the histo (MeV or keV, etc..)
  (see the macros xxxx.mac).

            1     "total energy deposited in absorber 1
            2     "total energy deposited in absorber 2
            ...........................................
            9     "total energy deposited in absorber 9
            10    "Edep (MeV/mm) profile along absorbers"
   
  One can control the name of the histograms file with the command:
\verbatim
  /analysis/setFileName  name  (default Hadr07)
\endverbatim

  It is possible to choose the format of the histogram file : root (default),
  xml, csv, by using namespace in HistoManager.hh

  It is also possible to print selected histograms on an ascii file:
\verbatim
  /analysis/h1/setAscii id
\endverbatim
  All selected histos will be written on a file name.ascii (default Hadr07) 
  
\section Hadr07_s6 TRACKING and STEP MAX
 
  Hadr07 computes the distribution of energy deposited along the trajectory of 
  the incident particle : the so-called longitudinal energy profile,
  or depth dose distribution (histogram 10).
  The energy deposited (edep) is randomly distribued along the step (see
  SteppingAction).
  
  In order to control the accuracy of the deposition, the maximum  step size 
  of charged particles is computed automatically from the binning of 
  histogram 10.
     
  As an example, this limitation is implemented as a 'full' process :
  see StepMax class and its Messenger. The 'StepMax process' is registered
  in the Physics List, via a physicsConstructor object (a builder).
     
  StepMax is evaluated in the StepMax process. 
  A boolean UI command allows to deactivate this mechanism.
  Another UI command allows to define directly a stepMax value.

\section Hadr07_s7 VISUALIZATION
 
   The Visualization Manager is set in the main().
   The initialisation of the drawing is done via the commands
   /vis/... in the macro vis.mac. To get visualisation:
\verbatim
   > /control/execute vis.mac
\endverbatim
 	
   The tracks are drawn at the end of event, and erased at the end of run.   
   gamma green   
   neutron yellow
   negative particles (e-, ...) red
   positive particles (e+, ions, ...) blue
 	
\section Hadr07_s8 HOW TO START ?
 
   Execute Hadr07 in 'batch' mode from macro files :
\verbatim
 	% Hadr07   run1.mac
\endverbatim
 		
   Execute Hadr07 in 'interactive mode' with visualization :
\verbatim
 	% Hadr07
	Idle> control/execute vis.mac
 	....
 	Idle> type your commands
 	....
 	Idle> exit
\endverbatim

*/
