AliClusterContainer.cxx

Go to the documentation of this file.

/**************************************************************************
 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 *                                                                        *
 * Author: The ALICE Off-line Project.                                    *
 * Contributors are mentioned in the code where appropriate.              *
 *                                                                        *
 * Permission to use, copy, modify and distribute this software and its   *
 * documentation strictly for non-commercial purposes is hereby granted   *
 * without fee, provided that the above copyright notice appears in all   *
 * copies and that both the copyright notice and this permission notice   *
 * appear in the supporting documentation. The authors make no claims     *
 * about the suitability of this software for any purpose. It is          *
 * provided "as is" without express or implied warranty.                  *
 **************************************************************************/
#include <algorithm>
#include <iostream>
#include <vector>
#include <TClonesArray.h>

#include "AliVEvent.h"
#include "AliLog.h"
#include "AliTLorentzVector.h"

#include "AliClusterContainer.h"

ClassImp(AliClusterContainer)

AliClusterContainer::AliClusterContainer():
  AliEmcalContainer(),
  fClusTimeCutLow(-10),
  fClusTimeCutUp(10),
  fExoticCut(kTRUE),
  fDefaultClusterEnergy(-1)
{
  fClassName = "AliVCluster";

  for (Int_t i = 0; i <= AliVCluster::kLastUserDefEnergy; i++) {
    fUserDefEnergyCut[i] = 0.;
  }
}

AliClusterContainer::AliClusterContainer(const char *name):
  AliEmcalContainer(name),
  fClusTimeCutLow(-10),
  fClusTimeCutUp(10),
  fExoticCut(kTRUE),
  fDefaultClusterEnergy(-1)
{
  fClassName = "AliVCluster";

  for (Int_t i = 0; i <= AliVCluster::kLastUserDefEnergy; i++) {
    fUserDefEnergyCut[i] = 0.;
  }
}

AliVCluster* AliClusterContainer::GetLeadingCluster(const char* opt)
{
  TString option(opt);
  option.ToLower();

  Int_t tempID = fCurrentID;
  ResetCurrentID();

  AliVCluster *clusterMax = GetNextAcceptCluster();
  AliVCluster *cluster = 0;

  if (option.Contains("e")) {
    while ((cluster = GetNextAcceptCluster())) {
      if (cluster->E() > clusterMax->E()) clusterMax = cluster;
    }
  }
  else {
    Double_t et = 0;
    Double_t etmax = 0;
    while ((cluster = GetNextAcceptCluster())) {
      TLorentzVector mom;
      cluster->GetMomentum(mom,const_cast<Double_t*>(fVertex));
      et = mom.Et();
      if (et > etmax) { 
  clusterMax = cluster;
  etmax = et;
      }
    }
  }

  fCurrentID = tempID;

  return clusterMax;
}

AliVCluster* AliClusterContainer::GetCluster(Int_t i) const 
{
  if(i<0 || i>fClArray->GetEntriesFast()) return 0;
  AliVCluster *vp = static_cast<AliVCluster*>(fClArray->At(i));
  return vp;

}

AliVCluster* AliClusterContainer::GetAcceptCluster(Int_t i) const
{
  AliVCluster *vc = GetCluster(i);
  if (!vc) return 0;

  UInt_t rejectionReason = 0;
  if (AcceptCluster(vc, rejectionReason))
    return vc;
  else {
    AliDebug(2,"Cluster not accepted.");
    return 0;
  }
}

AliVCluster* AliClusterContainer::GetClusterWithLabel(Int_t lab) const 
{
  Int_t i = GetIndexFromLabel(lab);
  return GetCluster(i);
}

AliVCluster* AliClusterContainer::GetAcceptClusterWithLabel(Int_t lab) const
{
  Int_t i = GetIndexFromLabel(lab);
  return GetAcceptCluster(i);
}

AliVCluster* AliClusterContainer::GetNextAcceptCluster() 
{
  const Int_t n = GetNEntries();
  AliVCluster *c = 0;
  do {
    fCurrentID++;
    if (fCurrentID >= n) break;
    c = GetAcceptCluster(fCurrentID);
  } while (!c);

  return c;
}

