ActsTrk::BeamPipeBlueprintNodeBuilder Class Reference

Helper class to build the BeamPipe Blueprint node It adds the beam pipe as a node to the Blueprint. More...

#include <BeamPipeBlueprintNodeBuilder.h>

Inheritance diagram for ActsTrk::BeamPipeBlueprintNodeBuilder:

Collaboration diagram for ActsTrk::BeamPipeBlueprintNodeBuilder:

Public Member Functions
StatusCode	initialize () override
std::shared_ptr< Acts::Experimental::BlueprintNode >	buildBlueprintNode (const Acts::GeometryContext &gctx, std::shared_ptr< Acts::Experimental::BlueprintNode > &&child) override
	Build the BeamPipe Blueprint Node.

Private Attributes
const BeamPipeDetectorManager *	m_beamPipeMgr {nullptr}
Gaudi::Property< bool >	m_loadfromDatabase
Gaudi::Property< double >	m_defaultInnerRadius

Detailed Description

Helper class to build the BeamPipe Blueprint node It adds the beam pipe as a node to the Blueprint.

Definition at line 17 of file BeamPipeBlueprintNodeBuilder.h.

Member Function Documentation

buildBlueprintNode()

std::shared_ptr< Acts::Experimental::BlueprintNode > ActsTrk::BeamPipeBlueprintNodeBuilder::buildBlueprintNode ( const Acts::GeometryContext & gctx, std::shared_ptr< Acts::Experimental::BlueprintNode > && child )

override

Build the BeamPipe Blueprint Node.

Parameters

gctx	Geometry context
child	Expected to be null; beam pipe has no inner child.

Definition at line 50 of file BeamPipeBlueprintNodeBuilder.cxx.

                                                          {
 
  // Beam pipe is the innermost element and has no child to wrap
  if (child) {
    ATH_MSG_ERROR("BeamPipeBlueprintNodeBuilder expects no child node");
    throw std::runtime_error("Child node is not null");
  }
 
  // If the manager is available, use it to construct the beam pipe geometry,
  // and retrieve the beampipe radius from the geometry database.
  // Otherwise, use default parameters to construct a simple tube.
  double beamPipeRadius = m_defaultInnerRadius;  // mm
  Amg::Transform3D beamPipeTransform = Amg::Transform3D::Identity();
 
  if (m_loadfromDatabase) {
 
    // Navigate the GeoModel tree to reach the actual beam pipe volume.
    // When there is a single tree top, the real tube sits two levels down
    // (envelope → envelope → tube).
    PVConstLink beamPipeTopVolume = m_beamPipeMgr->getTreeTop(0);
    if (m_beamPipeMgr->getNumTreeTops() == 1) {
      beamPipeTopVolume =
          m_beamPipeMgr->getTreeTop(0)->getChildVol(0)->getChildVol(0);
    }
 
    // Extract the translation so the volume is placed at the same
    // position as the GeoModel volume.
    beamPipeTransform =
        Amg::getTranslate3D(beamPipeTopVolume->getX().translation());
 
    // If SectionC03 is found, then overwrite the default radius
    const GeoLogVol* beamPipeLogVolume = beamPipeTopVolume->getLogVol();
    if (beamPipeLogVolume == nullptr) {
      ATH_MSG_ERROR("Beam pipe volume has no log volume");
      throw std::runtime_error("Beam pipe volume has no log volume");
    }
 
    const GeoTube* beamPipeTube =
        dynamic_cast<const GeoTube*>(beamPipeLogVolume->getShape());
    if (beamPipeTube == nullptr) {
      ATH_MSG_ERROR("BeamPipeLogVolume was not of type GeoTube");
      throw std::runtime_error{"BeamPipeLogVolume was not of type GeoTube"};
    }
 
    // SectionC03 is the central beam-pipe section at η≈0 whose mid-radius is
    // used as the representative beam pipe radius for the Acts cylinder.
    for (unsigned int i = 0; i < beamPipeTopVolume->getNChildVols(); i++) {
      if (beamPipeTopVolume->getNameOfChildVol(i) != "SectionC03") {
        continue;
      }
      PVConstLink childTopVolume = beamPipeTopVolume->getChildVol(i);
      const GeoLogVol* childLogVolume = childTopVolume->getLogVol();
      const GeoTube* childTube =
          dynamic_cast<const GeoTube*>(childLogVolume->getShape());
      if (childTube) {
        beamPipeRadius = 0.5 * (childTube->getRMax() + childTube->getRMin());
        break;
      }
    }
 
    ATH_MSG_VERBOSE(
        "BeamPipe constructed from database with radius = " << beamPipeRadius);
    ATH_MSG_VERBOSE(
        "BeamPipe shift : " << beamPipeTransform.translation().transpose());
  } else {
    ATH_MSG_VERBOSE(
        "BeamPipe constructed from default parameters with radius = "
        << beamPipeRadius);
    ATH_MSG_VERBOSE(
        "BeamPipe shift : " << beamPipeTransform.translation().transpose());
  }
 
  // Build the blueprint subtree:
  //   GeometryIdentifierNode  (assigns volume ID s_beamPipeVolumeId)
  //     └── MaterialDesignator "BeamPipe_Material"  (material on outer
  //     cylinder)
  //           └── StaticVolume "BeamPipe"           (the actual cylinder)
  auto beamPipeNode =
      std::make_shared<Acts::Experimental::GeometryIdentifierBlueprintNode>();
  beamPipeNode->setAllVolumeIdsTo(s_beamPipeVolumeId).incrementLayerIds(1);
 
  auto& beamPipeContainer =
      beamPipeNode->addCylinderContainer("BeamPipeContainer", AxisR);
  beamPipeContainer.setAttachmentStrategy(AttachmentStrategy::Gap);
  beamPipeContainer.setResizeStrategy(ResizeStrategy::Gap);
 
  beamPipeContainer.addMaterial("BeamPipe_Material", [&](auto& mat) {
    // Place material on the outer cylindrical surface facing outward
    mat.configureFace(OuterCylinder, {AxisRPhi, Closed, 20},
                      {AxisZ, Bound, 20});
    // A solid cylinder from r=0 to beamPipeRadius, extending ±3 m in z
    mat.addStaticVolume(beamPipeTransform,
                        std::make_shared<Acts::CylinderVolumeBounds>(
                            0, beamPipeRadius * 1_mm, 3. * 1_m),
                        "BeamPipeVolume");
  });
 
  return beamPipeNode;
}

