THERMINATOR 2: THERMal heavy IoN generATOR 2

We present an extended version of THERMINATOR, a Monte Carlo event generator dedicated to studies of the statistical production of particles in relativistic heavy-ion collisions. The package is written in C++ and uses the CERN ROOT data-analysis environment. The largely increased functionality of the code contains the following main features: 1) The possibility of input of any shape of the freeze-out hypersurface and the expansion velocity field, including the 3+13+1-dimensional profiles, in particular those generated externally with various hydrodynamic codes. 2) The hypersurfaces may have variable thermal parameters, which allow studies departing significantly from the mid-rapidity region where the baryon chemical potential becomes large. 3) We include a library of standard sets of hypersurfaces and velocity profiles describing the RHIC Au + Au data at sNN=200 GeV for various centralities, as well as those anticipated for the LHC Pb + Pb collisions at sNN=5.5 TeV. 4) A separate code, FEMTO-THERMINATOR, is provided to carry out the analysis of the pion–pion femtoscopic correlations which are an important source of information concerning the size and expansion of the system. 5) We also include several useful scripts that carry out auxiliary tasks, such as obtaining an estimate of the number of elastic collisions after the freeze-out, counting of particles flowing back into the fireball and violating causality (typically very few), or visualizing various results: the particle pTpT-spectra, the elliptic flow coefficients, and the HBT correlation radii. Program summary Program title:THERMINATOR 2 Catalogue identifier: ADXL_v2_0 Program summary URL:http://cpc.cs.qub.ac.uk/summaries/ADXL_v2_0.html Program obtainable from: CPC Program Library, Queenʼs University, Belfast, N. Ireland Licensing provisions: Standard CPC licence, http://cpc.cs.qub.ac.uk/licence/licence.html No. of lines in distributed program, including test data, etc.: 423 444 No. of bytes in distributed program, including test data, etc.: 2 854 602 Distribution format: tar.gz Programming language:C++ with the CERN ROOT libraries, BASH shell Computer: Any with a C++ compiler and the CERN ROOT environment, ver. 5.26 or later, tested with Intel Core2 Duo CPU E8400 @ 3 GHz, 4 GB RAM Operating system: Linux Ubuntu 10.10 x64 (gcc 4.4.5) ROOT 5.26 Linux Ubuntu 11.04 x64 (gcc Ubuntu/Linaro 4.5.2-8ubuntu4) ROOT 5.30/00 (compiled from source) Linux CentOS 5.2 (gcc Red Hat 4.1.2-42) ROOT 5.30/00 (compiled from source) Mac OS X 10.6.8 (i686-apple-darwin10-g++-4.2.1) ROOT 5.30/00 (for Mac OS X 10.6 x86-64 with gcc 4.2.1) cygwin-1.7.9-1 (gcc gcc4-g++-4.3.4-4) ROOT 5.30/00 (for cygwin gcc 4.3) RAM: • 30 MB therm2 events • 150 MB therm2 femto Classification: 11.2 Catalogue identifier of previous version: ADXL_v1_0 Journal reference of previous version: Comput. Phys. Comm. 174 (2006) 669 External routines: CERN ROOT (http://root.cern.ch/drupal/) Does the new version supersede the previous version?: Yes Nature of problem: Particle production via statistical hadronization in relativistic heavy-ion collisions. Solution method: Monte Carlo simulation, analyzed with ROOT. Reasons for new version: The increased functionality of the code contains the following important features. The input of any shape of the freeze-out hypersurface and the expansion velocity field, including the 3+13+1-dimensional profiles, in particular those generated externally with the various popular hydrodynamic codes. The hypersurfaces may have variable thermal parameters, which allows for studies departing significantly from the mid-rapidity region. We include a library of standard sets of hypersurfaces and velocity profiles describing the RHIC Au + Au and the LHC Pb+PbPb+Pb data. A separate code, FEMTO-THERMINATOR, is provided to carry out the analysis of femtoscopic correlations. Summary of revisions: THERMINATOR 2 incorporates major revisions to encompass the enhanced functionality. • Classes: The Integrator class has been expanded and a new subgroup of classes defined. ∘ Model and abstract class: These classes are responsible for the physical models of the freeze-out process. The functionality and readability of the code has been substantially increased by implementing each freeze-out model in a different class. ∘ The Hypersurface class was added to handle the input form hydrodynamic codes. The hydro input is passed to the program as a lattice of the freeze-out hypersurface. That information is stored in the .xml files. • Input: THERMINATOR 2 programs are now controlled by *.ini type files. The programs parameters and the freeze-out model parameters are now in separate ini files. • Output: ∘ The event files generated by the therm2_events program are not backward compatible with the previous version. The event*.root file structure was expanded with two new TTree structures. From the particle entry it is possible to back-trace the whole cascade. ∘ Event text output is now optional. ∘ The ROOT macros produce the *.eps figures with physics results, e.g. the pT-spectra, the elliptic-flow coefficient, rapidity distributions, etc. ∘ The THERMINATOR HBT package creates the ROOT files femto*.root (therm2_femto) and hbtfit*.root (therm2_hbtfit). • Directory structure: The directory structure has been reorganized. Source code resides in the build directory. The freeze-out model input files, event files, ROOT macros are stored separately. The THERMINATOR 2 system, after installation, is able to run on a cluster. • Scripts: The package contains a few BASH scripts helpful when running e.g. on a cluster the whole system can be executed via a single script. Additional comments: Typical data file size: default configuration. • 45 MB/500 events; • 35 MB/correlation file (one kTkT bin); • 45 kB/fit file (projections and fits). Running time: Default configuration at 3 GHz. • primordial multiplicities 70 min (calculated only once per case); • 8 min/500 events; • 10 min – draw all figures; • 25 min/one kTkT bin in the HBT analysis with 5000 events.