AliVCluster* AliClusterContainer::GetNextCluster() 
{
  const Int_t n = GetNEntries();
  AliVCluster *c = 0;
  do {
    fCurrentID++;
    if (fCurrentID >= n) break;
    c = GetCluster(fCurrentID);
  } while (!c);

  return c;
}

Bool_t AliClusterContainer::GetMomentum(TLorentzVector &mom, const AliVCluster* vc, Double_t mass) const
{
  if (mass < 0) mass = 0;

  Double_t energy = 0;

  if (fDefaultClusterEnergy >= 0 &&  fDefaultClusterEnergy <= AliVCluster::kLastUserDefEnergy) {
    energy = vc->GetUserDefEnergy((AliVCluster::VCluUserDefEnergy_t)fDefaultClusterEnergy);
  }
  else {
    energy = vc->E();
  }

  Double_t p = TMath::Sqrt(energy*energy - mass*mass);

  Float_t pos[3];
  vc->GetPosition(pos);

  pos[0]-=fVertex[0];
  pos[1]-=fVertex[1];
  pos[2]-=fVertex[2];

  Double_t r = TMath::Sqrt(pos[0]*pos[0]+pos[1]*pos[1]+pos[2]*pos[2]) ;

  if (r > 1e-12) {
    mom.SetPxPyPzE( p*pos[0]/r,  p*pos[1]/r,  p*pos[2]/r, energy) ;
  }
  else {
    AliInfo("Null cluster radius, momentum calculation not possible");
    return kFALSE;
  }

  return kTRUE;
}

Bool_t AliClusterContainer::GetMomentum(TLorentzVector &mom, const AliVCluster* vc) const
{
  if (fMassHypothesis > 0) return GetMomentum(mom, vc, fMassHypothesis);

  if (vc) {
    if (fDefaultClusterEnergy >= 0 &&  fDefaultClusterEnergy <= AliVCluster::kLastUserDefEnergy) {
      vc->GetMomentum(mom, fVertex, (AliVCluster::VCluUserDefEnergy_t)fDefaultClusterEnergy);
    }
    else {
      vc->GetMomentum(mom, fVertex);
    }
  }
  else {
    mom.SetPtEtaPhiM(0, 0, 0, 0.139);
    return kFALSE;
  }
  return kTRUE;
}

Bool_t AliClusterContainer::GetMomentum(TLorentzVector &mom, Int_t i) const
{
  AliVCluster *vc = GetCluster(i);
  return GetMomentum(mom, vc);
}

Bool_t AliClusterContainer::GetNextMomentum(TLorentzVector &mom)
{
  AliVCluster *vc = GetNextCluster();
  return GetMomentum(mom, vc);
}

Bool_t AliClusterContainer::GetAcceptMomentum(TLorentzVector &mom, Int_t i) const
{
  AliVCluster *vc = GetAcceptCluster(i);
  return GetMomentum(mom, vc);
}

Bool_t AliClusterContainer::GetNextAcceptMomentum(TLorentzVector &mom)
{
  AliVCluster *vc = GetNextAcceptCluster();
  return GetMomentum(mom, vc);
}

Bool_t AliClusterContainer::AcceptCluster(Int_t i, UInt_t &rejectionReason) const
{
  Bool_t r = ApplyClusterCuts(GetCluster(i), rejectionReason);
  if (!r) return kFALSE;

  AliTLorentzVector mom;
  GetMomentum(mom, i);

  return ApplyKinematicCuts(mom, rejectionReason);
}

Bool_t AliClusterContainer::AcceptCluster(const AliVCluster* clus, UInt_t &rejectionReason) const
{
  Bool_t r = ApplyClusterCuts(clus, rejectionReason);
  if (!r) return kFALSE;

  AliTLorentzVector mom;
  GetMomentum(mom, clus);

  return ApplyKinematicCuts(mom, rejectionReason);
}

