index.html 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125
  1. <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  5. <meta name="Content-Type" content="text/html; charset=iso-8859-1">
  6. <meta name="GENERATOR" content="Mozilla/4.75C-CCK-MCD LBNL V4.73 Build 2 (Macintosh; U; PPC) [Netscape]">
  7. <meta name="Author" content="Art Poskanzer">
  8. <title>STAR flow analysis</title>
  9. </head>
  10. <body>
  11. &nbsp;
  12. <table BORDER=0 CELLSPACING=10 CELLPADDING=0 COLS=2 WIDTH="100%" wrap >
  13. <caption ALIGN="TOP">
  14. <h3>
  15. STAR Software for Analysis of Anisotropic Flow</h3>
  16. <i>R.J. Snellings and A.M. Poskanzer</i>
  17. <br><i>Nuclear Science Division, Lawrence Berkeley National Laboratory,
  18. Berkeley, CA 94720, USA</i></caption>
  19. <tr VALIGN=TOP>
  20. <td VALIGN=TOP WIDTH="50%"><!C- First column starts here>In the <a href="http://root.cern.ch/">ROOT</a>
  21. for <a href="http://www.star.bnl.gov/STAR/html/star_computing.html">STAR</a>
  22. environment, c++ programs have been written to analyze STAR data for anisotropic
  23. (directed and elliptic) flow. This document is a road map to the available
  24. documentation. The software consists of 7.3k lines of code in 33 files
  25. in three directories. The three "maker" modules are called from the STAR
  26. software chain and described in the overview <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/ebe_l/pub/flow/HTML_Presentation/">presentation</a>.
  27. The presentation is also available as a <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/ebe_l/pub/flow/Presentation.ps">postscript</a>
  28. file together with an overview <a href="http://duvall.star.bnl.gov/STARAFS/comp/pkg/dev/StRoot/StFlowMaker/doc/Diagram.ps">diagram</a>
  29. using the Unified Modeling Language. The chain of three makers is run off-line
  30. by the macro <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/macros/analysis/doFlowEvents.C">doFlowEvents.C</a>
  31. . In this macro, parameters can be set for the event cuts, track cuts,
  32. flags, event plane selections, and PID windows. Also in this macro <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowSelection.cxx">StFlowSelection</a>
  33. can be instantiated and passed to the Tag, Analysis, and Cumulant makers.
  34. This object can be set to select track PID.
  35. <p><b><a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/">StFlowMaker</a></b>
  36. is the interface with the STAR DST. It creates <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowEvent.cxx">StFlowEvent</a>
  37. from <a href="http://www.star.bnl.gov/STARAFS/comp/root/special_docs.html">StEvent</a>
  38. or <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowPicoEvent.cxx">StFlowPicoEvent</a>
  39. after <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowCutEvent.cxx">event</a>
  40. and <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowCutTrack.cxx">track</a>
  41. cuts. StFlowEvent consists of a <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowTrackCollection.h">track
  42. collection</a> of <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowTrack.h">tracks</a>.
  43. It also contains methods for calculating event-by-event quantities, like
  44. the event plane vector, from the data members of the tracks. The event
  45. plane is made isotropic in the laboratory with weights which are the inverse
  46. of the acceptance as determined from the azimuthal distribution of particles.
  47. This is all described in the <a href="http://duvall.star.bnl.gov/STARAFS/comp/pkg/dev/StRoot/StFlowMaker/README">README</a>
  48. document. One can also view the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowMaker.h">header</a>,
  49. the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowMaker.cxx">implementation,</a>
  50. and the <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/comp_l/root/html/StFlowMaker.html">interface</a>.
  51. A persistent sub-set of StFlowEvent can be written out to disk as <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowPicoEvent.cxx">StFlowPicoEvent</a>.
  52. Constants which are needed in more than one file are kept in <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowMaker/StFlowConstants.h">StFlowConstants</a>.
  53. <p><b><a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowTagMaker/">StFlowTagMaker</a></b>
  54. fills the <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/comp_l/root/html/St_FlowTag.html">tag</a>
  55. database from StFlowEvent. This is described in the <a href="http://duvall.star.bnl.gov/STARAFS/comp/pkg/dev/StRoot/StFlowTagMaker/README">README</a>
  56. document. One can also view the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowTagMaker/StFlowTagMaker.h">header</a>,
  57. the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowTagMaker/StFlowTagMaker.cxx">implementation,</a>
  58. and the <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/comp_l/root/html/StFlowTagMaker.html">interface</a>.
  59. <p><b><a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/">StFlowAnalysisMaker</a></b>
  60. reads the event-by-event quantities from the tag database, if it exists,
  61. or if it does not, from StFlowEvent. It reads the particle quantities from
  62. StFlowEvent and does the flow analysis<sup>1</sup> by correlating the particles
  63. with the event plane after removing autocorrelations. The main results
  64. are double-differential flow values contained in 2D histograms of the flow
  65. variables, v_n, as a function of pseudorapidity and transverse momenta.
  66. For identified particles rapidity is used instead of pseudorapidity. A
  67. second analysis is done in terms of the normalized vector q which is equal
  68. to the length of the flow vector Q divided by the square-root of the sum
  69. of the squares of the weights. This integral measure of flow is good for
  70. studying the fluctuations in flow. This is all described in the <a href="http://duvall.star.bnl.gov/STARAFS/comp/pkg/dev/StRoot/StFlowAnalysisMaker/README">README</a>
  71. document. One can also view the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/StFlowAnalysisMaker.h">header</a>,
  72. the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/StFlowAnalysisMaker.cxx">implementation,</a>
  73. and the <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/comp_l/root/html/StFlowAnalysisMaker.html">interface</a>.
  74. The macros <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/plot.C">plot.C</a>
  75. and <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/plotCen.C">plotCen.C</a>
  76. are used to plot the resulting histograms. The macro <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/minBias.C">minBias.C</a>
  77. combines the histograms from different centralities to make a minimum bias
  78. histogram file.
  79. <p><b><a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/StFlowCumulantMaker.cxx">StFlowCumulantMaker</a></b>
  80. which is in the StFlowAnalysisMaker directory, can perform a multiparticle
  81. analysis using the cumulant method.<sup>7</sup> One can also view the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/StFlowCumulantMaker.h">header</a>,
  82. the <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/StFlowCumulantMaker.cxx">implementation,</a>
  83. and the <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/comp_l/root/html/StFlowCumulantMaker.html">interface</a>.
  84. The macro <a href="http://duvall.star.bnl.gov/lxr/source/StRoot/StFlowAnalysisMaker/plotCumulant.C">plotCumulant.C</a>
  85. is used to plot the resulting histograms.
  86. <p>Simulated events which have been run through GEANT have been analyzed
  87. and <a href="http://www.star.bnl.gov/star/starlib/doc/www/html/ebe_l/pub/flow/index.html">results</a>
  88. produced. There is also a STAR Note<sup>2</sup> which contains predictions
  89. for STAR, a paper<sup>3</sup> on the expected behavior of the directed
  90. flow,&nbsp; and a paper<sup>4</sup> on how to interpret the physics results.
  91. Now there are also first results for charged particles<sup>5 </sup>and
  92. identified particles.<sup>6</sup>
  93. <p><!C- End of first column></td>
  94. <td VALIGN=TOP WIDTH="50%"><!C- Begin second column>
  95. <br><i>Acknowledgments</i>
  96. <br>We thank Glenn Cooper for considerable help with c++ and ROOT. Markus
  97. Oldenburg contributed the FTPC code and Aihong Tang the cumulant analysis.&nbsp;
  98. <p><!C- References and footnotes here><i>Footnotes and References</i>
  99. <br><font size=-1>1. A.M. Poskanzer and S.A. Voloshin, "Methods for Analyzing
  100. Anisotropic Flow in Relativistic Nuclear Collisions", <a href="http://pubster.aip.org/AIPcgipath/doc/getabs-PRVCAN/disk3/journals/journal_cgi/getabs?KEY=PRVCAN&cvips=PRVCAN000058000003001671000001&gifs=yes">Phys.
  101. Rev. C <b>58</b>, 1671 (1998)</a>.</font>
  102. <p><font size=-1>2. R.J.M. Snellings, A.M. Poskanzer, and S.A. Voloshin,
  103. "Anisotropic Flow at STAR", STAR Note <a href="http://www.star.bnl.gov/STAR/sno/sno.html">SN0388(</a>1999).</font>
  104. <p><font size=-1>3. R.J.M. Snellings, H. Sorge, S.A. Voloshin, F.Q. Wang,
  105. and N. Xu, "Novel Rapidity Dependence of Directed Flow in High Energy Heavy
  106. Ion Collisions", Phys. Rev. Letters <b>84</b>, 2803 (2000). <a href="http://arXiv.org/abs/nucl-ex/9908001">nucl-ex/9908001</a>.</font>
  107. <p><font size=-1>4. S.A. Voloshin and A.M. Poskanzer, "The Physics of the
  108. Centrality Dependence of Elliptic Flow", Phys. Letters <b>B474</b>, 27
  109. (2000). <a href="http://xxx.lanl.gov/abs/nucl-th/9906075">nucl-th/9906075</a>.</font>
  110. <p><font size=-1>5. K.H. Ackermann <i>et al.</i>, "Elliptic Flow in Au+Au
  111. Collisions at sq_root(s)=130 GeV", Phys. Rev. Letters <b>86</b>, 402 (2001).
  112. <a href="http://xxx.lanl.gov/abs/nucl-ex/0009011">nucl-ex/0009011</a>.</font>
  113. <p><font size=-1>6. C. Adler <i>et al.</i>, "Identified Particle Elliptic
  114. Flow in Au+Au Collisions at sq_root(s)=130 GeV", Phys. Rev. Letters <b>87</b>,
  115. 182301 (2001). <a href="http://xxx.lanl.gov/abs/nucl-ex/0107003">nucl-ex/0107003</a>.</font>
  116. <p><font size=-1>7. N. Borghini, P.M. Dinh, and J.Y. Ollitrault, "Flow
  117. Analysis from Cumulants: a Practical Guide". <a href="http://xxx.lanl.gov/abs/nucl-ex/0110016">nucl-ex/0110016.</a></font></td>
  118. </tr>
  119. </table>
  120. </body>
  121. </html>