GlobalTrackQualityProducer.cc

Go to the documentation of this file.

// -*- C++ -*-
//
// Package:    GlobalTrackingTools
// Class:      GlobalTrackQualityProducer
//
//
// Original Author:  Adam Everett
//
//

// system include files
#include <memory>

// user include files
#include "FWCore/Framework/interface/Frameworkfwd.h"
#include "FWCore/Framework/interface/EDProducer.h"
#include "FWCore/Utilities/interface/isFinite.h"

#include "CommonTools/Statistics/interface/ChiSquaredProbability.h"
#include "RecoMuon/GlobalTrackingTools/plugins/GlobalTrackQualityProducer.h"

#include "TrackingTools/PatternTools/interface/TrajectoryMeasurement.h"
#include "TrackingTools/PatternTools/interface/Trajectory.h"
#include "Geometry/Records/interface/TrackerTopologyRcd.h"
#include "DataFormats/TrackerCommon/interface/TrackerTopology.h"

GlobalTrackQualityProducer::GlobalTrackQualityProducer(const edm::ParameterSet& iConfig):
  inputCollection_(iConfig.getParameter<edm::InputTag>("InputCollection")),inputLinksCollection_(iConfig.getParameter<edm::InputTag>("InputLinksCollection")),theService(nullptr),theGlbRefitter(nullptr),theGlbMatcher(nullptr)
{
  // service parameters
  edm::ParameterSet serviceParameters = iConfig.getParameter<edm::ParameterSet>("ServiceParameters");
  theService = new MuonServiceProxy(serviceParameters);

  // TrackRefitter parameters
  edm::ConsumesCollector iC  = consumesCollector();
  edm::ParameterSet refitterParameters = iConfig.getParameter<edm::ParameterSet>("RefitterParameters");
  theGlbRefitter = new GlobalMuonRefitter(refitterParameters, theService, iC);

  edm::ParameterSet trackMatcherPSet = iConfig.getParameter<edm::ParameterSet>("GlobalMuonTrackMatcher");
  theGlbMatcher = new GlobalMuonTrackMatcher(trackMatcherPSet,theService);

  double maxChi2 = iConfig.getParameter<double>("MaxChi2");
  double nSigma = iConfig.getParameter<double>("nSigma");
  theEstimator = new Chi2MeasurementEstimator(maxChi2,nSigma);

  glbMuonsToken=consumes<reco::TrackCollection>(inputCollection_);
  linkCollectionToken=consumes<reco::MuonTrackLinksCollection>(inputLinksCollection_);

  produces<edm::ValueMap<reco::MuonQuality> >();
}

GlobalTrackQualityProducer::~GlobalTrackQualityProducer() {
  if (theService) delete theService;
  if (theGlbRefitter) delete theGlbRefitter;
  if (theGlbMatcher) delete theGlbMatcher;
  if (theEstimator) delete theEstimator;
}