Bool_t AliClusterContainer::ApplyClusterCuts(const AliVCluster* clus, UInt_t &rejectionReason) const
{
  if (!clus) {
    rejectionReason |= kNullObject;
    return kFALSE;
  }
      
  if (!clus->IsEMCAL()) {
    rejectionReason |= kIsEMCalCut;
    return kFALSE;
  }

  if (clus->TestBits(fBitMap) != (Int_t)fBitMap) {
    rejectionReason |= kBitMapCut;
    return kFALSE;
  }

  if (fMinMCLabel >= 0 && TMath::Abs(clus->GetLabel()) > fMinMCLabel) {
    rejectionReason |= kMCLabelCut;
    return kFALSE;
  }

  if (fMaxMCLabel >= 0 && TMath::Abs(clus->GetLabel()) < fMaxMCLabel) {
    rejectionReason |= kMCLabelCut;
    return kFALSE;
  }

  if (clus->GetTOF() > fClusTimeCutUp || clus->GetTOF() < fClusTimeCutLow) {
    rejectionReason |= kTimeCut;
    return kFALSE;
  }

  if (fExoticCut && clus->GetIsExotic()) {
    rejectionReason |= kExoticCut;
    return kFALSE;
  }
  
  for (Int_t i = 0; i <= AliVCluster::kLastUserDefEnergy; i++) {
    if (clus->GetUserDefEnergy((VCluUserDefEnergy_t)i) < fUserDefEnergyCut[i]) {
      rejectionReason |= kEnergyCut;
      return kFALSE;
    }
  }
  
  return kTRUE;
}

Int_t AliClusterContainer::GetNAcceptedClusters() const
{
  UInt_t rejectionReason = 0;
  Int_t nClus = 0;
  for(int iclust = 0; iclust < this->fClArray->GetEntries(); ++iclust){
    AliVCluster *clust = this->GetCluster(iclust);
    if(this->AcceptCluster(clust, rejectionReason)) nClus++;
  }
  return nClus;
}

Double_t AliClusterContainer::GetClusUserDefEnergyCut(Int_t t) const
{
  if (t >= 0 && t <= AliVCluster::kLastUserDefEnergy){
    return fUserDefEnergyCut[t];
  }
  else {
    return fMinE;
  }
}

void AliClusterContainer::SetClusUserDefEnergyCut(Int_t t, Double_t cut)
{
  if (t >= 0 && t <= AliVCluster::kLastUserDefEnergy){
    fUserDefEnergyCut[t] = cut;
  }
  else {
    fMinE = cut;
  }
}


void AliClusterContainer::SetClassName(const char *clname)
{
  TClass cls(clname);
  if (cls.InheritsFrom("AliVCluster")) fClassName = clname;
  else AliError(Form("Unable to set class name %s for a AliClusterContainer, it must inherits from AliVCluster!",clname));
}

const char* AliClusterContainer::GetTitle() const
{
  static TString clusterString;

  Double_t Ecut = GetClusUserDefEnergyCut(GetDefaultClusterEnergy());

  if (Ecut == 0) {
    clusterString = TString::Format("%s_E0000", GetArrayName().Data());
  }
  else if (Ecut < 1.0) {
    clusterString = TString::Format("%s_E0%3.0f", GetArrayName().Data(), Ecut*1000.0);
  }
  else {
    clusterString = TString::Format("%s_E%4.0f", GetArrayName().Data(), Ecut*1000.0);
  }

  return clusterString.Data();
}

AliClusterContainer::all_iterator AliClusterContainer::begin() const{
  return all_iterator(this, 0, true);
}

AliClusterContainer::all_iterator AliClusterContainer::end() const{
  return all_iterator(this, this->GetNClusters(), true);
}

AliClusterContainer::all_iterator AliClusterContainer::rbegin() const{
  return all_iterator(this, this->GetNClusters()-1, false);
}

AliClusterContainer::all_iterator AliClusterContainer::rend() const{
  return all_iterator(this, -1, false);
}

