SCT_Forward.cxx

Go to the documentation of this file.

/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/
 
#include "SCT_Forward.h"
 
#include "SCT_MaterialManager.h"
 
#include "SCT_GeometryManager.h"
#include "SCT_ForwardParameters.h"
#include "SCT_ForwardModuleParameters.h"
 
#include "SCT_FwdWheel.h"
#include "SCT_FwdModule.h"
#include "SCT_FwdRing.h"
#include "SCT_FwdSupportFrame.h"
#include "SCT_FwdCoolingPipe.h"
#include "SCT_FwdPowerTape.h"
#include "SCT_FwdCylinderServices.h"
#include "SCT_FwdThermalShieldElement.h"
 
#include "SCT_ReadoutGeometry/SCT_DetectorManager.h"
 
#include "InDetGeoModelUtils/ExtraMaterial.h"
 
#include "GeoModelRead/ReadGeoModel.h"
#include "GeoModelKernel/GeoTube.h"
#include "GeoModelKernel/GeoLogVol.h"
#include "GeoModelKernel/GeoFullPhysVol.h"
#include "GeoModelKernel/GeoNameTag.h"
#include "GeoModelKernel/GeoIdentifierTag.h"
#include "GeoModelKernel/GeoTransform.h"
#include "GeoModelKernel/GeoAlignableTransform.h"
#include "GeoModelKernel/GeoMaterial.h"
#include "GaudiKernel/SystemOfUnits.h"
 
#include <cmath>
#include <utility>
 
SCT_Forward::SCT_Forward(const std::string & name,
             int ec,
                         InDetDD::SCT_DetectorManager* detectorManager,
                         SCT_GeometryManager* geometryManager,
                         SCT_MaterialManager* materials,
                         GeoModelIO::ReadGeoModel* sqliteReader,
                         std::shared_ptr<std::map<std::string, GeoFullPhysVol*>>        mapFPV,
                         std::shared_ptr<std::map<std::string, GeoAlignableTransform*>> mapAX)
: SCT_UniqueComponentFactory(name,
                 detectorManager,
                 geometryManager,
                 materials,
                 sqliteReader,
                 std::move(mapFPV),
                 std::move(mapAX)),
  m_endcap(ec)
{
  getParameters();
  m_logVolume = SCT_Forward::preBuild();
}
 
SCT_Forward::~SCT_Forward() = default;
 
void 
SCT_Forward::getParameters()
{
  const SCT_ForwardParameters * parameters = m_geometryManager->forwardParameters();
  const SCT_ForwardModuleParameters * moduleParameters = m_geometryManager->forwardModuleParameters();
    
  //m_numRingTypes = parameters->fwdNumRingTypes();
  m_numModuleTypes = moduleParameters->fwdModuleNumTypes();
  m_numWheels    = parameters->fwdNumWheels();
  m_innerRadius  = parameters->fwdInnerRadius();
  m_outerRadius  = parameters->fwdOuterRadius();
  m_zMin         = parameters->fwdZMin();
  m_zMax         = parameters->fwdZMax();
  m_trtGapPos    = parameters->fwdTrtGapPos();
  m_coolingPipeRadius        = parameters->fwdCoolingPipeRadius();
  m_numThermalShieldElements = parameters->fwdNumThermalShieldElements();
  m_cylinderServicesPresent  = parameters->fwdCylinderServicePresent();
  
  // Outer radius of cylinder services is given by inner radius of OTE
  if(m_cylinderServicesPresent) {
    for (int iElement = 0; iElement < m_numThermalShieldElements; iElement++){
      if(parameters->fwdThermalShieldMaterial(iElement) == "sct::FwdOTE") {
        m_outerRadiusCylinderServices = parameters->fwdThermalShieldInnerRadius(iElement);
      }
    }
  }
 
  // Length of forward envelope
  m_length = m_zMax - m_zMin;  
 
 
  // Set numerology
  m_detectorManager->numerology().setNumDisks(m_numWheels);
 
 
}
 
 
 