void
GlobalTrackQualityProducer::produce(edm::Event& iEvent, const edm::EventSetup& iSetup)
{
  const std::string theCategory = "Muon|RecoMuon|GlobalTrackQualityProducer";

  theService->update(iSetup);

  theGlbRefitter->setEvent(iEvent);

  theGlbRefitter->setServices(theService->eventSetup());

  // Take the GLB muon container(s)
  edm::Handle<reco::TrackCollection> glbMuons;
  iEvent.getByToken(glbMuonsToken,glbMuons);

  edm::Handle<reco::MuonTrackLinksCollection>    linkCollectionHandle;
  iEvent.getByToken(linkCollectionToken,linkCollectionHandle);

  //Retrieve tracker topology from geometry
  edm::ESHandle<TrackerTopology> tTopoHand;
  iSetup.get<TrackerTopologyRcd>().get(tTopoHand);
  const TrackerTopology *tTopo=tTopoHand.product();


  // reserve some space
  std::vector<reco::MuonQuality> valuesQual;
  valuesQual.reserve(glbMuons->size());

  int trackIndex = 0;
  for (reco::TrackCollection::const_iterator track = glbMuons->begin(); track!=glbMuons->end(); ++track , ++trackIndex) {
    reco::TrackRef glbRef(glbMuons,trackIndex);
    reco::TrackRef staTrack = reco::TrackRef();

    std::vector<Trajectory> refitted=theGlbRefitter->refit(*track,1,tTopo);

    LogTrace(theCategory)<<"GLBQual N refitted " << refitted.size();

    std::pair<double,double> thisKink;
    double relative_muon_chi2 = 0.0;
    double relative_tracker_chi2 = 0.0;
    double glbTrackProbability = 0.0;
    if(!refitted.empty()) {
      thisKink = kink(refitted.front()) ;
      std::pair<double,double> chi = newChi2(refitted.front());
      relative_muon_chi2 = chi.second; //normalized inside to /sum(muHits.dimension)
      relative_tracker_chi2 = chi.first; //normalized inside to /sum(tkHits.dimension)
      glbTrackProbability = trackProbability(refitted.front());
    }

    LogTrace(theCategory)<<"GLBQual: Kink " << thisKink.first << " " << thisKink.second;
    LogTrace(theCategory)<<"GLBQual: Rel Chi2 " << relative_tracker_chi2 << " " << relative_muon_chi2;
    LogTrace(theCategory)<<"GLBQual: trackProbability " << glbTrackProbability;

    // Fill the STA-TK match information
    float chi2, d, dist, Rpos;
    chi2 = d = dist = Rpos = -1.0;
    bool passTight = false;
    typedef MuonTrajectoryBuilder::TrackCand TrackCand;
    if ( linkCollectionHandle.isValid() ) {
      for ( reco::MuonTrackLinksCollection::const_iterator links = linkCollectionHandle->begin();
        links != linkCollectionHandle->end(); ++links )
    {
      if ( links->trackerTrack().isNull() ||
           links->standAloneTrack().isNull() ||
           links->globalTrack().isNull() )
        {
          edm::LogWarning(theCategory) << "Global muon links to constituent tracks are invalid. There should be no such object. Muon is skipped.";
          continue;
        }
      if (links->globalTrack() == glbRef) {
        staTrack = !links->standAloneTrack().isNull() ? links->standAloneTrack() : reco::TrackRef();
        TrackCand staCand = TrackCand((Trajectory*)nullptr,links->standAloneTrack());
        TrackCand tkCand = TrackCand((Trajectory*)nullptr,links->trackerTrack());
        chi2 = theGlbMatcher->match(staCand,tkCand,0,0);
        d    = theGlbMatcher->match(staCand,tkCand,1,0);
        Rpos = theGlbMatcher->match(staCand,tkCand,2,0);
        dist = theGlbMatcher->match(staCand,tkCand,3,0);
        passTight = theGlbMatcher->matchTight(staCand,tkCand);
      }
    }
    }

    if(!staTrack.isNull()) LogTrace(theCategory)<<"GLBQual: Used UpdatedAtVtx : " <<  (iEvent.getProvenance(staTrack.id()).productInstanceName() == std::string("UpdatedAtVtx"));

    float maxFloat01 = std::numeric_limits<float>::max()*0.1; // a better solution would be to use float above .. m/be not
    reco::MuonQuality muQual;
    if(!staTrack.isNull()) muQual.updatedSta = iEvent.getProvenance(staTrack.id()).productInstanceName() == std::string("UpdatedAtVtx");
    muQual.trkKink    = thisKink.first > maxFloat01 ? maxFloat01 : thisKink.first;
    muQual.glbKink    = thisKink.second > maxFloat01 ? maxFloat01 : thisKink.second;
    muQual.trkRelChi2 = relative_tracker_chi2 > maxFloat01 ? maxFloat01 : relative_tracker_chi2;
    muQual.staRelChi2 = relative_muon_chi2 > maxFloat01 ? maxFloat01 : relative_muon_chi2;
    muQual.tightMatch = passTight;
    muQual.chi2LocalPosition = dist;
    muQual.chi2LocalMomentum = chi2;
    muQual.localDistance = d;
    muQual.globalDeltaEtaPhi = Rpos;
    muQual.glbTrackProbability = glbTrackProbability;
    valuesQual.push_back(muQual);
  }

  /*
  for(int i = 0; i < valuesTkRelChi2.size(); i++) {
    LogTrace(theCategory)<<"value " << valuesTkRelChi2[i] ;
  }
  */

  // create and fill value maps
  auto outQual = std::make_unique<edm::ValueMap<reco::MuonQuality>>();
  edm::ValueMap<reco::MuonQuality>::Filler fillerQual(*outQual);
  fillerQual.insert(glbMuons, valuesQual.begin(), valuesQual.end());
  fillerQual.fill();

  // put value map into event
  iEvent.put(std::move(outQual));
}

