MuonAnalysis/MomentumScaleCalibration/interface/BackgroundHandler.h - master - githubmirror/cmssw

MuonAnalysis/MomentumScaleCalibration/interface/BackgroundHandler.h
145 строк7 KB
Cms Build
Clang-Format
03 июн 2019, 06:45
03 июн 2019, 06:45d4f6565
#ifndef BackgroundHandler_h
#define BackgroundHandler_h

#include "MuonAnalysis/MomentumScaleCalibration/interface/Functions.h"
#include "FWCore/MessageLogger/interface/MessageLogger.h"
#include <vector>
#include "MuonAnalysis/MomentumScaleCalibration/interface/MassWindow.h"
#include "DataFormats/HepMCCandidate/interface/GenParticle.h"
#include "SimDataFormats/Track/interface/SimTrack.h"
#include "DataFormats/Candidate/interface/LeafCandidate.h"
#include "DataFormats/Math/interface/LorentzVector.h"
#include <CLHEP/Vector/LorentzVector.h>
#include "DataFormats/MuonReco/interface/Muon.h"
#include "DataFormats/MuonReco/interface/MuonFwd.h"
#include "SimDataFormats/GeneratorProducts/interface/HepMCProduct.h"
#include "DataFormats/HepMCCandidate/interface/GenParticleFwd.h"
#include "SimDataFormats/Track/interface/SimTrackContainer.h"
#include "FWCore/MessageLogger/interface/MessageLogger.h"

// Unit test for testing BackgroundHandler
class TestBackgroundHandler;

/**
 * This class is used to handle the different background functions for the
 * different regions. <br>
 * It uses the backgroundFunctions defined in Functions.h and the
 * backgroundFunctionService defined in Functions.cc. <br>
 * More details are in the description of backgroundFunctionBase in Functions.h. <br>
 * <br>
 * A bool selects if to use the regions functions or the resonances functions.
 */
class BackgroundHandler {
  // For tests
  friend class TestBackgroundHandler;

public:
  BackgroundHandler(const std::vector<int>& identifiers,
                    const std::vector<double>& leftWindowBorders,
                    const std::vector<double>& rightWindowBorders,
                    const double* ResMass,
                    const double* massWindowHalfWidth);
  ~BackgroundHandler();

  /// Initialize the parNums to be used in the shifts of parval
  void initializeParNums();

  /// Returns the total number of parameters used for the regions
  inline int regionsParNum() { return parNumsResonances_[0]; }

  /// Check if the mass value is inside the given background region
  bool checkBackgroundWindow(const double& mass, const int iRegion) { return backgroundWindow_[iRegion].isIn(mass); }

  void countEventsInAllWindows(
      const std::vector<std::pair<reco::Particle::LorentzVector, reco::Particle::LorentzVector> >& muonPairs,
      const double& weight);

  /// Sets initial parameters for all the functions
  void setParameters(double* Start,
                     double* Step,
                     double* Mini,
                     double* Maxi,
                     int* ind,
                     TString* parname,
                     const std::vector<double>& parBgr,
                     const std::vector<int>& parBgrOrder,
                     const int muonType);

  /// returns true if the parameter is to be unlocked
  bool unlockParameter(const std::vector<int>& resfind, const unsigned int ipar);

  /// Returns the appropriate window borders depending on whether the background is being fitted and on the resonance
  std::pair<double, double> windowBorders(const bool doBackgroundFit, const int ires);

  /**
   * Returns the appropriate resMass value depending on whether the background is being fitted and on the resonance. <br>
   * The resMass used for the region is the mean of the mass of the corresponding resonances, so for the Z is the same Z mass,
   * for the Upsilons is the arithmetic mean of the Upsilon masses and the same for the J/Psi and Psi2S region.
   */
  double resMass(const bool doBackgroundFit, const int ires);

  /**
   * Computes the rescaled parameters from the regions functions to the
   * resonances functions. It takes into account the difference in intervals
   * and rescales the parameters so that the fraction of events is correctly accounted for. <br>
   * It uses the list of all muon pairs to compute the number of events in each resonance window.
   */
  void rescale(std::vector<double>& parBgr,
               const double* ResMass,
               const double* massWindowHalfWidth,
               const std::vector<std::pair<reco::Particle::LorentzVector, reco::Particle::LorentzVector> >& muonPairs,
               const double& weight = 1.);

  /**
   * Returns the background fraction parameter (parBgr[0], but shifted to the correct function) and
   * the value returned by the background function. <br>
   * Depending on the value of doBackgroundFit it returns the values for the regions or the resonances.
   */
  std::pair<double, double> backgroundFunction(const bool doBackgroundFit,
                                               const double* parval,
                                               const int resTotNum,
                                               const int ires,
                                               const bool* resConsidered,
                                               const double* ResMass,
                                               const double ResHalfWidth[],
                                               /* const int MuonType, const double & mass, const double & resEta ); */
                                               const int MuonType,
                                               const double& mass,
                                               const double& eta1,
                                               const double& eta2);

private:
  /// Used to check the consistency of passed parameters
  void consistencyCheck(const std::vector<int>& identifiers,
                        const std::vector<double>& leftWindowBorders,
                        const std::vector<double>& rightWindowBorders) const noexcept(false);

  // Correspondence between regions and halfWidths used:
  // - for the Upsilons region we use the Upsilon
  // - for the J/Psi and Psi2S region we use the J/Psi
  int regToResHW_[3];

  // Correspondence between resonances and regions:
  // - Z -> region 0
  // - Uspilons -> region 1
  // - J/Psi and Psi2S -> region 2
  int resToReg_[6];

  // Used in the shifts of the parval
  // Contains 0 as the first number and Sum_0^(ires-1)(parNum(i)) for the rest,
  // so that calling parNums[ires] returns the sum of the number of parameters
  // of the previous functions (0 if none) and allows to shift the parval to the
  // parameters of the actual function.
  int parNumsRegions_[3];
  // These start from the correct parameters (take into account that the parRegions are
  // before the parResonances).
  int parNumsResonances_[6];

  // std::vector<double> leftWindowFactors_;
  // std::vector<double> rightWindowFactors_;

  std::vector<MassWindow> resonanceWindow_;
  std::vector<MassWindow> backgroundWindow_;
};

#endif  // BackgroundHandler_h