const GeoLogVol * 
SCT_Forward::preBuild()
{
  // Create the elements we need for the forward
  // We make all the module types here. There is a outer, middle, truncated middle and inner type module.
  std::vector<SCT_FwdModule*> modules;
  for (int iModuleType = 0; iModuleType < m_numModuleTypes; iModuleType++){
    
    std::unique_ptr<SCT_FwdModule> module = std::make_unique<SCT_FwdModule>(std::format("FwdModule{}",iModuleType), iModuleType,
                                                                            m_detectorManager, m_geometryManager, m_materials, m_sqliteReader, m_mapFPV, m_mapAX);
    modules.push_back(module.get());
    m_modules.push_back(std::move(module));
  }
 
  for (int iWheel = 0; iWheel < m_numWheels; iWheel++){
    // Build Wheels
    std::string name = std::format("Wheel{}{}",iWheel,((m_endcap > 0) ? "A" : "C"));
    m_wheels.push_back(std::make_unique<SCT_FwdWheel>(name, iWheel, modules, m_endcap,
                                                      m_detectorManager, m_geometryManager, m_materials, m_sqliteReader, m_mapFPV, m_mapAX));
  }
 
  if(m_sqliteReader) return nullptr;
    
  // Make one end of the Forward tracker
  //  Tube envelope containing the forward
  const GeoTube * forwardEnvelopeShape = new GeoTube(m_innerRadius, m_outerRadius, 0.5 * m_length);
  const GeoLogVol * forwardLog = 
    new GeoLogVol(getName(), forwardEnvelopeShape, m_materials->gasMaterial());
  
  return forwardLog;
}
 