std::pair<double,double> GlobalTrackQualityProducer::kink(Trajectory& muon) const {

  const std::string theCategory = "Muon|RecoMuon|GlobalTrackQualityProducer";

  using namespace std;
  using namespace edm;
  using namespace reco;

  double result = 0.0;
  double resultGlb = 0.0;


  typedef TransientTrackingRecHit::ConstRecHitPointer   ConstRecHitPointer;
  typedef ConstRecHitPointer RecHit;
  typedef std::vector<TrajectoryMeasurement>::const_iterator TMI;


  vector<TrajectoryMeasurement> meas = muon.measurements();

  for ( TMI m = meas.begin(); m != meas.end(); m++ ) {
    TransientTrackingRecHit::ConstRecHitPointer hit = m->recHit();

    //not used    double estimate = 0.0;

    RecHit rhit = (*m).recHit();
    bool ok = false;
    if ( rhit->isValid() ) {
      if(DetId::Tracker == rhit->geographicalId().det()) ok = true;
    }

    //if ( !ok ) continue;

    const TrajectoryStateOnSurface& tsos = (*m).predictedState();


    if ( tsos.isValid() && rhit->isValid() && rhit->hit()->isValid()
     && !edm::isNotFinite(rhit->localPositionError().xx()) //this is paranoia induced by reported case
     && !edm::isNotFinite(rhit->localPositionError().xy()) //it's better to track down the origin of bad numbers
     && !edm::isNotFinite(rhit->localPositionError().yy())
     ) {

      double phi1 = tsos.globalPosition().phi();
      if ( phi1 < 0 ) phi1 = 2*M_PI + phi1;

      double phi2 = rhit->globalPosition().phi();
      if ( phi2 < 0 ) phi2 = 2*M_PI + phi2;

      double diff = fabs(phi1 - phi2);
      if ( diff > M_PI ) diff = 2*M_PI - diff;

      GlobalPoint hitPos = rhit->globalPosition();

      GlobalError hitErr = rhit->globalPositionError();
      //LogDebug(theCategory)<<"hitPos " << hitPos;
      double error = hitErr.phierr(hitPos);  // error squared

      double s = ( error > 0.0 ) ? (diff*diff)/error : (diff*diff);

      if(ok) result += s;
      resultGlb += s;
    }

  }


  return std::pair<double,double>(result,resultGlb);

}

std::pair<double,double> GlobalTrackQualityProducer::newChi2(Trajectory& muon) const {
  const std::string theCategory = "Muon|RecoMuon|GlobalTrackQualityProducer";

  using namespace std;
  using namespace edm;
  using namespace reco;

  double muChi2 = 0.0;
  double tkChi2 = 0.0;
  unsigned int muNdof = 0;
  unsigned int tkNdof = 0;

  typedef TransientTrackingRecHit::ConstRecHitPointer   ConstRecHitPointer;
  typedef ConstRecHitPointer RecHit;
  typedef vector<TrajectoryMeasurement>::const_iterator TMI;

  vector<TrajectoryMeasurement> meas = muon.measurements();

  for ( TMI m = meas.begin(); m != meas.end(); m++ ) {
    TransientTrackingRecHit::ConstRecHitPointer hit = m->recHit();
    const TrajectoryStateOnSurface& uptsos = (*m).updatedState();
    // FIXME FIXME CLONE!!!
    // TrackingRecHit::RecHitPointer preciseHit = hit->clone(uptsos);
    const auto& preciseHit = hit;
    double estimate = 0.0;
    if (preciseHit->isValid() && uptsos.isValid()) {
      estimate = theEstimator->estimate(uptsos, *preciseHit ).second;
    }

    //LogTrace(theCategory) << "estimate " << estimate << " TM.est " << m->estimate();
    //UNUSED:    double tkDiff = 0.0;
    //UNUSED:    double staDiff = 0.0;
    if ( hit->isValid() &&  (hit->geographicalId().det()) == DetId::Tracker ) {
      tkChi2 += estimate;
      //UNUSED:      tkDiff = estimate - m->estimate();
      tkNdof += hit->dimension();
    }
    if ( hit->isValid() &&  (hit->geographicalId().det()) == DetId::Muon ) {
      muChi2 += estimate;
      //UNUSED      staDiff = estimate - m->estimate();
      muNdof += hit->dimension();
    }
  }

  //For tkNdof < 6, should a large number or something else
  // be used instead of just tkChi2 directly?
  if (tkNdof > 5 ) {tkChi2 /= (tkNdof-5.); }

  //For muNdof < 6, should a large number or something else
  // be used instead of just muChi2 directly?
  if (muNdof > 5 ) {muChi2 /= (muNdof-5.); }

  return std::pair<double,double>(tkChi2,muChi2);

}

