* * * * * * * * * * * * * * * * * * * * * * * * * * * * 
 *                                                         *
*                   --<--<--  A fast simulator --<--<--     *
*                 / --<--<--     of particle   --<--<--     *
*  ----HECTOR----<                                          *
*                 \ -->-->-- transport through -->-->--     *
*                   -->-->-- generic beamlines -->-->--     *
*                                                           *
* JINST 2:P09005 (2007)                                     *
*      X Rouby, J de Favereau, K Piotrzkowski (CP3)         *
*       http://bit.ly/1IBluZr                               *
*                                                           *
* Center for Cosmology, Particle Physics and Phenomenology  *
*              Universite catholique de Louvain             *
*                 Louvain-la-Neuve, Belgium                 *
 *                                                         *
   * * * * * * * * * * * * * * * * * * * * * * * * * * * * 

---- Hector the simulator ----
[email protected] 
[email protected] 
[email protected]
[email protected]

Requirements:
	- ROOT 4.xx or later, recent g++ (not tested before 3.2.xx)

Optional package :
	- Pythia 6

Tested environments :
	- Linux (Kubuntu / Fedora / SLC)
	- Windows/Cygwin
	- Mac OS X

================================================================================
Note :
	On Fedora (using SELinux security system), if you experience some problems at 
	ROOT startup, concerning libHector_routines.so, i.e. :
		dlopen error: ./lib/libHector.so: cannot restore segment prot after reloc: Permission denied
		Load Error: Failed to load Dynamic link library ./lib/libHector.so
	Then you should try this :
		chcon -t textrel_shlib_t ./lib/libHector_routines.so
================================================================================

** Version 1.5.4 (30/06/2016)
	Fixed a bug in the MadX output files parser preventing long beamlines
	(>40 elements) to be manipulated properly.
	Added the capability to leave multiple fields unretrieved in the parsing
	of these MadX outputs.
	New features :
		Added Pythia8 as an extra tool to generate single diffractive events
		for their propagation into the beamline(s)

** Version 1.5.3 (08/05/2015)
	Beam initial energy is now an argument to provide to the H_BeamLine
	object (i.e. not hardcoded anymore, apart from its default value,
	 BE_DEF = 7000 GeV, as defined in H_Parameters.h)

** Version 1.5.2 (17/02/2009)
	switched all calls to "static const float pi" to TMath::Pi() 
	operator= in H_BeamLine.cc corrected
	Makefile : -fPIC option added in ROOTCFLAGS variable

** Version 1.5.1 (16/02/2009)
	H_BeamParticle, H_Beam : smear methods allow an external TRandom*
	Some cleaning in the class methods; remove code duplication
	H_Aperture and derivated classes: constructor slightly optimised ;
	no more #defines ; operator<< now every call to printProperties()
	 can be replaced by a stream:
		obj.printProperties()    is the same as     cout << obj;

** Version 1.5 (15/02/2009)
	H_RecRPObject is now not anymore leaking memory!
	Compatibility is ensured for all routines using H_RecRPObject
	Remove the misleading method
		H_AbstractBeamLine::add(const H_OpticalElement&)

** Version 1.4.2 (15/02/2009)
	putting the final banner in all files

** Version 1.4.1 (03/02/2009)
	Systematic check for memory leaks with valgrind in the classes (actually,
	using Delphes)
	All classes but H_RecRPObject should be ok

** Version 1.4.0 (03/10/2007)
	Miscellaneous
	partial update of H_RecRPObject prevent from running
	routines/H_Reconstruction.cpp properly
	remove all TView and 3D stuffs from H_BeamParticle class

** ** 08/08/2007
	New features :
		- All #include statements are checked, as ROOT v5.16 is
		  less permissive
		- TView changes from v5.16 ! added comment in
		  src/H_BeamParticle for proper code

** Version 1.3 (09/01/2007)
	New features :
		- Bug removal in kicker implementation. Now the kick is done in the middle
		  of the kicker.
		- Hector is now compatible with MAD-X within 0.05 µm in the positioning of
		  beamline protons.
		- H_BeamLine::getIPProperties()

** Version 1.2 (14/12/2006)
	New features :
		- new revision of the Makefile. Allows the compilation of any routine file
		  containing a 'main(...)' function.
		  e.g. for "routines/test.cpp", use "make test".
		  Builds the tarball of the sources using "make tar".
		  Can be now easily adapted for Mac OS X
		- update of the transport matrices. Weak field of rectangular dipoles added.
		

** Version 1.1 ** before :)
	New features :
		- Bug removal in chromaticity correction for quadrupoles
		- propagation of non-proton particles
		- "_RELATIVE_ENERGY_ and _ENERGY_SDIP_ #defines" are replaced by
		  "extern bool relative_energy"


** Version 1.0 ** before :)