GeoVPhysVol * 
SCT_Forward::build(SCT_Identifier id)
{
    GeoFullPhysVol * forward=nullptr;
    if(!m_sqliteReader)
    {
        forward = new GeoFullPhysVol(m_logVolume);
        
        for (int iWheel = 0; iWheel < m_numWheels; iWheel++){
            
            SCT_FwdWheel * wheel = m_wheels[iWheel].get();
            double zpos = wheel->zPosition() - zCenter();
            forward->add(new GeoNameTag(std::format("Wheel#{}",iWheel)));
            forward->add(new GeoIdentifierTag(iWheel));
            GeoAlignableTransform * transform = new GeoAlignableTransform(GeoTrf::TranslateZ3D(zpos));
            forward->add(transform);
            id.setLayerDisk(iWheel);
            GeoVPhysVol * wheelPV = wheel->build(id);
            forward->add(wheelPV);
            
            // Store the alignable transform
            m_detectorManager->addAlignableTransform(2, id.getWaferId(), transform, wheelPV);
        }
        
        //
        // Place SupportFrame
        //
        SCT_FwdSupportFrame supportFrame("SupportFrame", m_detectorManager, m_geometryManager, m_materials);
        double supportFrameZPos = supportFrame.zPosition() - zCenter();
        forward->add(new GeoTransform(GeoTrf::TranslateZ3D(supportFrameZPos)));
        forward->add(supportFrame.getVolume());
        
        // Make and Place Cylinder Services
        
        if(m_cylinderServicesPresent) {
            
            // New phi-dependent services
            SCT_FwdCylinderServices cylinderServices("CylinderServices",
                                                     supportFrame.outerRadius(),
                                                     m_outerRadiusCylinderServices,
                                                     supportFrame.length(),
                                                     m_detectorManager, m_geometryManager, m_materials);
            forward->add(new GeoTransform(GeoTrf::TranslateZ3D(supportFrameZPos)));
            forward->add(cylinderServices.getVolume());
            
        } else {
            
            // Old cylindrical services
            //
            // Make cooling pipes. These extend from the wheel to the TRT Gap.
            //
            {
                // End position of the pipes.
                double endPos = m_trtGapPos;
                
                // Calculate radius to start placing cooling pipes. This is equal to the
                // outer radius of the support frame + the pipe radius (The pipe radius is to just
                // give a small gap - it is not really necessary)
                double innerRadiusCooling = supportFrame.outerRadius() + m_coolingPipeRadius;
                
                // Inner radius of cylinder representing pipes. Gets incremented for each wheel.
                double rStart = innerRadiusCooling;
                
                for (int iWheel = 0; iWheel < m_numWheels; iWheel++){
                    // Start position of the pipes.
                    double startPos = m_wheels[iWheel]->zPosition();
                    
                    // Assume one cooling circuit per quadrant of each ring. ie 8 pipes per ring.
                    int numPipes = 8 * m_wheels[iWheel]->numRings();
                    
                    // Label Cooling pipe with W# at end of string
                    SCT_FwdCoolingPipe coolingPipe(std::format("OffDiskCoolingPipeW{}",iWheel),
                                                   numPipes, rStart, startPos, endPos,
                                                   m_detectorManager, m_geometryManager, m_materials);
                    
                    // Place the cooling pipes
                    double coolingPipeZPos = coolingPipe.zPosition() - zCenter();
                    forward->add(new GeoTransform(GeoTrf::TranslateZ3D(coolingPipeZPos)));
                    forward->add(coolingPipe.getVolume());
                    
                    // Set rStart for next cooling pipe equal to outer radius of this cooling pipe.
                    rStart = coolingPipe.outerRadius();
                    
                }
            }
            
            //
            // Make Power Tapes. These extend from the wheel to the TRT Gap.
            //
            {
                
                // End position of the power tapes.
                double endPos = m_trtGapPos;
                
                // Calculate radius to start placing power tapes. This is half way bewteen outer radius
                // of support fram and outer radius of forward envelope.
                // The -1 mm is to avoid a clash with the thermal shield.
                double innerRadiusPowerTapes = 0.5*(supportFrame.outerRadius() + m_outerRadius) - 1*Gaudi::Units::mm;
                
                // Inner radius of cylinder representing power tapes. Gets incremented for each wheel.
                double rStart = innerRadiusPowerTapes;
                
                for (int iWheel = 0; iWheel < m_numWheels; iWheel++){
                    
                    // Start position of the power tapes.
                    double startPos = m_wheels[iWheel]->zPosition();
                    
                    // Get total number of modules in wheel
                    int numModules = m_wheels[iWheel]->totalModules();
                    
                    // Label power tape with W# at end of string
                    SCT_FwdPowerTape powerTape(std::format("OffDiskPowerTapeW{}",iWheel),
                                               numModules, rStart, startPos, endPos,
                                               m_detectorManager, m_geometryManager, m_materials);
                    
                    // Place Power Tapes
                    double powerTapeZPos = powerTape.zPosition() - zCenter();
                    forward->add(new GeoTransform(GeoTrf::TranslateZ3D(powerTapeZPos)));
                    forward->add(powerTape.getVolume());
                    
                    // Set rStart for next power tape equal to outer radius of this power tape.
                    rStart = powerTape.outerRadius();
                } // end loop over wheels
            }
        }
        
        //
        // Place Thermal Shield Elements
        //
        for (int iElement = 0; iElement < m_numThermalShieldElements; iElement++){
      SCT_FwdThermalShieldElement thermalShieldElement(std::format("FwdThermalShieldElement{}",iElement),
                               iElement, m_detectorManager, m_geometryManager, m_materials);
      double elementZPos = thermalShieldElement.zPosition() - zCenter();
      forward->add(new GeoTransform(GeoTrf::TranslateZ3D(elementZPos)));
      forward->add(thermalShieldElement.getVolume());
        }
        
        // Extra Material
        InDetDD::ExtraMaterial xMat(m_geometryManager->distortedMatManager());
        xMat.add(forward, "SCTEndcap", zCenter());
        if (m_endcap > 0) {
      xMat.add(forward, "SCTEndcapA", zCenter());
        } else {
      xMat.add(forward, "SCTEndcapC", zCenter());
        }
 
    }
    else {
      for (int iWheel = 0; iWheel < m_numWheels; iWheel++){
    SCT_FwdWheel * wheel = m_wheels[iWheel].get();
    id.setLayerDisk(iWheel);
    wheel->build(id);
 
    // Store the alignable transform
    std::string key = std::format("Wheel#{}_{}",iWheel,id.getBarrelEC());
    m_detectorManager->addAlignableTransform(2, id.getWaferId(), (*m_mapAX)[key], (*m_mapFPV)[key]);
      }
      if (m_endcap > 0) {
    forward= (*m_mapFPV)["SCTEndcapA"];
      } else {
    forward= (*m_mapFPV)["SCTEndcapC"];
      }
 
    }
    return forward;
}