00001 /** 00002 00003 @mainpage C++ Interface to PHOTOS 00004 @brief Description of PHOTOS Interface in C++ 00005 00006 @authors Nadia Davidson, Tomasz Przedzinski, Zbigniew Was 00007 00008 @section download1 New release 00009 00010 The source code and documentation for release 3.52. The following files are provided for download: 00011 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.52/Photos_interface_design.3.52.pdf">Photos_interface_design.pdf</a> full software documentation. 00012 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.52/PHOTOS.3.52.tar.gz">PHOTOS 3.52 source code </a> tarball 00013 ( <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.52/PHOTOS.3.52-LHC.tar.gz"> version for LHC/LCG</a> installation) 00014 and its <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.52/svn_info_photos.3.52.txt">revision info</a> SVN tag, tarball creation date/time, etc. 00015 For updates with respect to release 3.0 see <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.52/changelog.3.52.txt">changelog.txt</a> 00016 00017 @section developement Developement version 00018 00019 The source code and documentation are updated daily from the repository. The following files are provided for download of the developement version: 00020 - <a href="http://www.ph.unimelb.edu.au/~ndavidson/photos/Photos_interface_design.pdf">Photos_interface_design.pdf</a> full software documentation. 00021 - <a href="http://www.ph.unimelb.edu.au/~ndavidson/photos/PHOTOS.daily_temp.tar.gz">PHOTOS.daily_temp.tar.gz</a> tarball and its <a href="http://www.ph.unimelb.edu.au/~ndavidson/photos/svn_info_photos.txt">revision info</a> SVN tag, tarball creation date/time, etc. 00022 For updates with respect to release 3.0 see <a href="http://www.ph.unimelb.edu.au/~ndavidson/photos/changelog.txt">changelog.txt</a>. 00023 00024 @section download Older releases 00025 00026 The source code and documentation for release 3.51. The following files are provided for download: 00027 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.51/Photos_interface_design.3.51.pdf">Photos_interface_design.pdf</a> full software documentation. 00028 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.51/PHOTOS.3.51.tar.gz">PHOTOS 3.51 source code </a> tarball 00029 ( <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.51/PHOTOS.3.51-LHC.tar.gz"> version for LHC/LCG</a> installation) 00030 and its <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.51/svn_info_photos.3.51.txt">revision info</a> SVN tag, tarball creation date/time, etc. 00031 For updates with respect to release 3.0 see <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.51/changelog.3.51.txt">changelog.txt</a> 00032 00033 The source code and documentation for release 3.5. The following files are provided for download: 00034 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.5/Photos_interface_design.3.5.pdf">Photos_interface_design.pdf</a> full software documentation. 00035 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.5/PHOTOS.3.5.tar.gz">PHOTOS 3.5 source code </a> tarball 00036 ( <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.5/PHOTOS.3.5-LHC.tar.gz"> version for LHC/LCG</a> installation) 00037 and its <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.5/svn_info_photos.3.5.txt">revision info</a> SVN tag, tarball creation date/time, etc. 00038 For updates with respect to release 3.0 see <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.5/changelog.3.5.txt">changelog.txt</a> 00039 00040 The source code and documentation for release 3.4. The following files are provided for download: 00041 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.4/Photos_interface_design.3.4.pdf">Photos_interface_design.pdf</a> full software documentation. 00042 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.4/PHOTOS.3.4.tar.gz">PHOTOS 3.4 source code </a> tarball 00043 ( <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.4/PHOTOS.3.4-LHC.tar.gz"> version for LHC/LCG</a> installation) 00044 and its <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.4/svn_info_photos.3.4.txt">revision info</a> SVN tag, tarball creation date/time, etc. 00045 For updates with respect to release 3.0 see <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.4/changelog.3.4.txt">changelog.txt</a> 00046 - NEW: methods to correct content of event record: (i) mass (ii) add history entries (iii) program is still not ready to work 00047 for cases when in vertex some daughters are history and some other are not. 00048 00049 The source code and documentation for release 3.3. The following files are provided for download: 00050 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.3/Photos_interface_design.3.3.pdf">Photos_interface_design.pdf</a> full software documentation. 00051 - <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.3/PHOTOS.3.3.tar.gz">PHOTOS 3.3 source code </a> tarball 00052 ( <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.3/PHOTOS.3.3-LHC.tar.gz"> version for LHC/LCG</a> installation) 00053 and its <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.3/svn_info_photos.3.3.txt">revision info</a> SVN tag, tarball creation date/time, etc. 00054 For updates with respect to release 3.0 see <a href="http://annapurna.ifj.edu.pl/~tprzedzinski/resources/PHOTOS.3.3/changelog.3.3.txt">changelog.txt</a> 00055 - NEW: NLO in decays of Z, W and B (K) --> 2 scalar, <a href="http://annapurna.ifj.edu.pl/~wasm/phNLO.htm">photos NLO tests</a>. 00056 00057 00058 The source code and documentation for release 3.0. The following files are provided for download: 00059 - <a href="http://arxiv.org/abs/1011.0937">arXiv:1011.0937</a> full software documentation. 00060 - <a href="http://www.ph.unimelb.edu.au/~ndavidson/photos/PHOTOS.3.0.tar.gz">PHOTOS 3.0 source code </a> tarball. 00061 00062 Note that LCG/Genser 00063 <a href="http://sftweb.cern.ch/generators/">Generator 00064 Services Subproject </a> distributes compiled, platform adopted 00065 tar balls of our programs. 00066 00067 @section intro Introduction/Status 00068 00069 The tar file contains the C++ interface along with parts of 00070 the source code for PHOTOS (see <a href="http://wasm.web.cern.ch/wasm/goodies.html">here</a>, version from Oct 11 2005). 00071 00072 The tar-ball has the functionality at least of its FORTRAN predecessor for all cases. 00073 An extensive number of tests performed in X.2011 and XI.2011 has been collected on the webpage of <a href="http://annapurna.ifj.edu.pl/~wasm/phNLO.htm">photos NLO tests</a>. 00074 In particular, tests with SANC went at sub 0.01\% level 00075 00076 @section setup Requirements 00077 00078 For compilation, and to run the simple example, the interface requires: 00079 - <a href="http://lcgapp.cern.ch/project/simu/HepMC/">HepMC v2.04</a> or later. 00080 00081 For a multitude of examples, one needs to install the libraries necessary to 00082 generate physics events stored in HepMC and to monitor such events: 00083 - <a href="http://home.thep.lu.se/~torbjorn/Pythia.html">PYTHIA 8.1</a> or later. PYTHIA must be compiled with HepMC 2 so that the PYTHIA library hepmcinterface exists. 00084 - <a href="http://www.ph.unimelb.edu.au/~ndavidson/tauola/doxygen/index.html">TAUOLA C++ Interface v1.0.7</a> or later (we expect Tauolapp namespace to be defined). 00085 - <a href="http://mc-tester.web.cern.ch/MC-TESTER/">MC-TESTER v1.24</a> or later. Do not forget to compile the additional HepMC library libHepMCEvent as well. 00086 - <a href="http://root.cern.ch/drupal/">ROOT v5.18</a> or later 00087 00088 @section compile Configuration and Compilation 00089 00090 In order to compile the PHOTOS C++ interface: 00091 - Execute './configure' with additional command line options: 00092 - '--with-hepmc=<path> ' provides the path to the HepMC installation directory. One can set the HEPMCLOCATION variable instead of using this directive. This path is required for the interface to compile. To compile without HepMC use '--without-hepmc'. 00093 - '--prefix=<path>' provides the installation path. The 'include' and 'lib' directories will be copied there if 'make install' is executed later. If none has been provided, the default directory for installation is '/usr/local'. 00094 - Execute 'make' 00095 - Optionally, execute 'make install' to copy files to the directory provided during configuration. 00096 00097 The PHOTOS C++ interface will be compiled and the '/lib' and '/include' directories will contain the appropriate library and include files. 00098 00099 In order to compile the examples, enter 'examples' directory, and: 00100 - execute './configure' to determine which examples can be compiled. Additional paths can be provided as command line options: 00101 - '--with-pythia8=<path>' provides the path to the Pythia8 installation directory. One can set the PYTHIALOCATION variable instead of using this directive. This path is required for all examples and tests. 00102 - '--with-mc-tester=<path>' provides the path to the MC-Tester installation directory (the libHepMCEvent must be compiled as well, check the MC-Tester documentation for more details). One can set the MCTESTERLOCATION variable instead of using this directive. This path is required for all additional examples and tests. It is assumed that using this option also implies that ROOT has already been installed (since it's required by MC-TESTER). The location of its binaries should be listed in the PATH variable. 00103 - '--with-tauola=<path>' provides the path to the TAUOLA C++ interface installation directory. One can set the TAUOLALOCATION variable instead of using this directive. This path is required for additional examples. 00104 - execute 'make' 00105 00106 Note that for examples working with PYTHIA 8.1, the PYTHIA8DATA global variable must be set (refer to the instructions provided during configuration). 00107 Similarly, for examples in the examples/testing directory to work, the MCTESTERLOCATION global variable must be set. 00108 If neither PYTHIA nor MC-TESTER are available, only the simple example can be 00109 used. The '/examples' directory will contain the compiled example files. 00110 00111 @section testing Testing 00112 00113 In order to run more elaborate and physics interesting tests both PYTHIA 00114 and MC-TESTER must be installed. In some cases TAUOLA C++ will be needed too. 00115 - Compile the PHOTOS C++ interface as well as examples. 00116 - Check that the appropriate system variables are set: normally set by the script 00117 configure.paths.sh [.csh] (the configuation step mentions this script). 00118 - Enter the /examples/testing directory. Modify test.inc if needed. 00119 - Enter the selected directory and execute 'make'. 00120 00121 The appropriate .root files as well as .pdf files generated by MC-TESTER will be created inside the choosen directory. You can execute 'make clobber' to clean the directory. You can also execute 'make' inside the 'PHOTOS/examples/testing' directory to run all available tests one after another. 00122 00123 00124 00125 <hr> 00126 Last update 05 November 2012. 00127 00128 */
1.6.3