SCT_ID.h

Go to the documentation of this file.

/*
   Copyright (C) 2002-2025 CERN for the benefit of the ATLAS collaboration
 */
 
#ifndef INDETIDENTIFIER_SCT_ID_H
#define INDETIDENTIFIER_SCT_ID_H
 
 
#include "AtlasDetDescr/AtlasDetectorID.h"
#include "Identifier/Identifier.h"
#include "Identifier/IdentifierHash.h"
#include "Identifier/MultiRange.h"
#include "Identifier/IdHelper.h"
#include "IdDict/IdDictFieldImplementation.h"
#include "AthenaKernel/CLASS_DEF.h"
 
#include <string>
#include <cassert>
#include <algorithm>
#include <array>
#include <functional>
 
 
class IdDictDictionary;
 

class SCT_ID final: public AtlasDetectorID
{
public:

  typedef Identifier::size_type size_type;
  typedef std::vector<Identifier>::const_iterator const_id_iterator;
  typedef MultiRange::const_identifier_factory const_expanded_id_iterator;


  SCT_ID();
  virtual ~SCT_ID() = default;
  
  AtlasDetectorID::HelperType helper() const override final{
    return AtlasDetectorID::HelperType::SCT;
  }



  Identifier module_id(int barrel_ec,
                       int layer_disk,
                       int phi_module,
                       int eta_module) const;
                       
  Identifier module_id(int barrel_ec,
                       int layer_disk,
                       int phi_module,
                       int eta_module,
                       bool checks) const;

  Identifier module_id(const Identifier& wafer_id) const;

  Identifier wafer_id(int barrel_ec,
                      int layer_disk,
                      int phi_module,
                      int eta_module,
                      int side) const;
                      
  Identifier wafer_id(int barrel_ec,
                      int layer_disk,
                      int phi_module,
                      int eta_module,
                      int side,
                      bool checks) const;

  Identifier wafer_id(const Identifier& strip_id) const;
  
  Identifier wafer_id(const ExpandedIdentifier & expId) const;

  Identifier wafer_id(const IdentifierHash& wafer_hash) const;

  Identifier strip_id(int barrel_ec,
                      int layer_disk,
                      int phi_module,
                      int eta_module,
                      int side,
                      int strip) const;
  Identifier strip_id(int barrel_ec,
                      int layer_disk,
                      int phi_module,
                      int eta_module,
                      int side,
                      int strip,
                      bool check) const;
 
  Identifier strip_id(int barrel_ec,
                      int layer_disk,
                      int phi_module,
                      int eta_module,
                      int side,
                      int row,
                      int strip) const;
  Identifier strip_id(int barrel_ec,
                      int layer_disk,
                      int phi_module,
                      int eta_module,
                      int side,
                      int row,
                      int strip,
                      bool checks) const;
 
 
 
  Identifier strip_id(const Identifier& wafer_id,
                      int strip) const;
 
  Identifier strip_id(const Identifier& wafer_id,
                      int row, int strip) const;
 

 


  size_type wafer_hash_max() const;
  size_type strip_hash_max() const;



  const_id_iterator wafer_begin() const;
  const_id_iterator wafer_end() const;
  const_expanded_id_iterator strip_begin() const;
  const_expanded_id_iterator strip_end() const;
 



  IdentifierHash wafer_hash(const Identifier& wafer_id) const;

  bool is_barrel(const Identifier& id) const;

  int barrel_ec(const Identifier& id) const;
  int layer_disk(const Identifier& id) const;
  int phi_module(const Identifier& id) const;
  int eta_module(const Identifier& id) const;
  int side(const Identifier& id) const;
  int row(const Identifier& id) const;
  int strip(const Identifier& id) const;

  int layer_disk_max(const Identifier& id) const;
  int phi_module_max(const Identifier& id) const;
  int eta_module_max(const Identifier& id) const;
  int eta_module_min(const Identifier& id) const;
  int strip_max(const Identifier& id) const;



  int get_prev_in_phi(const IdentifierHash& id, IdentifierHash& prev) const;
  int get_next_in_phi(const IdentifierHash& id, IdentifierHash& next) const;
  int get_prev_in_eta(const IdentifierHash& id, IdentifierHash& prev) const;
  int get_next_in_eta(const IdentifierHash& id, IdentifierHash& next) const;
  int get_other_side(const IdentifierHash& id, IdentifierHash& other) const;
  
  IdentifierHash get_prev_in_phi(const IdentifierHash& id) const;
  IdentifierHash get_next_in_phi(const IdentifierHash& id) const;
  IdentifierHash get_prev_in_eta(const IdentifierHash& id) const;
  IdentifierHash get_next_in_eta(const IdentifierHash& id) const;
  IdentifierHash get_other_side(const IdentifierHash& id) const;
 
