Wraps a single child blueprint node and pads it into a larger volume whose dimensions are evaluated at construction time using the child's extent plus a configurable envelope. More...

#include <Acts/Geometry/PadBlueprintNode.hpp>

Inheritance diagram for Acts::PadBlueprintNode:

[legend]

Collaboration diagram for Acts::PadBlueprintNode:

[legend]

Public Member Functions
	PadBlueprintNode (const std::string &name, const ExtentEnvelope &envelope)
	Main constructor for the padding node.
Volume &	build (const BlueprintOptions &options, const GeometryContext &gctx, const Logger &logger=Acts::getDummyLogger()) override
	This method is called during the build phase of the blueprint tree construction.
Public Member Functions inherited from Acts::StaticBlueprintNode
	StaticBlueprintNode (std::unique_ptr< TrackingVolume > volume)
	Construct the static node from an existing volume.
Volume &	build (const BlueprintOptions &options, const GeometryContext &gctx, const Logger &logger=Acts::getDummyLogger()) override
	This method is called during the build phase of the blueprint tree construction.
PortalShellBase &	connect (const BlueprintOptions &options, const GeometryContext &gctx, const Logger &logger=Acts::getDummyLogger()) override
	This method is called during the connect phase.
void	finalize (const BlueprintOptions &options, const GeometryContext &gctx, TrackingVolume &parent, const Logger &logger=Acts::getDummyLogger()) override
	This method is called during the finalize phase.
const std::string &	name () const override
	Get the name of this node.
const NavigationPolicyFactory *	navigationPolicyFactory () const
	Get the navigation policy factory for this node.
virtual StaticBlueprintNode &	setNavigationPolicyFactory (std::shared_ptr< NavigationPolicyFactory > navigationPolicyFactory)
	Set the navigation policy factory for this node.
Public Member Functions inherited from Acts::BlueprintNode
virtual	~BlueprintNode ()=default
	Virtual destructor to ensure correct cleanup.
BlueprintNode &	addChild (std::shared_ptr< BlueprintNode > child)
	Register a `child` to this node.
MutableChildRange	children ()
	Return a MutableChildRange to the children of this node.
ChildRange	children () const
	Return a ChildRange to the children of this node.
void	clearChildren ()
	Remove all children from this node.
std::size_t	depth () const
	Return the depth of this node in the blueprint tree.
void	graphviz (std::ostream &os) const
	Print the node tree starting from this node to graphviz format.
StaticBlueprintNode &	addStaticVolume (std::unique_ptr< TrackingVolume > volume, const std::function< void(StaticBlueprintNode &cylinder)> &callback={})
	This method creates a new Acts::StaticBlueprintNode wrapping `volume` and adds it to this node as a child.
StaticBlueprintNode &	addStaticVolume (const Transform3 &transform, std::shared_ptr< VolumeBounds > volumeBounds, const std::string &volumeName="undefined", const std::function< void(StaticBlueprintNode &cylinder)> &callback={})
	Alternative overload for creating a Acts::StaticBlueprintNode.
CylinderContainerBlueprintNode &	addCylinderContainer (const std::string &name, AxisDirection direction, const std::function< void(CylinderContainerBlueprintNode &cylinder)> &callback={})
	Convenience method for creating a cylinder specialization of Acts::ContainerBlueprintNode.
CuboidContainerBlueprintNode &	addCuboidContainer (const std::string &name, AxisDirection direction, const std::function< void(CuboidContainerBlueprintNode &cylinder)> &callback={})
	Convenience method for creating a cuboid specialization of Acts::ContainerBlueprintNode.
MaterialDesignatorBlueprintNode &	addMaterial (const std::string &name, const std::function< void(MaterialDesignatorBlueprintNode &material)> &callback={})
	Convenience method for creating a Acts::MaterialDesignatorBlueprintNode.
PortalDesignatorBlueprintNode &	addPortalDesignator (const std::string &name, const std::function< void(PortalDesignatorBlueprintNode &portals)> &callback={})
	Convenience method for creating a Acts::PortalDesignatorBlueprintNode.
LayerBlueprintNode &	addLayer (const std::string &name, const std::function< void(LayerBlueprintNode &layer)> &callback={})
	Convenience method for creating a Acts::LayerBlueprintNode.
GeometryIdentifierBlueprintNode &	withGeometryIdentifier (const std::function< void(GeometryIdentifierBlueprintNode &geometryIdentifier)> &callback={})
	Convenience method for creating a Acts::GeometryIdentifierBlueprintNode.

