PWG2/FLOW/AliFlowCommon/AliFlowAnalysisWithQCumulants.h

   1 /*
   2  * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved.
   3  * See cxx source for full Copyright notice
   4  * $Id$
   5  */
   6
   7 /**********************************
   8  * flow analysis with Q-cumulants *
   9  *                                *
  10  * author:  Ante Bilandzic        *
  11  *           (anteb@nikhef.nl)    *
  12  *********************************/
  13
  14 #ifndef ALIFLOWANALYSISWITHQCUMULANTS_H
  15 #define ALIFLOWANALYSISWITHQCUMULANTS_H
  16
  17 #include "AliFlowCommonConstants.h" // needed as include
  18 #include "TMatrixD.h"
  19 #include "TH2D.h"
  20 #include "TBits.h"
  21
  22 class TObjArray;
  23 class TList;
  24 class TFile;
  25 class TGraph;
  26
  27 class TH1;
  28 class TProfile;
  29 class TProfile2D;
  30
  31 class AliFlowEventSimple;
  32 class AliFlowVector;
  33
  34 class AliFlowCommonHist;
  35 class AliFlowCommonHistResults;
  36
  37 //================================================================================================================
  38
  39 class AliFlowAnalysisWithQCumulants{
  40  public:
  41   AliFlowAnalysisWithQCumulants();
  42   virtual ~AliFlowAnalysisWithQCumulants();
  43   // 0.) methods called in the constructor:
  44   virtual void InitializeArraysForIntFlow();
  45   virtual void InitializeArraysForDiffFlow();
  46   virtual void InitializeArraysForDistributions();
  47   virtual void InitializeArraysForNestedLoops();
  48   // 1.) method Init() and methods called within Init():
  49   virtual void Init();
  50     virtual void AccessConstants();
  51     virtual void BookAndNestAllLists();
  52     virtual void BookCommonHistograms();
  53     virtual void BookAndFillWeightsHistograms();
  54     virtual void BookEverythingForIntegratedFlow();
  55     virtual void BookEverythingForDifferentialFlow();
  56     virtual void BookEverythingForDistributions();
  57     virtual void BookEverythingForNestedLoops();
  58     virtual void StoreIntFlowFlags();
  59     virtual void StoreDiffFlowFlags();
  60     virtual void StoreHarmonic();
  61   // 2.) method Make() and methods called within Make():
  62   virtual void Make(AliFlowEventSimple *anEvent);
  63     // 2a.) common:
  64     virtual void FillAverageMultiplicities(Int_t nRP);
  65     virtual void FillCommonControlHistograms(AliFlowEventSimple *anEvent);
  66     virtual void ResetEventByEventQuantities();
  67     // 2b.) integrated flow:
  68     virtual void CalculateIntFlowCorrelations();
  69     virtual void CalculateIntFlowProductOfCorrelations();
  70     virtual void CalculateIntFlowSumOfEventWeights();
  71     virtual void CalculateIntFlowSumOfProductOfEventWeights();
  72     virtual void CalculateIntFlowCorrectionsForNUASinTerms();
  73     virtual void CalculateIntFlowCorrectionsForNUACosTerms();
  74     // ...
  75     virtual void CalculateIntFlowCorrelationsUsingParticleWeights();
  76     virtual void CalculateWeightedQProductsForIntFlow();
  77     virtual void EvaluateIntFlowCorrelationsWithNestedLoops(AliFlowEventSimple* anEvent);
  78     virtual void EvaluateIntFlowCorrelationsWithNestedLoopsUsingParticleWeights(AliFlowEventSimple* anEvent);
  79     virtual void EvaluateIntFlowCorrectionsForNUAWithNestedLoops(AliFlowEventSimple* anEvent);
  80     // 2c.) differential flow:
  81     virtual void CalculateDiffFlowCorrelations(TString type, TString ptOrEta); // type = RP or POI
  82     virtual void CalculateDiffFlowCorrelationsUsingParticleWeights(TString type, TString ptOrEta); // type = RP or POI
  83     virtual void CalculateDiffFlowProductOfCorrelations(TString type, TString ptOrEta); // type = RP or POI
  84     virtual void CalculateDiffFlowSumOfEventWeights(TString type, TString ptOrEta); // type = RP or POI
  85     virtual void CalculateDiffFlowSumOfProductOfEventWeights(TString type, TString ptOrEta); // type = RP or POI
  86     virtual void CalculateDiffFlowCorrectionsForNUASinTerms(TString type, TString ptOrEta);
  87     virtual void CalculateDiffFlowCorrectionsForNUACosTerms(TString type, TString ptOrEta);
  88     // ...
  89     //virtual void CalculateCorrelationsForDifferentialFlow2D(TString type); // type = RP or POI
  90     //virtual void CalculateCorrectionsForNonUniformAcceptanceForDifferentialFlowCosTerms(TString type); // type = RP or POI
  91     //virtual void CalculateCorrectionsForNonUniformAcceptanceForDifferentialFlowSinTerms(TString type); // type = RP or POI
  92     virtual void EvaluateDiffFlowCorrelationsWithNestedLoops(AliFlowEventSimple* anEvent, TString type, TString ptOrEta);
  93     virtual void EvaluateDiffFlowCorrelationsWithNestedLoopsUsingParticleWeights(AliFlowEventSimple* anEvent, TString type, TString ptOrEta);
  94     virtual void EvaluateDiffFlowCorrectionTermsForNUAWithNestedLoops(AliFlowEventSimple* anEvent, TString type, TString ptOrEta);
  95   // 3.) method Finish() and methods called within Finish():
  96   virtual void Finish();
  97     // 3a.) integrated flow:
  98     virtual void FinalizeCorrelationsIntFlow();
  99     virtual void FinalizeCorrectionTermsForNUAIntFlow();
 100     virtual void CalculateCovariancesIntFlow();
 101     virtual void CalculateCumulantsIntFlow();
 102     virtual void CalculateIntFlow();
 103     virtual void FillCommonHistResultsIntFlow();
 104     // nua:
 105     //virtual void CalculateCorrectionsForNUAForIntQcumulants();
 106     virtual void CalculateQcumulantsCorrectedForNUAIntFlow();
 107     virtual void CalculateIntFlowCorrectedForNUA();
 108     //virtual void ApplyCorrectionForNonUniformAcceptanceToCumulantsForIntFlow(Bool_t useParticleWeights, TString eventWeights);
 109     //virtual void PrintQuantifyingCorrectionsForNonUniformAcceptance(Bool_t useParticleWeights, TString eventWeights);
 110     virtual void PrintFinalResultsForIntegratedFlow(TString type);
 111     virtual void CrossCheckIntFlowCorrelations();
 112     virtual void CrossCheckIntFlowExtraCorrelations(); // extra correlations which appear only when particle weights are used
 113     virtual void CrossCheckIntFlowCorrectionTermsForNUA();
 114     // 3b.) differential flow:
 115     virtual void FinalizeReducedCorrelations(TString type, TString ptOrEta);
 116     virtual void CalculateDiffFlowCovariances(TString type, TString ptOrEta);
 117     virtual void CalculateDiffFlowCumulants(TString type, TString ptOrEta);
 118     virtual void CalculateDiffFlow(TString type, TString ptOrEta);
 119     virtual void FinalizeCorrectionTermsForNUADiffFlow(TString type, TString ptOrEta);
 120     virtual void CalculateDiffFlowCumulantsCorrectedForNUA(TString type, TString ptOrEta);   \r
 121     virtual void CalculateDiffFlowCorrectedForNUA(TString type, TString ptOrEta);
 122     virtual void CalculateFinalResultsForRPandPOIIntegratedFlow(TString type); // to be improved (add also possibility to integrate over eta yield)
 123     virtual void FillCommonHistResultsDiffFlow(TString type);
 124     virtual void CrossCheckDiffFlowCorrelations(TString type, TString ptOrEta);
 125     virtual void CrossCheckDiffFlowCorrectionTermsForNUA(TString type, TString ptOrEta);
 126
 127     // to be improved (removed):
 128     //virtual void FinalizeCorrelationsForDiffFlow(TString type, Bool_t useParticleWeights, TString eventWeights);
 129
 130   // 4.)  method GetOutputHistograms() and methods called within GetOutputHistograms():
 131   virtual void GetOutputHistograms(TList *outputListHistos);
 132     virtual void GetPointersForCommonHistograms(TList *outputListHistos);
 133     virtual void GetPointersForParticleWeightsHistograms(TList *outputListHistos);
 134     virtual void GetPointersForIntFlowHistograms(TList *outputListHistos);
 135     virtual void GetPointersForDiffFlowHistograms(TList *outputListHistos);
 136     virtual void GetPointersForNestedLoopsHistograms(TList *outputListHistos); // to be improved (no need to pass here argument, use setter for base list instead)
 137
 138   // 5.) other methods:
 139   TProfile* MakePtProjection(TProfile2D *profilePtEta) const;
 140   TProfile* MakeEtaProjection(TProfile2D *profilePtEta) const;
 141   virtual void WriteHistograms(TString outputFileName);
 142
 143   // **** SETTERS and GETTERS ****
 144
 145   // 0.) base:
 146   TList* GetHistList() const {return this->fHistList;}
 147
 148   // 1.) common:
 149   void SetCommonHists(AliFlowCommonHist* const ch) {this->fCommonHists = ch;};
 150   AliFlowCommonHist* GetCommonHists() const {return this->fCommonHists;};
 151   void SetCommonHists2nd(AliFlowCommonHist* const ch2nd) {this->fCommonHists2nd = ch2nd;};
 152   AliFlowCommonHist* GetCommonHists2nd() const {return this->fCommonHists2nd;};
 153   void SetCommonHists4th(AliFlowCommonHist* const ch4th) {this->fCommonHists4th = ch4th;};
 154   AliFlowCommonHist* GetCommonHists4th() const {return this->fCommonHists4th;};
 155   void SetCommonHists6th(AliFlowCommonHist* const ch6th) {this->fCommonHists6th = ch6th;};
 156   AliFlowCommonHist* GetCommonHists6th() const {return this->fCommonHists6th;};
 157   void SetCommonHists8th(AliFlowCommonHist* const ch8th) {this->fCommonHists8th = ch8th;};
 158   AliFlowCommonHist* GetCommonHists8th() const {return this->fCommonHists8th;};
 159   void SetCommonHistsResults2nd(AliFlowCommonHistResults* const chr2nd) {this->fCommonHistsResults2nd = chr2nd;};
 160   AliFlowCommonHistResults* GetCommonHistsResults2nd() const {return this->fCommonHistsResults2nd;};
 161   void SetCommonHistsResults4th(AliFlowCommonHistResults* const chr4th) {this->fCommonHistsResults4th = chr4th;};
 162   AliFlowCommonHistResults* GetCommonHistsResults4th() const {return this->fCommonHistsResults4th;};
 163   void SetCommonHistsResults6th(AliFlowCommonHistResults* const chr6th) {this->fCommonHistsResults6th = chr6th;};
 164   AliFlowCommonHistResults* GetCommonHistsResults6th() const {return this->fCommonHistsResults6th;};
 165   void SetCommonHistsResults8th(AliFlowCommonHistResults* const chr8th) {this->fCommonHistsResults8th = chr8th;};
 166   AliFlowCommonHistResults* GetCommonHistsResults8th() const {return this->fCommonHistsResults8th;};
 167   void SetHarmonic(Int_t const harmonic) {this->fHarmonic = harmonic;};
 168   Int_t GetHarmonic() const {return this->fHarmonic;};
 169   void SetAnalysisLabel(const char *aLabel) {this->fAnalysisLabel->Append(*aLabel);};
 170   TString *GetAnalysisLabel() const {return this->fAnalysisLabel;};
 171
 172   // 2.) particle weights:
 173   void SetWeightsList(TList* wlist) {this->fWeightsList = (TList*)wlist->Clone();}
 174   TList* GetWeightsList() const {return this->fWeightsList;}
 175   void SetUsePhiWeights(Bool_t const uPhiW) {this->fUsePhiWeights = uPhiW;};
 176   Bool_t GetUsePhiWeights() const {return this->fUsePhiWeights;};
 177   void SetUsePtWeights(Bool_t const uPtW) {this->fUsePtWeights = uPtW;};
 178   Bool_t GetUsePtWeights() const {return this->fUsePtWeights;};
 179   void SetUseEtaWeights(Bool_t const uEtaW) {this->fUseEtaWeights = uEtaW;};
 180   Bool_t GetUseEtaWeights() const {return this->fUseEtaWeights;};
 181   void SetUseParticleWeights(TProfile* const uPW) {this->fUseParticleWeights = uPW;};
 182   TProfile* GetUseParticleWeights() const {return this->fUseParticleWeights;};
 183   void SetPhiWeights(TH1F* const histPhiWeights) {this->fPhiWeights = histPhiWeights;};
 184   TH1F* GetPhiWeights() const {return this->fPhiWeights;};
 185   void SetPtWeights(TH1D* const histPtWeights) {this->fPtWeights = histPtWeights;};
 186   TH1D* GetPtWeights() const {return this->fPtWeights;};
 187   void SetEtaWeights(TH1D* const histEtaWeights) {this->fEtaWeights = histEtaWeights;};
 188   TH1D* GetEtaWeights() const {return this->fEtaWeights;};
 189
 190   // 3.) integrated flow:
 191   // flags:
 192   void SetIntFlowFlags(TProfile* const intFlowFlags) {this->fIntFlowFlags = intFlowFlags;};
 193   TProfile* GetIntFlowFlags() const {return this->fIntFlowFlags;};
 194   void SetApplyCorrectionForNUA(Bool_t const applyCorrectionForNUA) {this->fApplyCorrectionForNUA = applyCorrectionForNUA;};
 195   Bool_t GetApplyCorrectionForNUA() const {return this->fApplyCorrectionForNUA;};
 196   // integrated flow profiles:
 197   void SetAvMultiplicity(TProfile* const avMultiplicity) {this->fAvMultiplicity = avMultiplicity;};
 198   TProfile* GetAvMultiplicity() const {return this->fAvMultiplicity;};
 199   void SetIntFlowCorrelationsPro(TProfile* const intFlowCorrelationsPro) {this->fIntFlowCorrelationsPro = intFlowCorrelationsPro;};
 200   TProfile* GetIntFlowCorrelationsPro() const {return this->fIntFlowCorrelationsPro;};
 201   void SetIntFlowCorrelationsAllPro(TProfile* const intFlowCorrelationsAllPro) {this->fIntFlowCorrelationsAllPro = intFlowCorrelationsAllPro;};
 202   TProfile* GetIntFlowCorrelationsAllPro() const {return this->fIntFlowCorrelationsAllPro;};
 203   void SetIntFlowExtraCorrelationsPro(TProfile* const intFlowExtraCorrelationsPro) {this->fIntFlowExtraCorrelationsPro = intFlowExtraCorrelationsPro;};
 204   TProfile* GetIntFlowExtraCorrelationsPro() const {return this->fIntFlowExtraCorrelationsPro;};
 205   void SetIntFlowProductOfCorrelationsPro(TProfile* const intFlowProductOfCorrelationsPro) {this->fIntFlowProductOfCorrelationsPro = intFlowProductOfCorrelationsPro;};
 206   TProfile* GetIntFlowProductOfCorrelationsPro() const {return this->fIntFlowProductOfCorrelationsPro;};
 207   void SetIntFlowCorrectionTermsForNUAPro(TProfile* const ifctfnp, Int_t sc) {this->fIntFlowCorrectionTermsForNUAPro[sc] = ifctfnp;};
 208   TProfile* GetIntFlowCorrectionTermsForNUAPro(Int_t sc) const {return this->fIntFlowCorrectionTermsForNUAPro[sc];};
 209   // integrated flow histograms holding all results:
 210   void SetIntFlowCorrelationsHist(TH1D* const intFlowCorrelationsHist) {this->fIntFlowCorrelationsHist = intFlowCorrelationsHist;};
 211   TH1D* GetIntFlowCorrelationsHist() const {return this->fIntFlowCorrelationsHist;};
 212   void SetIntFlowCorrelationsAllHist(TH1D* const intFlowCorrelationsAllHist) {this->fIntFlowCorrelationsAllHist = intFlowCorrelationsAllHist;};
 213   TH1D* GetIntFlowCorrelationsAllHist() const {return this->fIntFlowCorrelationsAllHist;};
 214   // to be improved (removed:)
 215   //void SetIntFlowProductOfCorrelationsHist(TH1D* const intFlowProductOfCorrelationsHist) {this->fIntFlowProductOfCorrelationsHist = intFlowProductOfCorrelationsHist;};
 216   //TH1D* GetIntFlowProductOfCorrelationsHist() const {return this->fIntFlowProductOfCorrelationsHist;};
 217   void SetIntFlowCorrectionTermsForNUAHist(TH1D* const ifctfnh, Int_t sc) {this->fIntFlowCorrectionTermsForNUAHist[sc] = ifctfnh;};
 218   TH1D* GetIntFlowCorrectionTermsForNUAHist(Int_t sc) const {return this->fIntFlowCorrectionTermsForNUAHist[sc];};
 219   void SetIntFlowCovariances(TH1D* const intFlowCovariances) {this->fIntFlowCovariances = intFlowCovariances;};
 220   TH1D* GetIntFlowCovariances() const {return this->fIntFlowCovariances;};
 221   void SetIntFlowSumOfEventWeights(TH1D* const intFlowSumOfEventWeights, Int_t power) {this->fIntFlowSumOfEventWeights[power] = intFlowSumOfEventWeights;};
 222   TH1D* GetIntFlowSumOfEventWeights(Int_t power) const {return this->fIntFlowSumOfEventWeights[power];};
 223   void SetIntFlowSumOfProductOfEventWeights(TH1D* const intFlowSumOfProductOfEventWeights) {this->fIntFlowSumOfProductOfEventWeights = intFlowSumOfProductOfEventWeights;};
 224   TH1D* GetIntFlowSumOfProductOfEventWeights() const {return this->fIntFlowSumOfProductOfEventWeights;};
 225   void SetIntFlowQcumulants(TH1D* const intFlowQcumulants) {this->fIntFlowQcumulants = intFlowQcumulants;};
 226   TH1D* GetIntFlowQcumulants() const {return this->fIntFlowQcumulants;};
 227   void SetIntFlow(TH1D* const intFlow) {this->fIntFlow = intFlow;};
 228   TH1D* GetIntFlow() const {return this->fIntFlow;};
 229
 230   // 4.) differential flow:
 231   // flags:
 232   void SetDiffFlowFlags(TProfile* const diffFlowFlags) {this->fDiffFlowFlags = diffFlowFlags;};
 233   TProfile* GetDiffFlowFlags() const {return this->fDiffFlowFlags;};
 234   void SetCalculate2DFlow(Bool_t const calculate2DFlow) {this->fCalculate2DFlow = calculate2DFlow;};
 235   Bool_t GetCalculate2DFlow() const {return this->fCalculate2DFlow;};
 236   // profiles:
 237   // 1D:
 238   void SetDiffFlowCorrelationsPro(TProfile* const diffFlowCorrelationsPro, Int_t i, Int_t j, Int_t k) {this->fDiffFlowCorrelationsPro[i][j][k] = diffFlowCorrelationsPro;};
 239   TProfile* GetDiffFlowCorrelationsPro(Int_t i, Int_t j, Int_t k) const {return this->fDiffFlowCorrelationsPro[i][j][k];};
 240   void SetDiffFlowProductOfCorrelationsPro(TProfile* const dfpocp, Int_t i, Int_t j, Int_t k, Int_t l) {this->fDiffFlowProductOfCorrelationsPro[i][j][k][l] = dfpocp;};
 241   TProfile* GetDiffFlowProductOfCorrelationsPro(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fDiffFlowProductOfCorrelationsPro[i][j][k][l];};
 242   void SetDiffFlowCorrectionTermsForNUAPro(TProfile* const dfctfnp, Int_t i, Int_t j, Int_t k, Int_t l) {this->fDiffFlowCorrectionTermsForNUAPro[i][j][k][l] = dfctfnp;};
 243   TProfile* GetDiffFlowCorrectionTermsForNUAPro(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fDiffFlowCorrectionTermsForNUAPro[i][j][k][l];};
 244   // 2D:
 245   void SetCorrelationsPro(TProfile2D* const correlPro, Int_t i, Int_t j, Int_t k, Int_t l) {this->fCorrelationsPro[i][j][k][l] = correlPro;};
 246   TProfile2D* GetCorrelationsPro(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fCorrelationsPro[i][j][k][l];};
 247   void SetProductsOfCorrelationsPro(TProfile2D* const proOfcorrelPro, Int_t i, Int_t j, Int_t k, Int_t l) {this->fProductsOfCorrelationsPro[i][j][k][l] = proOfcorrelPro;};
 248   TProfile2D* GetProductsOfCorrelationsPro(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fProductsOfCorrelationsPro[i][j][k][l];};
 249   void SetCorrectionTermsPro(TProfile2D* const correctTermsPro, Int_t i, Int_t j, Int_t k, Int_t l, Int_t m) {this->fCorrectionTermsPro[i][j][k][l][m] = correctTermsPro;};
 250   TProfile2D* GetCorrectionTermsPro(Int_t i, Int_t j, Int_t k, Int_t l, Int_t m) const {return this->fCorrectionTermsPro[i][j][k][l][m];};
 251   // histograms:
 252   void SetDiffFlowCorrelationsHist(TH1D* const diffFlowCorrelationsHist, Int_t i, Int_t j, Int_t k) {this->fDiffFlowCorrelationsHist[i][j][k] = diffFlowCorrelationsHist;};
 253   TH1D* GetDiffFlowCorrelationsHist(Int_t i, Int_t j, Int_t k) const {return this->fDiffFlowCorrelationsHist[i][j][k];};
 254   void SetDiffFlowCovariances(TH1D* const diffFlowCovariances, Int_t i, Int_t j, Int_t k) {this->fDiffFlowCovariances[i][j][k] = diffFlowCovariances;};
 255   TH1D* GetDiffFlowCovariances(Int_t i, Int_t j, Int_t k) const {return this->fDiffFlowCovariances[i][j][k];};
 256   void SetDiffFlowCumulants(TH1D* const diffFlowCumulants, Int_t i, Int_t j, Int_t k) {this->fDiffFlowCumulants[i][j][k] = diffFlowCumulants;};
 257   TH1D* GetDiffFlowCumulants(Int_t i, Int_t j, Int_t k) const {return this->fDiffFlowCumulants[i][j][k];};
 258   void SetDiffFlow(TH1D* const diffFlow, Int_t i, Int_t j, Int_t k) {this->fDiffFlow[i][j][k] = diffFlow;};
 259   TH1D* GetDiffFlow(Int_t i, Int_t j, Int_t k) const {return this->fDiffFlow[i][j][k];};
 260   void SetDiffFlowSumOfEventWeights(TH1D* const dfsoew, Int_t i, Int_t j, Int_t k, Int_t l) {this->fDiffFlowSumOfEventWeights[i][j][k][l] = dfsoew;};
 261   TH1D* GetDiffFlowSumOfEventWeights(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fDiffFlowSumOfEventWeights[i][j][k][l];};
 262   void SetDiffFlowSumOfProductOfEventWeights(TH1D* const dfsopoew, Int_t i, Int_t j, Int_t k, Int_t l) {this->fDiffFlowSumOfProductOfEventWeights[i][j][k][l] = dfsopoew;};
 263   TH1D* GetDiffFlowSumOfProductOfEventWeights(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fDiffFlowSumOfProductOfEventWeights[i][j][k][l];};
 264   void SetDiffFlowCorrectionTermsForNUAHist(TH1D* const dfctfnh, Int_t i, Int_t j, Int_t k, Int_t l) {this->fDiffFlowCorrectionTermsForNUAHist[i][j][k][l] = dfctfnh;};
 265   TH1D* GetDiffFlowCorrectionTermsForNUAHist(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fDiffFlowCorrectionTermsForNUAHist[i][j][k][l];};
 266
 267   // x.) debugging and cross-checking:
 268   void SetNestedLoopsList(TList* nllist) {this->fNestedLoopsList = nllist;};
 269   TList* GetNestedLoopsList() const {return this->fNestedLoopsList;};
 270   void SetEvaluateIntFlowNestedLoops(Bool_t const eifnl) {this->fEvaluateIntFlowNestedLoops = eifnl;};
 271   Bool_t GetEvaluateIntFlowNestedLoops() const {return this->fEvaluateIntFlowNestedLoops;};
 272   void SetEvaluateDiffFlowNestedLoops(Bool_t const edfnl) {this->fEvaluateDiffFlowNestedLoops = edfnl;};
 273   Bool_t GetEvaluateDiffFlowNestedLoops() const {return this->fEvaluateDiffFlowNestedLoops;};
 274   void SetMaxAllowedMultiplicity(Int_t const maxAllowedMultiplicity) {this->fMaxAllowedMultiplicity = maxAllowedMultiplicity;};
 275   Int_t GetMaxAllowedMultiplicity() const {return this->fMaxAllowedMultiplicity;};
 276   void SetEvaluateNestedLoops(TProfile* const enl) {this->fEvaluateNestedLoops = enl;};
 277   TProfile* GetEvaluateNestedLoops() const {return this->fEvaluateNestedLoops;};
 278   void SetIntFlowDirectCorrelations(TProfile* const ifdc) {this->fIntFlowDirectCorrelations = ifdc;};
 279   TProfile* GetIntFlowDirectCorrelations() const {return this->fIntFlowDirectCorrelations;};
 280   void SetIntFlowExtraDirectCorrelations(TProfile* const ifedc) {this->fIntFlowExtraDirectCorrelations = ifedc;};
 281   TProfile* GetIntFlowExtraDirectCorrelations() const {return this->fIntFlowExtraDirectCorrelations;};
 282   void SetIntFlowDirectCorrectionTermsForNUA(TProfile* const ifdctfn, Int_t sc) {this->fIntFlowDirectCorrectionTermsForNUA[sc] = ifdctfn;};
 283   TProfile* GetIntFlowDirectCorrectionTermsForNUA(Int_t sc) const {return this->fIntFlowDirectCorrectionTermsForNUA[sc];};
 284   void SetCrossCheckInPtBinNo(Int_t const crossCheckInPtBinNo) {this->fCrossCheckInPtBinNo = crossCheckInPtBinNo;};
 285   Int_t GetCrossCheckInPtBinNo() const {return this->fCrossCheckInPtBinNo;};
 286   void SetCrossCheckInEtaBinNo(Int_t const crossCheckInEtaBinNo) {this->fCrossCheckInEtaBinNo = crossCheckInEtaBinNo;};
 287   Int_t GetCrossCheckInEtaBinNo() const {return this->fCrossCheckInEtaBinNo;};
 288   void SetDiffFlowDirectCorrelations(TProfile* const diffFlowDirectCorrelations,Int_t i,Int_t j,Int_t k){this->fDiffFlowDirectCorrelations[i][j][k]=diffFlowDirectCorrelations;};
 289   TProfile* GetDiffFlowDirectCorrelations(Int_t i, Int_t j, Int_t k) const {return this->fDiffFlowDirectCorrelations[i][j][k];};
 290   void SetDiffFlowDirectCorrectionTermsForNUA(TProfile* const dfdctfn, Int_t i, Int_t j, Int_t k, Int_t l) {this->fDiffFlowDirectCorrectionTermsForNUA[i][j][k][l] = dfdctfn;};
 291   TProfile* GetDiffFlowDirectCorrectionTermsForNUA(Int_t i, Int_t j, Int_t k, Int_t l) const {return this->fDiffFlowDirectCorrectionTermsForNUA[i][j][k][l];};
 292
 293  private:
 294
 295   AliFlowAnalysisWithQCumulants(const AliFlowAnalysisWithQCumulants& afawQc);
 296   AliFlowAnalysisWithQCumulants& operator=(const AliFlowAnalysisWithQCumulants& afawQc);
 297
 298   // 0.) base:
 299   TList* fHistList; // base list to hold all output object
 300
 301   // 1.) common:
 302   AliFlowCommonHist *fCommonHists; // common control histograms (taking into account ALL events)
 303   AliFlowCommonHist *fCommonHists2nd; // common control histograms (taking into account only the events with 2 and more particles)
 304   AliFlowCommonHist *fCommonHists4th; // common control histograms (taking into account only the events with 4 and more particles)
 305   AliFlowCommonHist *fCommonHists6th; // common control histograms (taking into account only the events with 6 and more particles)
 306   AliFlowCommonHist *fCommonHists8th; // common control histograms (taking into account only the events with 8 and more particles)
 307   AliFlowCommonHistResults *fCommonHistsResults2nd; // final results for 2nd order int. and diff. flow for events with 2 and more particles
 308   AliFlowCommonHistResults *fCommonHistsResults4th; // final results for 4th order int. and diff. flow for events with 4 and more particles
 309   AliFlowCommonHistResults *fCommonHistsResults6th; // final results for 6th order int. and diff. flow for events with 6 and more particles
 310   AliFlowCommonHistResults *fCommonHistsResults8th; // final results for 8th order int. and diff. flow for events with 8 and more particles
 311   Int_t fnBinsPhi; // number of phi bins
 312   Double_t fPhiMin; // minimum phi
 313   Double_t fPhiMax; // maximum phi
 314   Double_t fPhiBinWidth; // bin width for phi histograms
 315   Int_t fnBinsPt; // number of pt bins
 316   Double_t fPtMin; // minimum pt
 317   Double_t fPtMax; // maximum pt
 318   Double_t fPtBinWidth; // bin width for pt histograms
 319   Int_t fnBinsEta; // number of eta bins
 320   Double_t fEtaMin; // minimum eta
 321   Double_t fEtaMax; // maximum eta
 322   Double_t fEtaBinWidth; // bin width for eta histograms
 323   Int_t fHarmonic; // harmonic
 324   TString *fAnalysisLabel; // analysis label (all histograms and output file will have this label)
 325
 326   // 2.) weights
 327   TList *fWeightsList; // list to hold all histograms with particle weights: fUseParticleWeights, fPhiWeights, fPtWeights and fEtaWeights
 328   Bool_t fUsePhiWeights; // use phi weights
 329   Bool_t fUsePtWeights; // use pt weights
 330   Bool_t fUseEtaWeights; // use eta weights
 331   TProfile *fUseParticleWeights; // profile with three bins to hold values of fUsePhiWeights, fUsePtWeights and fUseEtaWeights
 332   TH1F *fPhiWeights; // histogram holding phi weights
 333   TH1D *fPtWeights; // histogram holding phi weights
 334   TH1D *fEtaWeights; // histogram holding phi weights
 335
 336   // 3.) integrated flow
 337   //  3a.) lists:
 338   TList *fIntFlowList; // list to hold all histograms and profiles relevant for integrated flow
 339   TList *fIntFlowProfiles; // list to hold all profiles relevant for integrated flow
 340   TList *fIntFlowResults; // list to hold all histograms with final results relevant for integrated flow
 341   //  3b.) flags:
 342   TProfile *fIntFlowFlags; // profile to hold all flags for integrated flow
 343   Bool_t fApplyCorrectionForNUA; // apply correction for non-uniform acceptance
 344   //  3c.) event-by-event quantities:
 345   TMatrixD *fReQ; // fReQ[m][k] = sum_{i=1}^{M} w_{i}^{k} cos(m*phi_{i})
 346   TMatrixD *fImQ; // fImQ[m][k] = sum_{i=1}^{M} w_{i}^{k} sin(m*phi_{i})
 347   TMatrixD *fSMpk; // fSM[p][k] = (sum_{i=1}^{M} w_{i}^{k})^{p}
 348   TH1D *fIntFlowCorrelationsEBE; // 1st bin: <2>, 2nd bin: <4>, 3rd bin: <6>, 4th bin: <8>
 349   TH1D *fIntFlowEventWeightsForCorrelationsEBE; // 1st bin: eW_<2>, 2nd bin: eW_<4>, 3rd bin: eW_<6>, 4th bin: eW_<8>
 350   TH1D *fIntFlowCorrelationsAllEBE; // to be improved (add comment)
 351   TH1D *fIntFlowCorrectionTermsForNUAEBE[2]; // [0=sin terms,1=cos terms], NUA = non-uniform acceptance
 352   //  3d.) profiles:
 353   TProfile *fAvMultiplicity; // profile to hold average multiplicities and number of events for events with nRP>=0, nRP>=1, ... , and nRP>=8
 354   TProfile *fIntFlowCorrelationsPro; // average correlations <<2>>, <<4>>, <<6>> and <<8>> (with wrong errors!)
 355   TProfile *fIntFlowCorrelationsAllPro; // average all correlations for integrated flow (with wrong errors!)
 356   TProfile *fIntFlowExtraCorrelationsPro; // when particle weights are used some extra correlations appear
 357   TProfile *fIntFlowProductOfCorrelationsPro; // average product of correlations <2>, <4>, <6> and <8>:
 358   TProfile *fIntFlowCorrectionTermsForNUAPro[2]; // average correction terms for non-uniform acceptance (with wrong errors!) [0=sin terms,1=cos terms]
 359   //  3e.) histograms with final results:
 360   TH1D *fIntFlowCorrelationsHist; // final results for average correlations <<2>>, <<4>>, <<6>> and <<8>> (with correct errors!)
 361   TH1D *fIntFlowCorrelationsAllHist; // final results for all average correlations (with correct errors!)
 362   TH1D *fIntFlowCorrectionTermsForNUAHist[2];// final results for correction terms for non-uniform acceptance (with correct errors!) [0=sin terms,1=cos terms]
 363   TH1D *fIntFlowCovariances; // final result for covariances of correlations (multiplied with weight dependent prefactor)
 364   TH1D *fIntFlowSumOfEventWeights[2]; // sum of linear and quadratic event weights for <2>, <4>, <6> and <8>: [0=linear 1,1=quadratic]
 365   TH1D *fIntFlowSumOfProductOfEventWeights; // sum of products of event weights for correlations <2>, <4>, <6> and <8>
 366   TH1D *fIntFlowQcumulants; // final results for integrated Q-cumulants QC{2}, QC{4}, QC{6} and QC{8}
 367   TH1D *fIntFlow; // final results for integrated flow estimates v_n{2,QC}, v_n{4,QC}, v_n{6,QC} and v_n{8,QC}
 368
 369   // 4.) differential flow
 370   //  4a.) lists:
 371   TList *fDiffFlowList; // list to hold list with all histograms (fDiffFlowResults) and list with profiles (fDiffFlowProfiles) relevant for differential flow
 372   TList *fDiffFlowProfiles; // list to hold all profiles relevant for differential flow
 373   TList *fDiffFlowResults; // list to hold all histograms with final results relevant for differential flow
 374   //    4aa.) nested list in list fDiffFlowProfiles:
 375   TList *fDiffFlowCorrelationsProList[2][2]; // list to hold profiles with all correlations for differential flow [0=RP,1=POI][0=pt,1=eta]
 376   TList *fDiffFlowProductOfCorrelationsProList[2][2]; // list to hold profiles with products of all correlations for differential flow [0=RP,1=POI][0=pt,1=eta]
 377   TList *fDiffFlowCorrectionsProList[2][2]; // list to hold profiles with correction term for NUA for differential flow [0=RP,1=POI][0=pt,1=eta]
 378   //    4ab.) nested list in list fDiffFlowResults:
 379   TList *fDiffFlowCorrelationsHistList[2][2]; // list to hold histograms with all correlations for differential flow [0=RP,1=POI][0=pt,1=eta]
 380   TList *fDiffFlowSumOfEventWeightsHistList[2][2][2]; // list to hold histograms with sum of linear/quadratic event weights [0=RP,1=POI][0=pt,1=eta][0=linear 1,1=quadratic]
 381   TList *fDiffFlowSumOfProductOfEventWeightsHistList[2][2]; // list to hold histograms with sum of products of event weights [0=RP,1=POI][0=pt,1=eta]
 382   TList *fDiffFlowCorrectionsHistList[2][2]; // list to hold histograms with correction term for NUA for differential flow [0=RP,1=POI][0=pt,1=eta]
 383   TList *fDiffFlowCovariancesHistList[2][2]; // list to hold histograms with all covariances for differential flow [0=RP,1=POI][0=pt,1=eta]
 384   TList *fDiffFlowCumulantsHistList[2][2]; // list to hold histograms with all cumulants for differential flow [0=RP,1=POI][0=pt,1=eta]
 385   TList *fDiffFlowHistList[2][2]; // list to hold histograms with final results for differential flow [0=RP,1=POI][0=pt,1=eta]
 386   //  4b.) flags:
 387   TProfile *fDiffFlowFlags; // profile to hold all flags for differential flow
 388   Bool_t fCalculate2DFlow; // calculate differential flow in (pt,eta) (Remark: this is very expensive in terms of CPU time)
 389   //  4c.) event-by-event quantities:
 390   // 1D:
 391   TProfile *fReRPQ1dEBE[3][2][4][9]; // real part [0=r,1=p,2=q][0=pt,1=eta][m][k]
 392   TProfile *fImRPQ1dEBE[3][2][4][9]; // imaginary part [0=r,1=p,2=q][0=pt,1=eta][m][k]
 393   TProfile *fs1dEBE[3][2][9]; // [0=r,1=p,2=q][0=pt,1=eta][k] // to be improved
 394   TH1D *fDiffFlowCorrelationsEBE[2][2][4]; // [0=RP,1=POI][0=pt,1=eta][reduced correlation index]
 395   TH1D *fDiffFlowEventWeightsForCorrelationsEBE[2][2][4]; // [0=RP,1=POI][0=pt,1=eta][event weights for reduced correlation index]
 396   TH1D *fDiffFlowCorrectionTermsForNUAEBE[2][2][2][10]; // [0=RP,1=POI][0=pt,1=eta][0=sin terms,1=cos terms][correction term index]
 397   // 2D:
 398   TProfile2D *fReRPQ2dEBE[3][4][9]; // real part of r_{m*n,k}(pt,eta), p_{m*n,k}(pt,eta) and q_{m*n,k}(pt,eta)
 399   TProfile2D *fImRPQ2dEBE[3][4][9]; // imaginary part of r_{m*n,k}(pt,eta), p_{m*n,k}(pt,eta) and q_{m*n,k}(pt,eta)
 400   TProfile2D *fs2dEBE[3][9]; // [t][k] // to be improved
 401   //  4d.) profiles:
 402   // 1D:
 403   TProfile *fDiffFlowCorrelationsPro[2][2][4]; // [0=RP,1=POI][0=pt,1=eta][correlation index]
 404   TProfile *fDiffFlowProductOfCorrelationsPro[2][2][8][8]; // [0=RP,1=POI][0=pt,1=eta] [0=<2>,1=<2'>,2=<4>,3=<4'>,4=<6>,5=<6'>,6=<8>,7=<8'>] x
 405                                                            //                          [0=<2>,1=<2'>,2=<4>,3=<4'>,4=<6>,5=<6'>,6=<8>,7=<8'>]
 406   TProfile *fDiffFlowCorrectionTermsForNUAPro[2][2][2][10]; // [0=RP,1=POI][0=pt,1=eta][0=sin terms,1=cos terms][correction term index]
 407
 408   //  4e.) histograms holding final results:
 409   // 1D:
 410   TH1D *fDiffFlowCorrelationsHist[2][2][4]; // [0=RP,1=POI][0=pt,1=eta][correlation index]
 411   TH1D *fDiffFlowCovariances[2][2][5]; // [0=RP,1=POI][0=pW not used,1=pW used][0=exact eW,1=non-exact eW][0=pt,1=eta][index of covariances]
 412   TH1D *fDiffFlowCumulants[2][2][4]; // [0=RP,1=POI][0=pt,1=eta][0=QC{2'},1=QC{4'},2=QC{6'},3=QC{8'}]
 413   TH1D *fDiffFlow[2][2][4]; // [0=RP,1=POI][0=pt,1=eta][0=v'{2},1=v'{4},2=v'{6},3=v'{8}]
 414   TH1D *fDiffFlowSumOfEventWeights[2][2][2][4]; // [0=RP,1=POI][0=pt,1=eta][0=linear 1,1=quadratic][0=<2'>,1=<4'>,2=<6'>,3=<8'>]
 415   TH1D *fDiffFlowSumOfProductOfEventWeights[2][2][8][8]; // [0=RP,1=POI][0=pt,1=eta]  [0=<2>,1=<2'>,2=<4>,3=<4'>,4=<6>,5=<6'>,6=<8>,7=<8'>] x
 416                                                          //                           [0=<2>,1=<2'>,2=<4>,3=<4'>,4=<6>,5=<6'>,6=<8>,7=<8'>]
 417   TH1D *fDiffFlowCorrectionTermsForNUAHist[2][2][2][10]; // [0=RP,1=POI][0=pt,1=eta][0=sin terms,1=cos terms][correction term index]
 418
 419   // 2D:
 420   TProfile2D *fCorrelationsPro[2][2][2][4]; // [0=RP,1=POI][0=pWeights not used,1=pWeights used][0=exact eWeights,1=non-exact eWeights][corr.'s index]
 421   TProfile2D *fProductsOfCorrelationsPro[2][2][2][5]; // [0=RP,1=POI][0=pW not used,1=pW used][0=exact eWeights,1=non-exact eWeights][products' index]
 422   TProfile2D *fCorrectionTermsPro[2][2][2][2][2]; // [0=RP,1=POI][0=pW not used,1=pW used][0=e eW,1=ne eW][0=sin terms,1=cos terms][corr. terms' index]
 423
 424   // 5.) distributions:
 425   TList *fDistributionsList; // list to hold all distributions
 426   TH1D *fDistributions[2][2][4]; // [0=pWeights not used,1=pWeights used][0=exact eWeights,1=non-exact eWeights][0=<2>,1=<4>,2=<6>,3=<8>]
 427
 428   // x.) debugging and cross-checking:
 429   TList *fNestedLoopsList; // list to hold all profiles filled with nested loops
 430   Bool_t fEvaluateIntFlowNestedLoops; // evaluate nested loops relevant for integrated flow
 431   Bool_t fEvaluateDiffFlowNestedLoops; // evaluate nested loops relevant for differential flow
 432   Int_t fMaxAllowedMultiplicity; // nested loops will be evaluated only for events with multiplicity <= fMaxAllowedMultiplicity
 433   TProfile *fEvaluateNestedLoops; // profile with four bins: fEvaluateIntFlowNestedLoops, fEvaluateDiffFlowNestedLoops, fCrossCheckInPtBinNo and fCrossCheckInEtaBinNo
 434   // integrated flow:
 435   TProfile *fIntFlowDirectCorrelations; // multiparticle correlations relevant for int. flow calculated with nested loops
 436   TProfile *fIntFlowExtraDirectCorrelations; // when particle weights are used some extra correlations appear
 437   TProfile *fIntFlowDirectCorrectionTermsForNUA[2]; // average correction terms for non-uniform acceptance evaluated with nested loops [0=sin terms,1=cos terms]
 438   // differential flow:
 439   Int_t fCrossCheckInPtBinNo; // cross-check results for reduced correlations and corrections in this pt bin
 440   Int_t fCrossCheckInEtaBinNo; // cross-check results for reduced correlations and corrections in this eta bin
 441   TProfile *fDiffFlowDirectCorrelations[2][2][4]; // [0=RP,1=POI][0=pt,1=eta][correlation index]
 442   TProfile *fDiffFlowDirectCorrectionTermsForNUA[2][2][2][10]; // [0=RP,1=POI][0=pt,1=eta][0=sin terms,1=cos terms][correction term index]
 443
 444   ClassDef(AliFlowAnalysisWithQCumulants, 0);
 445 };
 446
 447 //================================================================================================================
 448
 449 #endif
 450
 451
 452
 453
 454