  // To check for when phi wrap around may be needed, use
  bool is_phi_module_max(const Identifier& id) const;
  bool is_eta_module_min(const Identifier& id) const;
  bool is_eta_module_max(const Identifier& id) const;
  
  //all neighbours: opposite and then eta direction first
  std::array<IdentifierHash, 5>
  neighbours_by_eta(const IdentifierHash & idh) const;
  
  //all neighbours: opposite and then phi direction first
  std::array<IdentifierHash, 5>
  neighbours_by_phi(const IdentifierHash & idh) const;
  
  const std::array<std::function< IdentifierHash(const IdentifierHash &)>, 5 >&
  neighbour_calls_by_eta() const;


  IdContext wafer_context() const;
  IdContext strip_context() const;



  virtual int get_id(const IdentifierHash& hash_id,
                     Identifier& id,
                     const IdContext* context = 0) const override final;

  virtual int get_hash(const Identifier& id,
                       IdentifierHash& hash_id,
                       const IdContext* context = 0) const override final;

  int base_bit() const;

  Identifier::diff_type calc_offset(const Identifier& base,
                                    const Identifier& target) const;

  Identifier strip_id_offset(const Identifier& base,
                             Identifier::diff_type offset) const;



  Identifier strip_id(const ExpandedIdentifier& strip_id) const;

  void get_expanded_id(const Identifier& id,
                       ExpandedIdentifier& exp_id,
                       const IdContext* context = 0) const;

  virtual int initialize_from_dictionary(const IdDictMgr& dict_mgr) override final;

private:
  typedef std::vector<Identifier>     id_vec;
  typedef id_vec::const_iterator id_vec_it;
  typedef std::vector<IdentifierHash> hash_vec;
  typedef hash_vec::const_iterator hash_vec_it;
  enum ExpandedIdIndices {INDET, SCT, BARREL_EC, LAYER_DISK, PHI, ETA, SIDE, ROW,STRIP, NUM_INDICES};
  std::array<std::function< IdentifierHash(const IdentifierHash & )>, 5> m_neighboursByEta;
    
  void wafer_id_checks(int barrel_ec,
                       int layer_disk,
                       int phi_module,
                       int eta_module,
                       int side) const;
 
  void strip_id_checks(int barrel_ec,
                       int layer_disk,
                       int phi_module,
                       int eta_module,
                       int side,
                       int strip) const;
 
  void strip_id_checks(int barrel_ec,
                       int layer_disk,
                       int phi_module,
                       int eta_module,
                       int side,
                       int row,
                       int strip) const;
                       
  int getMaxField(const Identifier & id, const ExpandedIdIndices &fieldIndx) const;
                       
  void strip_id_checks(const ExpandedIdentifier & expId) const;
 
 
  int initLevelsFromDict();
 
  int init_hashes();
 
  int init_neighbors();
 
  IdentifierHash
  nextInSequence(const IdentifierHash& id, const hash_vec& vectorOfHashes) const;
 
  // Temporary method for adapting an identifier for the MultiRange
  // check - MR is missing the InnerDetector level
  Identifier idForCheck(const Identifier& id) const;
 
  size_type m_sct_region_index{0};
 
  std::array<size_t, NUM_INDICES> m_indices{0,1,2,3,4,5,6,7,999};
  const IdDictDictionary* m_dict;
  MultiRange m_full_wafer_range;
  MultiRange m_full_strip_range;
  size_type m_wafer_hash_max;
  size_type m_strip_hash_max;
  Range::field m_barrel_field;
  id_vec m_wafer_vec;
  hash_vec m_prev_phi_wafer_vec;
  hash_vec m_next_phi_wafer_vec;
  hash_vec m_prev_eta_wafer_vec;
  hash_vec m_next_eta_wafer_vec;
  bool m_hasRows;
 
  IdDictFieldImplementation m_indet_impl;
  IdDictFieldImplementation m_sct_impl;
  IdDictFieldImplementation m_bec_impl;
  IdDictFieldImplementation m_lay_disk_impl;
  IdDictFieldImplementation m_phi_mod_impl;
  IdDictFieldImplementation m_eta_mod_impl;
  IdDictFieldImplementation m_side_impl;
  IdDictFieldImplementation m_row_impl;
  IdDictFieldImplementation m_strip_impl;
};
 
 
//using the macros below we can assign an identifier (and a version)
//This is required and checked at compile time when you try to record/retrieve
CLASS_DEF(SCT_ID, 2517, 1)
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::module_id(int barrel_ec,
                  int layer_disk,
                  int phi_module,
                  int eta_module,
                  bool checks) const {
  // Build identifier
  Identifier result((Identifier::value_type) 0);
 
  // Pack fields independently
  m_indet_impl.pack(indet_field_value(), result);
  m_sct_impl.pack(sct_field_value(), result);
  m_bec_impl.pack(barrel_ec, result);
  m_lay_disk_impl.pack(layer_disk, result);
  m_phi_mod_impl.pack(phi_module, result);
  m_eta_mod_impl.pack(eta_module, result);
 
  // Do checks
  if (checks) {
    wafer_id_checks(barrel_ec, layer_disk, phi_module, eta_module, 0);
  }
 
  return result;
}
 