AliClusterContainer::accept_iterator AliClusterContainer::accept_begin() const{
  return accept_iterator(this, 0, true);
}

AliClusterContainer::accept_iterator AliClusterContainer::accept_end() const{
  return accept_iterator(this, this->GetNAcceptedClusters(), true);
}

AliClusterContainer::accept_iterator AliClusterContainer::accept_rbegin() const{
  return accept_iterator(this, this->GetNAcceptedClusters()-1, false);
}

AliClusterContainer::accept_iterator AliClusterContainer::accept_rend() const{
  return accept_iterator(this, -1, false);
}



AliClusterContainer::accept_iterator::accept_iterator(
    const AliClusterContainer *cont,
    int start,
    bool forward):
    fkContainer(cont),
    fAcceptIndices(),
    fCurrentPos(start),
    fForward(forward)
{
  fAcceptIndices.Set(fkContainer->GetNAcceptedClusters());
  UInt_t rejection = 0;
  Int_t mappos = 0;
  for(int i = 0; i < fkContainer->GetNEntries(); i++){
    if(fkContainer->AcceptCluster(i, rejection)){
      fAcceptIndices[mappos++] = i;
    }
  }
}

AliClusterContainer::accept_iterator::accept_iterator(const accept_iterator &other):
    fkContainer(other.fkContainer),
    fAcceptIndices(other.fAcceptIndices),
    fCurrentPos(other.fCurrentPos),
    fForward(other.fForward)
{
}

AliClusterContainer::accept_iterator &AliClusterContainer::accept_iterator::operator=(const AliClusterContainer::accept_iterator &other){
  if(this != &other){
    fkContainer = other.fkContainer;
    fAcceptIndices = other.fAcceptIndices;
    fCurrentPos = other.fCurrentPos;
    fForward = other.fForward;
  }
  return *this;
}

bool AliClusterContainer::accept_iterator::operator!=(const AliClusterContainer::accept_iterator &other) const{
  return fCurrentPos != other.fCurrentPos;
}

AliClusterContainer::accept_iterator &AliClusterContainer::accept_iterator::operator++(){
  if(fForward){
    fCurrentPos++;
  } else {
    fCurrentPos--;
  }
  return *this;
}

AliClusterContainer::accept_iterator AliClusterContainer::accept_iterator::operator++(int){
  AliClusterContainer::accept_iterator result(*this);
  this->operator++();
  return result;
}

AliClusterContainer::accept_iterator &AliClusterContainer::accept_iterator::operator--(){
  if(fForward){
    fCurrentPos--;
  } else {
    fCurrentPos++;
  }
  return *this;
}

AliClusterContainer::accept_iterator AliClusterContainer::accept_iterator::operator--(int){
  AliClusterContainer::accept_iterator result(*this);
  this->operator++();
  return result;
}

AliVCluster *AliClusterContainer::accept_iterator::operator*() const{
  if(fCurrentPos < 0 || fCurrentPos >= fAcceptIndices.GetSize()){
    return NULL;
  }
  return fkContainer->GetCluster(fAcceptIndices[fCurrentPos]);
}


AliClusterContainer::all_iterator::all_iterator(
    const AliClusterContainer *cont,
    int startpos,
    bool forward):
    fkContainer(cont),
    fCurrentPos(startpos),
    fForward(forward)
{
}

AliClusterContainer::all_iterator::all_iterator(const all_iterator &other):
    fkContainer(other.fkContainer),
    fCurrentPos(other.fCurrentPos),
    fForward(other.fForward)
{
}

AliClusterContainer::all_iterator &AliClusterContainer::all_iterator::operator=(const AliClusterContainer::all_iterator &other){
  if(&other != this){
    fkContainer = other.fkContainer;
    fCurrentPos = other.fCurrentPos;
    fForward = other.fForward;
  }
  return *this;
}

bool AliClusterContainer::all_iterator::operator!=(const AliClusterContainer::all_iterator &other) const{
  return other.fCurrentPos != fCurrentPos;
}