Static Public Member Functions
static std::unique_ptr< TrackingVolume >	padded (const GeometryContext &gctx, const Volume &inner, const ExtentEnvelope &envelope, const std::string &name, const Logger &logger=Acts::getDummyLogger())
	Create a volume that encloses `inner`, enlarged by `envelope`.

Additional Inherited Members
Public Types inherited from Acts::BlueprintNode
using	ChildRange
	A range-like object that allows range based for loops and index access.
using	MutableChildRange
	A range-like object that allows range based for loops and index access.
Protected Member Functions inherited from Acts::StaticBlueprintNode
void	addToGraphviz (std::ostream &os) const override
	Method that writes a representatiohn of this node only to graphviz.
Protected Member Functions inherited from Acts::BlueprintNode
std::span< std::shared_ptr< BlueprintNode > >	childPtr ()
	Return a span over the children's shared_ptrs.
std::span< const std::shared_ptr< BlueprintNode > >	childPtr () const
	Return a span over the children's shared_ptrs.
std::string	indent () const
	An indentation depending on the depth of this node.
std::string	prefix () const
	Printing helper returning a prefix including an indent depending on the depth.
void	setDepth (std::size_t depth)
	Set the depth to `depth` and update children recursively.
virtual void	toStream (std::ostream &os) const
	Virtual method to determine stream representation.
Protected Attributes inherited from Acts::StaticBlueprintNode
std::shared_ptr< NavigationPolicyFactory >	m_navigationPolicyFactory
	Factory for creating navigation policies for this volume.
std::unique_ptr< PortalShellBase >	m_shell
	Portal shell representation for geometry connection.
std::unique_ptr< TrackingVolume >	m_volume
	The wrapped tracking volume managed by this blueprint node.

Detailed Description

Wraps a single child blueprint node and pads it into a larger volume whose dimensions are evaluated at construction time using the child's extent plus a configurable envelope.

Note: This node can only have a single child. This is not an error during tree building, but during geometry construction. It defers most of the functionality to Acts::StaticBlueprintNode, and only implements the build phase to perform the padding.

Constructor & Destructor Documentation

◆ PadBlueprintNode()

Acts::PadBlueprintNode::PadBlueprintNode	(	const std::string &	name,
		const ExtentEnvelope &	envelope )

explicit

Main constructor for the padding node.

Parameters

name	The name of the padded volume.
envelope	The envelope to apply to the child node's extent to create the padded volume.

Member Function Documentation

◆ build()

Volume & Acts::PadBlueprintNode::build	(	const BlueprintOptions &	options,
		const GeometryContext &	gctx,
		const Logger &	logger = Acts::getDummyLogger() )

overridevirtual

This method is called during the build phase of the blueprint tree construction.

It returns a single Acts::Volume which represents transform and bounds of the entire subtree. This does not have to correspond to the final Acts::TrackingVolume, some node types will produce temporary volume representations. Lifetime of the returned volume is managed by the source node! Nodes higher in the hierarchy will issue resizes down the tree hierarchy. This is not done through a direct hierarchy, but coordinated by the respective node type, by internally consulting its children.

Note: Generally, you should not need to to call this method directly. The construction should usually be done through the special Acts::Blueprint class.

Parameters

options	The global construction options
gctx	The geometry context for construction (usually nominal)
logger	The logger to use for output during construction

Returns: The volume used for communicating transform and size up the hierarchy Build-phase of the blueprint construction. Returns the padded volume.

Implements Acts::BlueprintNode.

◆ padded()

std::unique_ptr< TrackingVolume > Acts::PadBlueprintNode::padded	(	const GeometryContext &	gctx,
		const Volume &	inner,
		const ExtentEnvelope &	envelope,
		const std::string &	name,
		const Logger &	logger = Acts::getDummyLogger() )

static

Create a volume that encloses inner, enlarged by envelope.

The padded volume inherits the transform of inner, and its bounds are expanded in the local frame of inner.

Note: The envelope must be symmetric in every direction that the bounds cannot express asymmetrically (z for cylinders, all of x/y/z for cuboids), otherwise the padded volume could not stay centered on inner.

Parameters

gctx	The geometry context
inner	The volume to enclose
envelope	The envelope to add to the bounds of `inner`
name	The name of the padded volume
logger	The logger to use

Returns: The padded volume enclosing inner

Exceptions

std::logic_error if inner has unsupported bounds, or if the envelope is asymmetric where it must not be

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ PadBlueprintNode()

Member Function Documentation

◆ build()

◆ padded()