[1]  Pan,et al.  Blast of light fragments from central heavy-ion collisions. , 1992, Physical review. C, Nuclear physics.

[2]  S. Voloshin,et al.  Flow analysis with cumulants: Direct calculations , 2010, 1010.0233.

[3]  Balance functions in a thermal model with resonances , 2003, nucl-th/0310062.

[4]  U. Heinz,et al.  Chemical freeze-out conditions in central S-S collisions at 200A GeV , 1994 .

[5]  P. Danielewicz,et al.  Three-dimensional two-pion emission source at SPS: Extraction of source breakup time and emission duration , 2008, 0807.4892.

[6]  Fred Cooper,et al.  Single-particle distribution in the hydrodynamic and statistical thermodynamic models of multiparticle production , 1974 .

[7]  P. Braun-Munzinger,et al.  Chemical equilibration in Pb+Pb collisions at the SPS , 1999, nucl-th/9903010.

[8]  Different Hagedorn temperatures for mesons and baryons from experimental mass spectra , 2000, hep-ph/0004104.

[9]  A. Kisiel,et al.  Uniform description of soft observables in heavy-ion collisions at sqrt sNN =200 GeV. , 2008, Physical review letters.

[10]  M. Hauer,et al.  Statistical Ensembles With Finite Bath: A Description for an Event Generator , 2009, 0909.2431.

[11]  A. Kisiel,et al.  Efficient and robust calculation of femtoscopic correlation functions in spherical harmonics directly from the raw pairs measured in heavy-ion collisions , 2009, 0901.3527.

[12]  C. Alt Three-dimensional two-pion source image from Pb+Pb collisions at √ sNN=17.3 GeV: new constraints for source breakup dynamics , 2008, 0809.1445.

[13]  Hadronic dissipative effects on elliptic flow in ultrarelativistic heavy-ion collisions , 2005, nucl-th/0511046.

[14]  P. Bożek,et al.  Indications of early thermalization in relativistic heavy-ion collisions , 2010, 1009.0701.

[15]  W. Broniowski,et al.  Thermal approach to RHIC , 2002, hep-ph/0209286.

[16]  I. Lokhtin,et al.  Fast hadron freeze-out generator. II. Noncentral collisions , 2007, 0711.0835.

[17]  J. Noronha,et al.  Particle ratios as a probe of the QCD critical temperature , 2009, 0906.3960.

[18]  Wojciech Florkowski,et al.  THERMINATOR: THERMal heavy-IoN generATOR, , 2006, Comput. Phys. Commun..

[19]  H. Ritter,et al.  Energy dependence of high moments for net-proton distributions , 2010, 1001.2847.

[20]  P. Romatschke,et al.  Viscosity information from relativistic nuclear collisions: how perfect is the fluid observed at RHIC? , 2007, Physical review letters.

[21]  U. Heinz,et al.  Dissipative hydrodynamics for viscous relativistic fluids , 2005, nucl-th/0510014.

[22]  Thermal and hadrochemical equilibration in nucleus-nucleus collisions at the SPS , 1995, nucl-th/9508020.

