Warning, /coresoftware/generators/JEWEL/README is written in an unsupported language. File is not indexed.
0001 -------- JEWEL --------
0002
0003 homepage: jewel.hepforge.org
0004 contact : jewel@projects.hepforge.org
0005
0006 -----------------------
0007
0008 CONTENTS:
0009
0010 1. REFERENCES
0011
0012 2. GETTING STARTED
0013
0014 3. ACKNOWLEDGEMENTS
0015
0016 4. DISCLAIMER
0017
0018 ------------------------
0019
0020 1. REFERENCES
0021 -------------
0022
0023 The manual with information on how to run JEWEL is distributed with the JEWEL
0024 release and can be obtained from
0025 ..................
0026
0027 If you use this code for scientific work please cite the manual for the code and
0028 JHEP 1303 (2013) 080 [arXiv:1212.1599] and optionally EPJC C60 (2009) 617
0029 [arXiv:0804.3568] for the physics.
0030
0031
0032 2. GETTING STARTED
0033 ------------------
0034
0035 JEWEL needs LHAPDF to provide the PDF's. Install LHAPDF following the instructions
0036 on the LHAPDF web page (lhapdf.hepforge.org) and download the PDF sets you want to
0037 use. In its default setup JEWEL needs the CTEPQ6LL (number 10042) and EPS09LOR_208
0038 sets. The latter can be downloaded from the EPS09 web page (www.jyu.fi/fysiikka/en/
0039 research/highenergy/urhic/eps09).
0040
0041 The provided Makefile assumes that JEWEL will be compiled with gfortran. People who
0042 wish to use a different compiler have to modify the Makefile accordingly.
0043
0044 Download and unpack the tarball.
0045 $ tar xvzf jewel-2.0.0.tar.gz
0046 Edit the line
0047 LHAPDF_PATH := /path/to/lhapdf
0048 in the Makefile to point to your LHAPDF installation.
0049 Compile the code by typing 'make'. The result of this are two executables:
0050 jewel-2.0.0-vac and jewel-2.0.0-simple. The former simulates jet evolution in vacuum
0051 (i.e. in e-e+ or pp collisions) while the latter simulates jet evolution in the
0052 presence of a medium. In this case the medium is modelled by an ideal gas of quarks and
0053 gluons undergoing boost-invariant longitudinal expansion with a transverse profile derived
0054 from a Glauber model.
0055
0056 The following paths need to be set for JEWEL to run:
0057 $ export LD_LIBRARY_PATH=/path/to/lhapdf/:$LD_LIBRARY_PATH
0058 $ export LHAPATH=/path/to/lhapdf/share/lhapdf/PDFsets
0059 To run JEWEL with the default setting no parameter file is needed:
0060 $./jewel-2.0.0-simple
0061 or
0062 $./jewel-2.0.0-vac
0063 Note, however, that also in the latter case nuclear PDF's will be used.
0064
0065 A parameter file can to be passed to change the setting:
0066 $./jewel-2.0.0-simple params.example.dat
0067 The file params.example.dat is included in the tarball as an example for a parameter file. The
0068 file can contain one parameter per line, the format is <name>␣<value>. Lines starting with a hash
0069 are comment lines. For a list of parameters and their dafault values please refer to the manual.
0070
0071
0072 3. ACKNOWLEDGEMENTS
0073 -------------------
0074
0075 JEWEL relies heavily on PYTHIA 6 (pythia6.hepforge.org) for the event generation. The modified
0076 version of PYTHIA 6.4.25 that is distributed with JEWEL is, however, not an official PYTHIA
0077 release and must not be used for anything else. Please refer to results as "JEWEL+PYTHIA".
0078
0079 JEWEL contains code provided by S. Zhang and J. M. Jing (Computation of Special Functions,
0080 John Wiley & Sons, New York, 1996 and http://jin.ece.illinois.edu) for computing the exponential
0081 integral Ei(x).
0082
0083 The medium model was partly implemented by Jochen Klein [Jochen.Klein@cern.ch].
0084 Raghav Kunnawalkam Elayavalli helped with the implementation of the V+jet processes [raghav.k.e@cern.ch].
0085
0086
0087 4. DISCLAIMER
0088 -------------
0089
0090 The JEWEL code is provided without any warranty, users should be wary and use common
0091 sense when judging and interpreting their results. It is copyrighted but may be used for
0092 scientific work provided proper reference is given.
0093
0094
0095
0096 Copyright Korinna C. Zapp (2017) [Korinna.Zapp@cern.ch]