inline Identifier
SCT_ID::module_id(int barrel_ec,
                  int layer_disk,
                  int phi_module,
                  int eta_module) const {
  return module_id(barrel_ec, layer_disk, phi_module, eta_module, do_checks());
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::module_id(const Identifier& wafer_id) const {
  Identifier result(wafer_id);
 
  //  Reset the side and strip fields
  m_side_impl.reset(result);
  m_strip_impl.reset(result);
  if(m_hasRows) m_row_impl.reset(result);
  return(result);
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::wafer_id(int barrel_ec,
                 int layer_disk,
                 int phi_module,
                 int eta_module,
                 int side,
                 bool checks) const {
  // Build identifier
  Identifier result((Identifier::value_type) 0);
 
  // Pack fields independently
  m_indet_impl.pack(indet_field_value(), result);
  m_sct_impl.pack(sct_field_value(), result);
  m_bec_impl.pack(barrel_ec, result);
  m_lay_disk_impl.pack(layer_disk, result);
  m_phi_mod_impl.pack(phi_module, result);
  m_eta_mod_impl.pack(eta_module, result);
  m_side_impl.pack(side, result);
 
  // Do checks
  if (checks) {
    wafer_id_checks(barrel_ec, layer_disk, phi_module, eta_module, side);
  }
 
  return result;
}
 
inline Identifier
SCT_ID::wafer_id(int barrel_ec,
                 int layer_disk,
                 int phi_module,
                 int eta_module,
                 int side) const {
  return wafer_id(barrel_ec, layer_disk, phi_module, eta_module, side,
                  do_checks());
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::wafer_id(const Identifier& strip_id) const {
  Identifier result(strip_id);
 
  // reset the strip field
  m_strip_impl.reset(result);
  if(m_hasRows) m_row_impl.reset(result);
  return(result);
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::wafer_id(const IdentifierHash& wafer_hash) const {
  return(m_wafer_vec[wafer_hash]);
}
 
//----------------------------------------------------------------------------
inline IdentifierHash
SCT_ID::wafer_hash(const Identifier& wafer_id) const {
  id_vec_it it = std::lower_bound(m_wafer_vec.begin(),
                                  m_wafer_vec.end(),
                                  wafer_id);
 
  // Require that wafer_id matches the one in vector
  if (it != m_wafer_vec.end() && wafer_id == (*it)) {
    return(it - m_wafer_vec.begin());
  }
  IdentifierHash result;
  return(result); // return hash in invalid state
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::strip_id(int barrel_ec,
                 int layer_disk,
                 int phi_module,
                 int eta_module,
                 int side,
                 int strip,
                 bool checks) const {
  // Build identifier
  Identifier result((Identifier::value_type) 0);
 
  // Pack fields independently
  m_indet_impl.pack(indet_field_value(), result);
  m_sct_impl.pack(sct_field_value(), result);
  m_bec_impl.pack(barrel_ec, result);
  m_lay_disk_impl.pack(layer_disk, result);
  m_phi_mod_impl.pack(phi_module, result);
  m_eta_mod_impl.pack(eta_module, result);
  m_side_impl.pack(side, result);
  m_strip_impl.pack(strip, result);
 
  // Do checks
  if (checks) {
    strip_id_checks(barrel_ec, layer_disk, phi_module, eta_module, side, strip);
  }
  return result;
}
 
inline Identifier
SCT_ID::strip_id(int barrel_ec,
                 int layer_disk,
                 int phi_module,
                 int eta_module,
                 int side,
                 int strip) const {
  return strip_id(barrel_ec, layer_disk, phi_module, eta_module, side, strip,
                  do_checks());
}
 
//----------------------------------------------------------------------------
 
inline Identifier
SCT_ID::strip_id(int barrel_ec,
                 int layer_disk,
                 int phi_module,
                 int eta_module,
                 int side,
                 int row,
                 int strip,
                 bool checks) const {
  // Build identifier
  Identifier result((Identifier::value_type) 0);
 
 
  // Pack fields independently
  m_indet_impl.pack(indet_field_value(), result);
  m_sct_impl.pack(sct_field_value(), result);
  m_bec_impl.pack(barrel_ec, result);
  m_lay_disk_impl.pack(layer_disk, result);
  m_phi_mod_impl.pack(phi_module, result);
  m_eta_mod_impl.pack(eta_module, result);
  m_side_impl.pack(side, result);
  if (m_hasRows) {
    m_row_impl.pack(row, result);
  }
  m_strip_impl.pack(strip, result);
 
 
  // Do checks
  if (checks) {
    if (m_hasRows) strip_id_checks(barrel_ec, layer_disk, phi_module, eta_module, side, row, strip);
    else strip_id_checks(barrel_ec, layer_disk, phi_module, eta_module, side, strip);
  }
 
  return result;
}
 
inline Identifier
SCT_ID::strip_id(int barrel_ec,
                 int layer_disk,
                 int phi_module,
                 int eta_module,
                 int side,
                 int row,
                 int strip) const {
  return strip_id(barrel_ec, layer_disk, phi_module, eta_module,
                  side, row, strip, do_checks());
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::strip_id(const Identifier& wafer_id, int strip) const {
  // Build identifier
  Identifier result(wafer_id);
 
  // Reset strip and then add in value
  m_strip_impl.reset(result);
  m_strip_impl.pack(strip, result);
 
  if (m_do_checks) {
    strip_id_checks(barrel_ec(result),
                    layer_disk(result),
                    phi_module(result),
                    eta_module(result),
                    side(result),
                    strip);
  }
  return result;
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::strip_id(const Identifier& wafer_id, int row, int strip) const {
  // Build identifier
  Identifier result(wafer_id);
 
  // Reset strip and then add in value
  if (m_hasRows) {
    m_row_impl.reset(result);
    m_row_impl.pack(row, result);
  }
  m_strip_impl.reset(result);
  m_strip_impl.pack(strip, result);
 
  if (m_do_checks) {
    if (m_hasRows) {
      strip_id_checks(barrel_ec(result),
                      layer_disk(result),
                      phi_module(result),
                      eta_module(result),
                      side(result),
                      row,
                      strip);
    } else {
      strip_id_checks(barrel_ec(result),
                      layer_disk(result),
                      phi_module(result),
                      eta_module(result),
                      side(result),
                      strip);
    }
  }
  return result;
}
 
//----------------------------------------------------------------------------
inline Identifier::diff_type
SCT_ID::calc_offset(const Identifier& base, const Identifier& target) const {
  Identifier::diff_type tval = static_cast<Identifier::diff_type>(target.get_compact() >> base_bit());
  Identifier::diff_type bval = static_cast<Identifier::diff_type>(base.get_compact() >> base_bit());
  return(tval - bval);
}
 
//----------------------------------------------------------------------------
inline Identifier
SCT_ID::strip_id_offset(const Identifier& base,
                        Identifier::diff_type offset) const {
  Identifier::value_type bval = base.get_compact() >> base_bit();
  return Identifier((bval + offset) << base_bit());
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::base_bit() const {
  int base = static_cast<int>(m_strip_impl.shift()); // lowest field base
 
  return (base > 32) ? 32 : base;
  // max base is 32 so we can still read old strip id's and differences
  // from non-SLHC releases.
}
 
//----------------------------------------------------------------------------
inline bool
SCT_ID::is_barrel(const Identifier& id) const {
  // match bec field
  return(m_barrel_field.match(m_bec_impl.unpack(id)));
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::barrel_ec(const Identifier& id) const {
  return(m_bec_impl.unpack(id));
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::layer_disk(const Identifier& id) const {
  return(m_lay_disk_impl.unpack(id));
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::phi_module(const Identifier& id) const {
  return(m_phi_mod_impl.unpack(id));
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::eta_module(const Identifier& id) const {
  return(m_eta_mod_impl.unpack(id));
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::side(const Identifier& id) const {
  return(m_side_impl.unpack(id));
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::row(const Identifier& id) const {
  return(m_row_impl.unpack(id));
}
 
//----------------------------------------------------------------------------
inline int
SCT_ID::strip(const Identifier& id) const {
  return(m_strip_impl.unpack(id));
}
 
inline IdentifierHash
SCT_ID::nextInSequence(const IdentifierHash& id, const hash_vec& vectorOfHashes) const {
  unsigned short index = id;
  if (index < vectorOfHashes.size()) {
    return vectorOfHashes[index];
  }
  return IdentifierHash{};
}
 
#endif // INDETIDENTIFIER_SCT_ID_H