[23]  E. Shuryak What RHIC experiments and theory tell us about properties of quark–gluon plasma? , 2005 .

[24]  Hayes,et al.  Review of Particle Physics. , 1996, Physical review. D, Particles and fields.

[25]  J. Cleymans,et al.  THERMUS - A thermal model package for ROOT , 2004, Comput. Phys. Commun..

[26]  A. Kisiel,et al.  Describing transverse dynamics and space-time evolution at RHIC in a hydrodynamic model with statistical hadronization , 2009, 0907.3592.

[27]  J. Cleymans,et al.  Thermal hadron production in Si-Au collisions , 1996, nucl-th/9603004.

[28]  P. Bożek Components of the elliptic flow in Pb–Pb collisions at s=2.76 TeV , 2011, 1101.1791.

[29]  U. Heinz,et al.  Causal viscous hydrodynamics in 2+1 dimensions for relativistic heavy-ion collisions , 2007, 0712.3715.

[30]  Pratt,et al.  Pion interferometry of quark-gluon plasma. , 1986, Physical review. D, Particles and fields.

[31]  P. Bożek Interferometry radii in heavy-ion collisions at 200GeV and 2.76TeV , 2010, 1012.5927.

[32]  P. Petreczky,et al.  QCD Equation of State and Hadron Resonance Gas , 2009, 0912.2541.

[33]  Hydrodynamic Models for Heavy Ion Collisions , 2006, nucl-th/0605008.

[34]  Observable implications of geometrical and dynamical aspects of freeze-out in heavy ion collisions , 2003, nucl-th/0312024.

[35]  3D Relativistic Hydrodynamic Computations Using Lattice-QCD-Inspired Equations of State , 2005, hep-ph/0510096.

[36]  G. Colangelo,et al.  pi pi scattering , 2001, hep-ph/0103088.

[37]  Boris Tomášik,et al.  DRAGON: Monte Carlo generator of particle production from a fragmented fireball in ultrarelativistic nuclear collisions , 2008, Comput. Phys. Commun..

[38]  Variable Energy Cyclotron Centre , 2007 .

[39]  G. G. Stokes "J." , 1890, The New Yale Book of Quotations.

[40]  W. Florkowski,et al.  Transverse hydrodynamics with sudden hadronization: production of strangeness , 2009, 0912.3451.

[41]  J. Cleymans,et al.  UNIFIED DESCRIPTION OF FREEZE-OUT PARAMETERS IN RELATIVISTIC HEAVY ION COLLISIONS , 1998, nucl-th/9808030.

[42]  P. Bożek,et al.  Rapid hydrodynamic expansion in relativistic heavy-ion collisions , 2009, 0902.4121.

[43]  J. Rafelski,et al.  Strange particles from dense hadronic matter , 2002, nucl-th/0209080.

[44]  A. Kisiel,et al.  Azimuthally sensitive femtoscopy in hydrodynamics with statistical hadronization from the BNL Relativistic Heavy Ion Collider to the CERN Large Hadron Collider , 2009 .

[45]  M. K. Lee,et al.  Source breakup dynamics in Au + Au collisions at sqrt[s(NN)]=200 GeV via three-dimensional two-pion source imaging. , 2007, Physical review letters.

[46]  Z. Chajecki Femtoscopy in hadron and lepton collisions: World systematics , 2009 .

[47]  Space-time evolution of bulk QCD matter , 2006, nucl-th/0607018.

[48]  A. M. Snigirev,et al.  Heavy ion event generator HYDJET++ (HYDrodynamics plus JETs) , 2008, Comput. Phys. Commun..

[49]  Jean Letessier,et al.  SHAREv2: fluctuations and a comprehensive treatment of decay feed-down , 2006, Comput. Phys. Commun..

[50]  Modeling Bose Einstein Correlations via Elementary Emitting Cells , 2007, hep-ph/0702073.

[51]  P. Bożek Viscous evolution of the rapidity distribution of matter created in relativistic heavy-ion collisions , 2007, 0712.3498.

[52]  Urs Achim Wiedemann,et al.  Dissipative hydrodynamics and heavy-ion collisions , 2006 .

[53]  V. Begun Multiplicity fluctuations in relativistic gases: From simple models to experiment , 2007, 0711.2912.

[54]  J. Rasmussen,et al.  Evidence for a Blast Wave from Compressed Nuclear Matter , 1979 .

[55]  P. Danielewicz,et al.  Imaging of sources in heavy ion reactions , 1997, nucl-th/9811048.