//
// calculate the tail probability (-ln(P)) of a fit
//
double
GlobalTrackQualityProducer::trackProbability(Trajectory& track) const {

  if ( track.ndof() > 0 && track.chiSquared() > 0 ) {
    return -LnChiSquaredProbability(track.chiSquared(), track.ndof());
  } else {
    return 0.0;
  }

}

void GlobalTrackQualityProducer::fillDescriptions(edm::ConfigurationDescriptions& descriptions){
  edm::ParameterSetDescription desc;
  {
    edm::ParameterSetDescription psd1;
    psd1.setAllowAnything();
    desc.add<edm::ParameterSetDescription>("ServiceParameters", psd1);
  }
  {
    edm::ParameterSetDescription psd1;
    psd1.setAllowAnything();
    desc.add<edm::ParameterSetDescription>("GlobalMuonTrackMatcher", psd1);
  }
  desc.add<edm::InputTag>("InputCollection",edm::InputTag("globalMuons"));
  desc.add<edm::InputTag>("InputLinksCollection",edm::InputTag("globalMuons"));
  desc.add<std::string>("BaseLabel","GLB");
  {
    edm::ParameterSetDescription descGlbMuonRefitter;
    descGlbMuonRefitter.setAllowAnything();
    descGlbMuonRefitter.add<edm::InputTag>("DTRecSegmentLabel" , edm::InputTag("dt1DRecHits"));
    descGlbMuonRefitter.add<edm::InputTag>("CSCRecSegmentLabel" , edm::InputTag("csc2DRecHits"));
    descGlbMuonRefitter.add<edm::InputTag>("GEMRecHitLabel" , edm::InputTag("gemRecHits"));
    descGlbMuonRefitter.add<edm::InputTag>("ME0RecHitLabel" , edm::InputTag("me0Segments"));
    descGlbMuonRefitter.add<edm::InputTag>("RPCRecSegmentLabel" , edm::InputTag("rpcRecHits"));

    descGlbMuonRefitter.add<std::string>("Fitter", "KFFitterForRefitInsideOut");
    descGlbMuonRefitter.add<std::string>("Smoother", "KFSmootherForRefitInsideOut");
    descGlbMuonRefitter.add<std::string>("Propagator", "SmartPropagatorAnyRK");
    descGlbMuonRefitter.add<std::string>("TrackerRecHitBuilder", "WithAngleAndTemplate");
    descGlbMuonRefitter.add<std::string>("MuonRecHitBuilder", "MuonRecHitBuilder");
    descGlbMuonRefitter.add<bool>("DoPredictionsOnly", false);
    descGlbMuonRefitter.add<std::string>("RefitDirection", "insideOut");
    descGlbMuonRefitter.add<bool>("PropDirForCosmics", false);
    descGlbMuonRefitter.add<bool>("RefitRPCHits", true);

    descGlbMuonRefitter.add<std::vector<int>>("DYTthrs",{10, 10});
    descGlbMuonRefitter.add<int>("DYTselector",1);
    descGlbMuonRefitter.add<bool>("DYTupdator", false);
    descGlbMuonRefitter.add<bool>("DYTuseAPE", false );
    descGlbMuonRefitter.add<bool>("DYTuseThrsParametrization", true);
    {
      edm::ParameterSetDescription descDYTthrs;
      descDYTthrs.add<std::vector<double>>("eta0p8", {1,-0.919853, 0.990742});
      descDYTthrs.add<std::vector<double>>("eta1p2", {1,-0.897354, 0.987738});
      descDYTthrs.add<std::vector<double>>("eta2p0", {4,-0.986855, 0.998516});
      descDYTthrs.add<std::vector<double>>("eta2p2", {1,-0.940342, 0.992955});
      descDYTthrs.add<std::vector<double>>("eta2p4", {1,-0.947633, 0.993762});
      descGlbMuonRefitter.add<edm::ParameterSetDescription>("DYTthrsParameters", descDYTthrs);
    }

    descGlbMuonRefitter.add<int>("SkipStation", -1);
    descGlbMuonRefitter.add<int>("TrackerSkipSystem",-1);
    descGlbMuonRefitter.add<int>("TrackerSkipSection", -1);
    descGlbMuonRefitter.add<bool>("RefitFlag", true );

    desc.add<edm::ParameterSetDescription>("RefitterParameters", descGlbMuonRefitter);
  }
  desc.add<double>("nSigma", 3.0);
  desc.add<double>("MaxChi2", 100000.0);

  descriptions.add("globalTrackQualityProducer", desc);
}
//#include "FWCore/Framework/interface/MakerMacros.h"
//DEFINE_FWK_MODULE(GlobalTrackQualityProducer);