initialize()

StatusCode ActsTrk::BeamPipeBlueprintNodeBuilder::initialize ( )

override

Definition at line 42 of file BeamPipeBlueprintNodeBuilder.cxx.

                                                    {
  if (m_loadfromDatabase) {
    ATH_CHECK(detStore()->retrieve(m_beamPipeMgr, "BeamPipe"));
  }
  return StatusCode::SUCCESS;
}

Member Data Documentation

m_beamPipeMgr

const BeamPipeDetectorManager* ActsTrk::BeamPipeBlueprintNodeBuilder::m_beamPipeMgr {nullptr}

private

Definition at line 32 of file BeamPipeBlueprintNodeBuilder.h.

{nullptr};

m_defaultInnerRadius

Gaudi::Property<double> ActsTrk::BeamPipeBlueprintNodeBuilder::m_defaultInnerRadius

private

Initial value:

{
      this, "defaultInnerRadius", 20.,
      "The inner radius of the beam pipe to use if not loading from the "
      "database."}

Definition at line 39 of file BeamPipeBlueprintNodeBuilder.h.

                                            {
      this, "defaultInnerRadius", 20.,
      "The inner radius of the beam pipe to use if not loading from the "
      "database."};

m_loadfromDatabase

Gaudi::Property<bool> ActsTrk::BeamPipeBlueprintNodeBuilder::m_loadfromDatabase

private

Initial value:

{
      this, "loadFromDatabase", true,
      "Whether to load the beam pipe geometry from the geometry database. If "
      "false, a default tube will be created based on some default value."}

Definition at line 34 of file BeamPipeBlueprintNodeBuilder.h.

                                        {
      this, "loadFromDatabase", true,
      "Whether to load the beam pipe geometry from the geometry database. If "
      "false, a default tube will be created based on some default value."};

---

The documentation for this class was generated from the following files:

• BeamPipeBlueprintNodeBuilder.h
• BeamPipeBlueprintNodeBuilder.cxx