19 ( <a href="resources/PHOTOS.3.64/PHOTOS.3.64-LHC.tar.gz"> version for LHC/LCG</a> installation)
20 and its <a href="resources/PHOTOS.3.64/svn_info_photos.3.64.txt">revision info</a> SVN tag, tarball creation date/time, etc.
21 For updates with respect to release 3.0 see <a href="resources/PHOTOS.3.64/changelog.3.64.txt">changelog.txt</a>
22
23 <b>IMPORTANT NOTE:</b> Since release 3.64 we have added HepMC3 support (HepMC3 is avialble on the official <a href="https://hepmc.web.cern.ch/hepmc/">HepMC website</a>).
24 We have also adapted examples to Tauola v1.1.8 which means <b>Tauola examples and tests will not compile with Tauola v1.1.6 or older</b>.
25
26 @section developement Developement version
27
28 The source code and documentation are updated daily from the repository. The following files are provided for download of the developement version:
29 - <a href="resources/PHOTOS.development.version/Photos_interface_design.development.version.pdf">Photos_interface_design.pdf</a> full software documentation.
30 - <a href="resources/PHOTOS.development.version/PHOTOS.development.version.tar.gz">PHOTOS development version source code </a> tarball
31 ( <a href="resources/PHOTOS.development.version/PHOTOS.development.version-LHC.tar.gz"> version for LHC/LCG</a> installation)
32 and its <a href="resources/PHOTOS.development.version/svn_info_photos.development.version.txt">revision info</a> SVN tag, tarball creation date/time, etc.
33 For updates with respect to release 3.0 see <a href="resources/PHOTOS.development.version/changelog.development.version.txt">changelog.txt</a>.
34
35 @section download Older releases
36
37 The source code and documentation for release 3.61. The following files are provided for download:
38 - <a href="resources/PHOTOS.3.61/Photos_interface_design.3.61.pdf">Photos_interface_design.pdf</a> full software documentation.
122 The tar file contains the C++ interface along with parts of
123 the source code for PHOTOS (see <a href="http://wasm.web.cern.ch/wasm/goodies.html">here</a>, version from Oct 11 2005).
124
125 The tar-ball has the functionality at least of its FORTRAN predecessor for all cases.
126 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>.
127 In particular, tests with SANC went at sub 0.01\% level
128
129 @section setup Requirements
130
131 For compilation, and to run the simple example, the interface requires:
132 - <a href="http://lcgapp.cern.ch/project/simu/HepMC/">HepMC v2.04</a> or later.
133
134 For a multitude of examples, one needs to install the libraries necessary to
135generate physics events stored in HepMC and to monitor such events:
136 - <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.
137 - <a href="http://tauolapp.web.cern.ch">TAUOLA C++ Interface v1.0.7</a> or later (we expect Tauolapp namespace to be defined).
138 - <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.
139 - <a href="http://root.cern.ch/drupal/">ROOT v5.18</a> or later
140
141 @section compile Configuration and Compilation
142
143 In order to compile the PHOTOS C++ interface:
144 - Execute './configure' with additional command line options:
145 - '--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'.
146 - '--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'.
147 - Execute 'make'
148 - Optionally, execute 'make install' to copy files to the directory provided during configuration.
149
150 The PHOTOS C++ interface will be compiled and the '/lib' and '/include' directories will contain the appropriate library and include files.
151
152 In order to compile the examples, enter 'examples' directory, and:
153 - execute './configure' to determine which examples can be compiled. Additional paths can be provided as command line options:
154 - '--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.
155 - '--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.
156 - '--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.
157 - execute 'make'
158
159 Note that for examples working with PYTHIA 8.1, the PYTHIA8DATA global variable must be set (refer to the instructions provided during configuration).
160 Similarly, for examples in the examples/testing directory to work, the MCTESTERLOCATION global variable must be set.
161 If neither PYTHIA nor MC-TESTER are available, only the simple example can be
162used. The '/examples' directory will contain the compiled example files.
163
164 @section testing Testing
165
166 In order to run more elaborate and physics interesting tests both PYTHIA
167and MC-TESTER must be installed. In some cases TAUOLA C++ will be needed too.
168 - Compile the PHOTOS C++ interface as well as examples.
169 - Check that the appropriate system variables are set: normally set by the script
170 configure.paths.sh [.csh] (the configuation step mentions this script).
171 - Enter the /examples/testing directory. Modify test.inc if needed.
172 - Enter the selected directory and execute 'make'.
173
174 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.
175
176
177
178 <hr>
179Last update; usually last night by the robot, see the doxygen time below and revision info of the development version.
180
181*/
Generated on Tue Mar 12 2024 23:11:40 for C++InterfacetoPHOTOS by 1.8.7
