PixelDiodeMap.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2025 CERN for the benefit of the ATLAS collaboration
*/
 
// PixelDiodeMap.h
// (c) ATLAS Pixel Detector software
 
#ifndef READOUTGEOMETRYBASE_PIXELDIODEMAP_H
#define READOUTGEOMETRYBASE_PIXELDIODEMAP_H
 
// STL classes
#include <list>
#include <memory>
#include <vector>
 
// Data member classes
#include "ReadoutGeometryBase/PixelDiodeMatrix.h"
 
// Input/output classes
#include "ReadoutGeometryBase/SiCellId.h"
#include "ReadoutGeometryBase/SiDiodesParameters.h"
#include "ReadoutGeometryBase/PixelDiodeParametersProxy.h"
 
namespace InDetDD {
 
class SiCellId;
class PixelDiodeMatrix;
 
    class PixelDiodeMap {
      
        public:
        
          PixelDiodeMap(std::shared_ptr<const PixelDiodeMatrix> diodeMatrix);
          
          PixelDiodeMap(const PixelDiodeMap &map);
          
          ~PixelDiodeMap();
          
          PixelDiodeMap &operator=(const PixelDiodeMap &map);
          
          // Const methods:
        
          SiDiodesParameters parameters(const SiCellId & diodeId) const;
        
          SiCellId cellIdOfPosition(const Amg::Vector2D & localPosition) const;
        
          SiCellId cellIdInRange(const SiCellId & cellId) const;
        
          void neighboursOfCell(const SiCellId & cellId,
                    std::vector<SiCellId> &neighbours) const;
        
          double intersectionLength(const SiCellId &diode1, const SiCellId &diode2) const;
        
          // Global sensor size:
          double leftColumn() const;
          double rightColumn() const;
          double leftRow() const;
          double rightRow() const;
          
          double width() const;
          double length() const;
        
          // Number of cells in each direction.
          int phiDiodes() const;
          int etaDiodes() const;
        
          // Total number of diodes:
          int diodes() const;
        
          // Non-const methods:
 
          void setGeneralLayout() {m_generalLayout = true;}
 
          std::string debugStringRepr() const;
 
          PixelDiodeParametersProxy parametersProxy(const SiCellId &cellId) const;
 
          // Private methods:
        private:
        
          static double intersectionLength1D(const double x1,const double dx1,
                          const double x2,const double dx2) ;
          
          void neighboursOfCellGeneral(const SiCellId & cellId,
                                       std::vector<SiCellId> &neighbours) const;
            
          double intersectionLengthGeneral(const SiCellId &diode1,
                           const SiCellId &diode2) const;
            
        
          // Private data:
        private:
          std::shared_ptr<const PixelDiodeMatrix> m_matrix;    
          bool m_generalLayout;                 
    };
    
    // Inline methods:
    
    inline double PixelDiodeMap::length() const
    {
      return m_matrix->etaWidth();
    }
    
    inline double PixelDiodeMap::width() const
    {
      return m_matrix->phiWidth();  
    }
    
    inline double PixelDiodeMap::leftColumn() const
    {
      return -0.5*length();
    }
    
    inline double PixelDiodeMap::rightColumn() const
    {
      return 0.5*length();  
    }
    
    inline double PixelDiodeMap::leftRow() const
    {
      return -0.5*width();
    }
    
    inline double PixelDiodeMap::rightRow() const
    {
      return 0.5*width();
    }
    
    inline int PixelDiodeMap::diodes() const
    {
      return phiDiodes() * etaDiodes();
    }
    
    inline int PixelDiodeMap::phiDiodes() const
    {
      return m_matrix->phiCells();
    }
    
    inline int PixelDiodeMap::etaDiodes() const
    {
      return m_matrix->etaCells();
    }
    
    inline SiCellId PixelDiodeMap::cellIdInRange(const SiCellId & cellId) const
    {
      if (!cellId.isValid() || 
          cellId.phiIndex() <0 || cellId.phiIndex() >= phiDiodes() ||
          cellId.etaIndex() <0 || cellId.etaIndex() >= etaDiodes()) return SiCellId(); // Invalid
      return cellId; 
    }
 
    inline std::string PixelDiodeMap::debugStringRepr() const
    {
      return m_matrix->createDebugStringRepr();
    }
 
    inline PixelDiodeParametersProxy PixelDiodeMap::parametersProxy(const SiCellId &cellId) const {
       PixelDiodeParametersProxy ret;
       ret.cell_ptr() = m_matrix->positionOfCell(cellId, ret.position());
       return ret;
    }
 
} // namespace InDetDD
 
#endif // READOUTGEOMETRYBASE_PIXELDIODEMAP_H