ITkPixelCablingData.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/
#ifndef ITkPixelCablingData_h
#define ITkPixelCablingData_h
 
#include "ITkPixelCabling/ITkPixelOnlineId.h"
 
// Athena includes
#include "Identifier/Identifier.h"
#include "AthenaKernel/CLASS_DEF.h"
#include "AthenaKernel/CondCont.h"
//STL
#include <unordered_map>
#include <iosfwd>
 
namespace ITkPixelCabling {
 
    //types of modules we have
    enum ModuleType {
        SimpleQuad,
        MergedQuad,
        IBTriplet,
        IECTriplet,
        Undefined
    };
 
    //types of coordinate transformations
    //kept separate from the chip types
    //in case per-module specifics are
    //needed
    enum TransformType {
        NominalQuad,
        NominalIBTriplet,
        NominalIECTriplet,
        UndefinedTransform
    };
 
    //We need to know what module type
    //we're dealing with from the readout
    //PoV, so that we can translate accordingly.
    template <class ID>
    struct ModuleInfo {
        ID id;
        ModuleType type {};
        TransformType transform {};
    };
 
    //define transforms, assuming
    // Y | 2 | 3 |
    //   | 0 | 1 |
    //           X
    //to be confirmed and revisited
 
    using TransformFn = void(*)(uint16_t&, uint16_t&);
 
    //LUT for quad translation functions indexed by chip ID
    //The RD53C/ITkPixV2 chip dimensions are 400 columns, 384 rows,
    //indexing starts at 0, hence the possible values of col in [0, 399]
    //and row in [0, 383]. A quad is 2x2 chips, hence the total dimensions
    //of 800 columns and 768 rows, again indexed from 0, i. e. col in [0, 799]
    //and row in [0, 767].
    static constexpr TransformFn nominalQuadTable[4] = {
        []([[maybe_unused]] uint16_t& col, uint16_t& row){row = 383 - row;},
        []([[maybe_unused]] uint16_t& col, uint16_t& row){row = 383 - row; col += 400;},
        []([[maybe_unused]] uint16_t& col, uint16_t& row){row = 767 - row;},
        []([[maybe_unused]] uint16_t& col, uint16_t& row){row = 767 - row; col += 400;}
    };
 
    static constexpr TransformFn ibTransformFn =
        [](uint16_t& col, uint16_t& row){
            row = 2 * (383 - row) + (col & 1);
            col >>= 1;
        };
 
    static constexpr TransformFn iecTransformFn = 
        [](uint16_t& col, uint16_t& row) {
            std::swap(col, row);
        };
    
    static inline void chipToModuleTransform(const TransformType& transform, const uint8_t& chipID, uint16_t& col, uint16_t& row){
        switch (transform){
            case TransformType::NominalQuad:
                nominalQuadTable[chipID](col, row);
                break;
            case TransformType::NominalIBTriplet:
                ibTransformFn(col, row);
                break;
            case TransformType::NominalIECTriplet:
                iecTransformFn(col, row);
                break;
            case TransformType::UndefinedTransform:
                break;
        }
    }
 
}
 
class ITkPixelCablingData{
public:
  friend std::istream& operator>>(std::istream & is, ITkPixelCablingData & cabling);
  friend std::ostream& operator<<(std::ostream & os, const ITkPixelCablingData & cabling);
  bool empty() const;
  std::size_t size() const;
  ITkPixelOnlineId onlineId(const Identifier & id) const;
  Identifier offlineId(const ITkPixelOnlineId& id) const;
 
  ITkPixelCabling::ModuleInfo<ITkPixelOnlineId> onlineModuleInfo(const Identifier & id) const;
  ITkPixelCabling::ModuleInfo<Identifier> offlineModuleInfo(const ITkPixelOnlineId & id) const;
 
  //Add entry to the offline->online map. This is only for producing test streams,
  //from MC, and needs to propagate the type of the module. We also can at most map
  //with 4-fold degeneracy due to non-merged quads, which have 4 online IDs mapped to
  //a single offline ID.
  void addEntryOffOn(const Identifier& idOff, const ITkPixelOnlineId& idOn);
  void addEntryOffOn(const Identifier& idOff, const ITkPixelCabling::ModuleInfo<ITkPixelOnlineId>& moduleInfo);
 
  //Add entry to the online->offline map. This is for decoding. For quick access,
  //these maps can also cache the type of the module, so that we know how to translate
  //the hit coordinates from chip to module
  void addEntryOnOff(const ITkPixelOnlineId& idOn, const Identifier& idOff);
  void addEntryOnOff(const ITkPixelOnlineId& idOn, const ITkPixelCabling::ModuleInfo<Identifier>& moduleInfo);
 
  void print() const;
 
  //Add entries to the 
 
private:
  //offline->online base map
  std::unordered_map<Identifier, ITkPixelOnlineId> m_offline2OnlineMap;
 
  //offline->online base map with info on module type
  std::unordered_map<Identifier, ITkPixelCabling::ModuleInfo<ITkPixelOnlineId>> m_offline2ModuleInfoMap;
 
  //simple online->offline map
  std::unordered_map<ITkPixelOnlineId, Identifier> m_online2OfflineMap;
 
  //online->offline map with info on module type
  std::unordered_map<ITkPixelOnlineId, ITkPixelCabling::ModuleInfo<Identifier>> m_online2ModuleInfoMap;
 
  //online base -> module type
  std::unordered_map<ITkPixelOnlineId, ITkPixelCabling::ModuleType> m_online2ModuleType;
 
  //offline -> module type
  std::unordered_map<Identifier, ITkPixelCabling::ModuleType> m_offline2ModuleType;
 
};
// Magic "CLassID" for storage/retrieval in StoreGate
// These values produced using clid script.
// "clid ITkPixelCablingData"
// 140860927 ITkPixelCablingData
CLASS_DEF( ITkPixelCablingData , 140860927 , 1 );
//"clid -cs ITkPixelCablingData"
//143807283
CONDCONT_DEF( ITkPixelCablingData , 143807283 );
#endif