AliClusterContainer::all_iterator &AliClusterContainer::all_iterator::operator++(){
  if(fForward){
    fCurrentPos++;
  } else {
    fCurrentPos--;
  }
  return *this;
}

AliClusterContainer::all_iterator AliClusterContainer::all_iterator::operator++(int){
  all_iterator tmp(*this);
  operator++();
  return tmp;
}

AliClusterContainer::all_iterator &AliClusterContainer::all_iterator::operator--(){
  if(fForward){
    fCurrentPos--;
  } else {
    fCurrentPos++;
  }
  return *this;
}

AliClusterContainer::all_iterator AliClusterContainer::all_iterator::operator--(int){
  all_iterator tmp(*this);
  operator--();
  return tmp;
}

AliVCluster *AliClusterContainer::all_iterator::operator*() const{
  if(fCurrentPos >= 0 && fCurrentPos < fkContainer->GetNClusters())
    return fkContainer->GetCluster(fCurrentPos);
  return NULL;
}

/******************************************
 * Unit tests                             *
 ******************************************/

int TestClusterContainerIterator(const AliClusterContainer *const cont, int iteratorType, bool verbose){
  std::vector<AliVCluster *> reference, variation;
  AliVCluster *test = NULL;
  for(int iclust = 0; iclust < cont->GetNClusters(); iclust++){
    test = cont->GetCluster(iclust);
    if(!iteratorType){
      UInt_t rejectionReason = 0;
      if(!cont->AcceptCluster(test, rejectionReason)) continue;
    }
    reference.push_back(test);
  }

  if(!iteratorType){
    // test accept iterator
    for(AliClusterContainer::accept_iterator iter = cont->accept_begin(); iter != cont->accept_end(); ++iter){
      variation.push_back(*iter);
    }
  } else {
    // test all iterator
    for(AliClusterContainer::all_iterator iter = cont->begin(); iter != cont->end(); ++iter){
      variation.push_back(*iter);
    }
  }

  if(verbose){
    // Printing cluster addresses:
    if(reference.size() < 30){
      std::cout << "Clusters in reference container: " << std::endl;
      std::cout << "===========================================" << std::endl;
      for(std::vector<AliVCluster *>::iterator refit = reference.begin(); refit != reference.end(); ++refit){
        std::cout << "Address: " << *refit << std::endl;
      }
    }
    if(variation.size() < 30){
      std::cout << "Clusters in test container: " << std::endl;
      std::cout << "===========================================" << std::endl;
      for(std::vector<AliVCluster *>::iterator varit = variation.begin(); varit != variation.end(); ++varit){
        std::cout << "Address: " << *varit << std::endl;
      }
    }
  }

  int testresult = 0;
  // compare distributions: all clusters in one vector needs to be found in the other vector and vice versa
  bool failure = false;
  // first test: cleck if all clusters are found by the iterator
  for(std::vector<AliVCluster *>::iterator clit = reference.begin(); clit != reference.end(); ++clit){
    if(std::find(variation.begin(), variation.end(), *clit) == variation.end()) {
      if(verbose)
        std::cout << "Could not find cluster with address " << *clit << " in test container" << std::endl;
      failure = true;
      break;
    }
  }
  if(!failure){
    // second test: check if there are no extra clusters found
    for(std::vector<AliVCluster *>::iterator clit = variation.begin(); clit != variation.end(); ++clit){
      if(std::find(reference.begin(), reference.end(), *clit) == reference.end()) {
        if(verbose)
          std::cout << "Could not find cluster with address " << *clit << " in reference container" << std::endl;
        failure = true;
        break;
      }
    }
    if(failure) testresult = 2;
  } else {
    testresult = 1;
  }

  if(verbose){
    std::cout << "Unit test cluster container, iterator type " << iteratorType << std::endl;
    std::cout << "Number of expected clusters: " << reference.size() << ", number of found clusters: " << variation.size() << std::endl;
    std::cout << "Test result: " << testresult << std::endl;
    std::cout << "-----------------------------------------------------------------------" << std::endl;
  }
  return testresult;
}