MuonSegmentHitSummaryTool.cxx

Go to the documentation of this file.

/*
  Copyright (C) 2002-2020 CERN for the benefit of the ATLAS collaboration
*/
 
#include "MuonSegmentHitSummaryTool.h"
 
#include <map>
 
#include "MuonPrepRawData/MdtPrepData.h"
#include "MuonRIO_OnTrack/MdtDriftCircleOnTrack.h"
#include "MuonSegment/MuonSegment.h"
#include "MuonSegment/MuonSegmentQuality.h"
 
namespace Muon {
 
MuonSegmentHitSummaryTool::MuonSegmentHitSummaryTool(const std::string& ty, const std::string& na, const IInterface* pa)
    : AthAlgTool(ty, na, pa)
{
    declareInterface<IMuonSegmentHitSummaryTool>(this);
    declareProperty("PositionAlongTubeCut", m_positionAlongTubeCut = -200.,
                    "Cut on distance from tube end used for holes, negative value means in the tube");
    declareProperty("MinimumADCValue", m_lowerADCBound = 70.);
}
 
StatusCode
MuonSegmentHitSummaryTool::initialize()
{
    ATH_CHECK(m_DetectorManagerKey.initialize());
    ATH_CHECK(m_edmHelperSvc.retrieve());
    ATH_CHECK(m_printer.retrieve());
    ATH_CHECK(m_idHelperSvc.retrieve());
    return StatusCode::SUCCESS;
}
 
MuonSegmentHitSummaryTool::HitCounts
MuonSegmentHitSummaryTool::getHitCounts(const MuonSegment& seg) const
{
 
    HitCounts hitCounts;
 
    SG::ReadCondHandle<MuonGM::MuonDetectorManager> DetectorManagerHandle{m_DetectorManagerKey};
    const MuonGM::MuonDetectorManager*              MuonDetMgr{*DetectorManagerHandle};
    if (!MuonDetMgr) {
        ATH_MSG_ERROR("Null pointer to the read MuonDetectorManager conditions object");
        return hitCounts;
    }
 
    // calculate shortest channel
    double                       shortestTube   {FLT_MAX};
    const MdtDriftCircleOnTrack* mdtShortest    = nullptr;
    bool                         transformIsSet = false;
    Amg::Transform3D             gToAMDB;
    Amg::Vector3D                lpos(0., 0., 0.);
    Amg::Vector3D                ldir{0.,0.,0.};
    double                       dxdy = 1.;
 
    Identifier                chid    = m_edmHelperSvc->chamberId(seg);
    MuonStationIndex::StIndex stIndex = m_idHelperSvc->stationIndex(chid);
    
    if ((!m_idHelperSvc->isCsc(chid) && stIndex == MuonStationIndex::EI) || stIndex == MuonStationIndex::BO)
        hitCounts.nexpectedTrigHitLayers = 1;
    else if (stIndex == MuonStationIndex::BM)
        hitCounts.nexpectedTrigHitLayers = 2;
    else if (stIndex == MuonStationIndex::EM)
        hitCounts.nexpectedTrigHitLayers = 3;
 
    // loop over hits
    for (const Trk::MeasurementBase* meas : seg.containedMeasurements()) {
        
        // get id and check that it is a muon hit id
        Identifier id = m_edmHelperSvc->getIdentifier(*meas);
        if (!id.is_valid() || !m_idHelperSvc->isMuon(id)) continue;
 
        // check if MDT is so increase ml counter
        if (m_idHelperSvc->isMdt(id)) {
            // get layer index
            int                ml           = m_idHelperSvc->mdtIdHelper().multilayer(id);
            int                lay          = m_idHelperSvc->mdtIdHelper().tubeLayer(id);
            int                tube         = m_idHelperSvc->mdtIdHelper().tube(id);
            int                layIndex     = 4 * (ml - 1) + (lay - 1);  // start at 0 rather than at 1
            MdtLayerIntersect& layIntersect = hitCounts.mdtHitHolePerLayerCounts[layIndex];
            ++layIntersect.nhits;
 
            const MdtDriftCircleOnTrack* mdt = dynamic_cast<const MdtDriftCircleOnTrack*>(meas);
            if (mdt) {
                const MuonGM::MdtReadoutElement* detEl =
                    mdt->prepRawData() ? mdt->prepRawData()->detectorElement() : MuonDetMgr->getMdtReadoutElement(id);
                if (!detEl) {
                    ATH_MSG_WARNING(" could not get MdtReadoutElement for tube " << m_idHelperSvc->toString(id));
                    continue;
                }
 
                double tubeLen          = detEl->getActiveTubeLength(lay, tube);
                layIntersect.tubeLength = tubeLen;
                if (!transformIsSet) {
                    gToAMDB        = detEl->GlobalToAmdbLRSTransform();
                    lpos           = gToAMDB * seg.globalPosition();
                    ldir           = (gToAMDB * seg.globalDirection()).unit();
                    dxdy           = std::abs(ldir.y()) > 0.001 ? ldir.x() / ldir.y() : 1000.;
                    transformIsSet = true;
                }
                if (!mdtShortest || tubeLen < shortestTube) {
                    mdtShortest  = mdt;
                    shortestTube = tubeLen;
                }
            }
            const bool first_layer = (m_idHelperSvc->mdtIdHelper().multilayer(id) == 1);
            hitCounts.nmdtHitsMl1 += first_layer;
            hitCounts.nmdtHitsMl2 += !first_layer;
            if (mdt && mdt->prepRawData()) {
                int adc = mdt->prepRawData()->adc();
                if (adc > m_lowerADCBound) hitCounts.nmdtHighADCHits+=(adc > m_lowerADCBound);
                hitCounts.adcMax = std::max(adc, hitCounts.adcMax);                
            }
 
        } 
        else if (m_idHelperSvc->isTrigger(id)) {
            // get gasgap ID (same for eta/phi projection)
            Identifier gasGapId    = m_idHelperSvc->gasGapId(id);
            const bool measuresPhi = m_idHelperSvc->measuresPhi(id);
            hitCounts.hitCountsPerLayer[gasGapId].nphiHits+= measuresPhi;
            hitCounts.hitCountsPerLayer[gasGapId].netaHits+= !measuresPhi;          
        } else if (m_idHelperSvc->isCsc(id)) {
            const bool measuresPhi = m_idHelperSvc->measuresPhi(id);
            hitCounts.ncscHits.nphiHits+= measuresPhi;
            hitCounts.ncscHits.netaHits+= !measuresPhi;          
        } else if (m_idHelperSvc->issTgc(id)){
            const bool measuresPhi = m_idHelperSvc->measuresPhi(id);
            hitCounts.nstgcHits.nphiHits+= measuresPhi;
            hitCounts.nstgcHits.netaHits+= !measuresPhi;       
        } else if (m_idHelperSvc->isMM(id)){
            const bool isStereo = m_idHelperSvc->mmIdHelper().isStereo(id);
            hitCounts.nmmEtaHits +=  !isStereo;          
            hitCounts.nmmStereoHits+= isStereo;     
        }
    }
 
    const MuonSegmentQuality* quality = dynamic_cast<const MuonSegmentQuality*>(seg.fitQuality());
    if (quality) {
        for (const Identifier& id : quality->channelsWithoutHit()) {
            int                ml       = m_idHelperSvc->mdtIdHelper().multilayer(id);
            int                lay      = m_idHelperSvc->mdtIdHelper().tubeLayer(id);
            int                tube     = m_idHelperSvc->mdtIdHelper().tube(id);
            int                layIndex = 4 * (ml - 1) + (lay - 1);  // subtract 1 as fields start with 1 instead of 0
            MdtLayerIntersect& layIntersect = hitCounts.mdtHitHolePerLayerCounts[layIndex];
            ++layIntersect.nholes;
 
            if (transformIsSet) {
                const MuonGM::MdtReadoutElement* detEl = MuonDetMgr->getMdtReadoutElement(id);
                if (!detEl) {
                    ATH_MSG_WARNING(" could not get MdtReadoutElement for tube " << m_idHelperSvc->toString(id));
                    continue;
                }
                double tubeLen               = detEl->getActiveTubeLength(lay, tube);
                double ytube                 = (gToAMDB * detEl->center(id)).y();
                double xint                  = dxdy * (ytube - lpos.y()) + lpos.x();
                layIntersect.distFromTubeEnd = xint;
                layIntersect.tubeLength      = tubeLen;
            }
        }
    }
 
 
    // now loop over map and get the counts for the trigger hits
    for (std::pair<const Identifier, EtaPhiHitCount>& it : hitCounts.hitCountsPerLayer) {
        EtaPhiHitCount& counts = it.second;
 
        // increase eta/phi hit counts
        if (counts.nphiHits != 0) ++hitCounts.nphiTrigHitLayers;
        if (counts.netaHits != 0) {
            ++hitCounts.netaTrigHitLayers;
 
            // if both eta/phi projection have entries increase paired counters
            if (counts.nphiHits != 0) ++hitCounts.npairedTrigHitLayers;
        }
    }
 
    int  currentEnclosedHoles = 0;
    bool firstLayerWithHits   = false;
    // now loop over mdt map and get the number of enclosed holes
    for ( auto& lit :  hitCounts.mdtHitHolePerLayerCounts) {
        hitCounts.nmdtHoles += lit.second.nholes;
        if (lit.second.nhits == 0) {
            ++currentEnclosedHoles;
            // count holes within chamber bounds
            if (std::abs(lit.second.distFromTubeEnd) - 0.5 * lit.second.tubeLength < m_positionAlongTubeCut)
                ++hitCounts.nmdtHolesInChamber;
        } else {
            if (firstLayerWithHits) hitCounts.nmdtEnclosedHoles += currentEnclosedHoles;
            currentEnclosedHoles = 0;
            firstLayerWithHits   = true;
        }
    }
 
    if (mdtShortest) {
        double posAlongTube = (mdtShortest->associatedSurface().transform().inverse() * seg.globalPosition()).z();
        if (0.5 * shortestTube - std::abs(posAlongTube) < 100.) hitCounts.closeToChamberEdge = true;
    }
 
    if (seg.fitQuality()) {
        // combine chi2 with missing hit information and apply cut
        hitCounts.segmentQuality = seg.fitQuality()->chiSquared() + 5.1 * (hitCounts.nmdtHoles);
        if (seg.fitQuality()->numberDoF() > 0) hitCounts.segmentQuality /= seg.fitQuality()->numberDoF();
    }
 
 
    return hitCounts;
}
 
}  // namespace Muon