[56]  M. Shao,et al.  Signature of QCD critical point: Anomalous transverse velocity dependence of antiproton–proton ratio , 2009, 0903.0024.

[57]  D. Brown,et al.  Exploring lifetime effects in femtoscopy , 2007, 0705.1337.

[58]  F. Videbæk Overview and Recent Results from BRAHMS , 2009 .

[59]  Thermal hadron production in high energy heavy ion collisions , 1992, hep-ph/9207204.

[60]  A. Kisiel Nonidentical-particle femtoscopy atsNN=200GeV in hydrodynamics with statistical hadronization , 2009, 0909.5349.

[61]  Thermal equilibration and expansion in nucleus-nucleus collisions at the AGS , 1994, nucl-th/9410026.

[62]  P. Bożek,et al.  Torqued fireballs in relativistic heavy-ion collisions , 2010, 1011.3354.

[63]  Second-order dissipative fluid dynamics for ultrarelativistic nuclear collisions. , 2001, Physical review letters.

[64]  M. Luzum,et al.  Conformal relativistic viscous hydrodynamics: Applications to RHIC results at s NN =200 GeV , 2008, 0804.4015.

[65]  Hayes,et al.  Review of particle properties. , 1978, Physical review. D, Particles and fields.

[66]  Bertsch,et al.  Pion interferometry in ultrarelativistic heavy-ion collisions. , 1988, Physical review. C, Nuclear physics.

[67]  J. Noronha,et al.  Particle ratios and the QCD critical temperature , 2010, 1001.2610.

[68]  P. Bożek,et al.  Directed flow in ultrarelativistic heavy-ion collisions , 2010, 1002.4999.

[69]  T. Csorgo,et al.  Bose-Einstein correlations for three-dimensionally expanding, cylindrically symmetric, finite systems. , 1996, Physical review. C, Nuclear physics.

[70]  G. I. Veres,et al.  System size dependence of cluster properties from two-particle angular correlations in Cu+Cu and Au+Au collisions at $\sqrt{s_{_{NN}}}$ = 200 GeV , 2010 .

[71]  A. Kisiel,et al.  Soft heavy-ion physics from hydrodynamics with statistical hadronization: Predictions for collisions at S NN = 5 . 5 TeV , 2007, 0712.0947.

[72]  A. Andronic,et al.  Hadron production in central nucleus-nucleus collisions at chemical freeze-out , 2005, nucl-th/0511071.

[73]  F. Rademakers,et al.  ROOT — An object oriented data analysis framework , 1997 .

[74]  A. Kisiel,et al.  Free-streaming approximation in early dynamics of relativistic heavy-ion collisions , 2008, 0812.3393.

[75]  K. Eskola,et al.  Predictions for low-pT and high-pT hadron spectra in nearly central Pb+Pb collisions at sqrt[sNN]=5.5 TeV tested at sqrt[sNN]=130 and 200 GeV , 2005 .

[76]  Ericka Stricklin-Parker,et al.  Ann , 2005 .

[77]  Helmuth Spieler,et al.  Review of Particle Physics, 2008-2009 , 2000 .

[78]  I. Lokhtin,et al.  Fast hadron freeze-out generator , 2006, nucl-th/0608057.

[79]  John B. Shoven,et al.  I , Edinburgh Medical and Surgical Journal.

[80]  R. Lacey PHENIX measurements of 3D emission source function in Au-Au collisions at sqrt(s) = 200 GeV , 2008, 0805.1352.

[81]  M. Chojnacki,et al.  Size fluctuations of the initial source and event-by-event transverse momentum fluctuations in relativistic heavy-ion collisions , 2009, 0907.3216.

[82]  J. Cleymans,et al.  Chemical and thermal freezeout parameters from 1-A/GeV to 200-A/GeV , 1999, nucl-th/9903063.

[83]  P. Bożek Interplay of the emission from thermal and direct sources in relativistic heavy ion collisions , 2008, 0811.1918.

[84]  Jean Letessier,et al.  SHARE: Statistical hadronization with resonances , 2005, Comput. Phys. Commun..

[85]  Thermal hadron production in high energy collisions , 1997, hep-ph/9708248.

[86]  J. G. Contreras,et al.  Elliptic flow of charged particles in Pb-Pb collisions at 2.76 TeV , 2010, 1011.3914.

[87]  Heinz,et al.  Thermal phenomenology of hadrons from 200A GeV S+S collisions. , 1993, Physical review. C, Nuclear physics.