skeleton for O2 analysis with multiparticle correlations (#984)

* skeleton for O2 analysis with multiparticle correlations

* Please consider the following formatting changes

* added copyright notice

* removed 2 trailing spaces, for formatting check to go through

* change of subdirectory structure

Co-authored-by: ALICE Action Bot <alibuild@cern.ch>

Author: abilandz

PWGCF/CMakeLists.txt

@@ -13,6 +13,7 @@ add_subdirectory(Core)
 # add_subdirectory(DataModel)
 add_subdirectory(GenericFramework)
 add_subdirectory(FemtoDream)
+add_subdirectory(MultiparticleCorrelations)
 add_subdirectory(Tasks)
 add_subdirectory(TableProducer)
 

PWGCF/MultiparticleCorrelations/CMakeLists.txt

@@ -0,0 +1,16 @@
+# Copyright 2019-2020 CERN and copyright holders of ALICE O2.
+# See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
+# All rights not expressly granted are reserved.
+#
+# This software is distributed under the terms of the GNU General Public
+# License v3 (GPL Version 3), copied verbatim in the file "COPYING".
+#
+# In applying this license CERN does not waive the privileges and immunities
+# granted to it by virtue of its status as an Intergovernmental Organization
+# or submit itself to any jurisdiction.
+
+add_subdirectory(Core)
+add_subdirectory(DataModel)
+add_subdirectory(TableProducer)
+add_subdirectory(Tasks)
+

PWGCF/MultiparticleCorrelations/Core/CMakeLists.txt

@@ -0,0 +1,10 @@
+# Copyright 2019-2020 CERN and copyright holders of ALICE O2.
+# See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
+# All rights not expressly granted are reserved.
+#
+# This software is distributed under the terms of the GNU General Public
+# License v3 (GPL Version 3), copied verbatim in the file "COPYING".
+#
+# In applying this license CERN does not waive the privileges and immunities
+# granted to it by virtue of its status as an Intergovernmental Organization
+# or submit itself to any jurisdiction.

PWGCF/MultiparticleCorrelations/Core/MuPa-Configurables.h

@@ -0,0 +1,15 @@
+// Copyright 2019-2020 CERN and copyright holders of ALICE O2.
+// See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
+// All rights not expressly granted are reserved.
+//
+// This software is distributed under the terms of the GNU General Public
+// License v3 (GPL Version 3), copied verbatim in the file "COPYING".
+//
+// In applying this license CERN does not waive the privileges and immunities
+// granted to it by virtue of its status as an Intergovernmental Organization
+// or submit itself to any jurisdiction.
+
+Configurable<float> Vz_min{"Vz_min", -10.0, "minimum vertex z range [cm]"};
+Configurable<float> Vz_max{"Vz_max", 10.0, "maximum vertex z range [cm]"};
+Configurable<float> pt_min{"pt_min", 0.2, "minimum track pt value [GeV/c]"};
+Configurable<float> pt_max{"pt_max", 5.0, "maximum track pt value [GeV/c]"};

PWGCF/MultiparticleCorrelations/Core/MuPa-DataMembers.h

@@ -0,0 +1,46 @@
+// Copyright 2019-2020 CERN and copyright holders of ALICE O2.
+// See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
+// All rights not expressly granted are reserved.
+//
+// This software is distributed under the terms of the GNU General Public
+// License v3 (GPL Version 3), copied verbatim in the file "COPYING".
+//
+// In applying this license CERN does not waive the privileges and immunities
+// granted to it by virtue of its status as an Intergovernmental Organization
+// or submit itself to any jurisdiction.
+
+// Remarks:
+// 0. Starting with C++11, it's possible to initialize data members at declaration, so I do it here
+// 1. Use //!<! for introducing a Doxygen comment interpreted as transient in both ROOT 5 and ROOT 6.
+
+// a) Base list to hold all output objects ("grandmother" of all lists);
+// *) QA;
+// *) Control event histograms;
+// *) Particle weights;
+
+// a) Base list to hold all output objects ("grandmother" of all lists):
+OutputObj<TList> fBaseList{"Task => ...", OutputObjHandlingPolicy::AnalysisObject, OutputObjSourceType::OutputObjSource};
+TProfile* fBasePro = NULL; //!<! keeps flags relevant for the whole analysis
+UInt_t fRandomSeed = 0;    // argument to TRandom3 constructor. By default is 0, use SetRandomSeed(...) to change it
+
+// *) QA:
+TList* fQAList = NULL; //!<! base list to hold all QA output object
+
+// *) Control event histograms:
+TList* fControlEventHistogramsList = NULL;   //!<! list to hold all control event histograms
+TProfile* fControlEventHistogramsPro = NULL; //!<! keeps flags relevant for the control event histograms
+struct ControlEventHistograms_Arrays {
+  TH1D* fMultiplicityHist[2] = {NULL}; //!<! distribution of multiplicity [before,after event cuts]
+} ceh_a;                               // "ceh_a" labels an instance of this group of histograms, e.g. ceha_a.fMultiplicityHist[0]
+
+// *) Particle weights:
+TList* fWeightsList = NULL;        //!<! list to hold all particle weights
+TProfile* fWeightsFlagsPro = NULL; //!<! profile to hold all flags for weights
+struct ParticleWeights_Arrays {
+  TH1D* fWeightsHist[gWeights] = {NULL}; //!<! particle weights
+} pw_a;                                  // "pw_a" labels an instance of this group of histograms, e.g. pw_a.fWeightsHist[0]
+
+// *) Results:
+TList* fResultsList = NULL;        //!<! list to hold all results
+TProfile* fResultsFlagsPro = NULL; //!<! profile to hold all flags for results
+TH1D* fResultsHist = NULL;         //!<! example histogram to store some results

PWGCF/MultiparticleCorrelations/Core/MuPa-Enums.h

@@ -0,0 +1,20 @@
+// Copyright 2019-2020 CERN and copyright holders of ALICE O2.
+// See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
+// All rights not expressly granted are reserved.
+//
+// This software is distributed under the terms of the GNU General Public
+// License v3 (GPL Version 3), copied verbatim in the file "COPYING".
+//
+// In applying this license CERN does not waive the privileges and immunities
+// granted to it by virtue of its status as an Intergovernmental Organization
+// or submit itself to any jurisdiction.
+
+enum eRecoSim { REC = 0,
+                SIM = 1 };
+enum eBeforeAfter { BEFORE = 0,
+                    AFTER = 1 };
+enum eWeights { wPHI = 0,
+                wPT = 1,
+                wETA = 2 };
+enum eDefaultColors { COLOR = kBlack,
+                      FILLCOLOR = kGray };

PWGCF/MultiparticleCorrelations/Core/MuPa-GlobalConstants.h

@@ -0,0 +1,12 @@
+// Copyright 2019-2020 CERN and copyright holders of ALICE O2.
+// See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
+// All rights not expressly granted are reserved.
+//
+// This software is distributed under the terms of the GNU General Public
+// License v3 (GPL Version 3), copied verbatim in the file "COPYING".
+//
+// In applying this license CERN does not waive the privileges and immunities
+// granted to it by virtue of its status as an Intergovernmental Organization
+// or submit itself to any jurisdiction.
+
+const Int_t gWeights = 3; // phi, pt, eta