MuonGMR4::MdtReadoutElement Class Reference

Readout element to describe the Monitored Drift Tube (Mdt) chambers Mdt chambers usually comrpise out of two packs consisting out of 3 or 4 tube layers which are separated by a space frame onto which they are glued. More...

#include <MdtReadoutElement.h>

Inheritance diagram for MuonGMR4::MdtReadoutElement:

Collaboration diagram for MuonGMR4::MdtReadoutElement:

Classes
struct	defineArgs
	Declare the define args as concatination of the parameters to describe the chamber and the defineArgs from the MuonReadoutElement holding the Identifier && GeoModel objects. More...
struct	parameterBook
	Set of parameters to describe a MDT chamber. More...

Public Member Functions
	MdtReadoutElement (defineArgs &&args)
	Constructor with the define arguments.
virtual	~MdtReadoutElement ()
	Destructor.
const parameterBook &	getParameters () const
	Get a const reference to the parameter book.
ActsTrk::DetectorType	detectorType () const override final
	Overload the detector type.
double	thickness () const override final
	Overload from the Acts::DetectorElement (2 * halfheight)
StatusCode	initElement () override final
	Overload from MuonReadoutElement.
unsigned	multilayer () const
	Returns the multi layer of the readout element [1;\2].
unsigned	numLayers () const
	Returns how many tube layers are inside the multi layer [1;4].
unsigned	numTubesInLay () const
	Returns the number of tubes in a layer.
IdentifierHash	measurementHash (const Identifier &measId) const override final
	Constructs the measurement hash from the full measurement Identifier.
IdentifierHash	layerHash (const Identifier &measId) const override final
	Projects the measurement hash onto the layerHash mainly used to access the plane surface in the center of each tube layer.
Identifier	measurementId (const IdentifierHash &measHash) const override final
	Back conversion of the measurement hash towards a full identifier Tube & layer number are extracted from the hash and combined with the mising Identifier fields from the readout element.
bool	isValid (const IdentifierHash &measHash) const
	Checks whether the passed meaurement hash corresponds to a valid tube described by the readout element.
bool	isBarrel () const
	States whether the chamber is built into the barrel or not.
double	tubePitch () const
	Returns the pitch between 2 tubes in a layer.
double	innerTubeRadius () const
	Returns the inner tube radius.
double	tubeRadius () const
	Adds the thickness of the tube wall onto the radius.
double	moduleWidthS () const
	Returns the length of the bottom edge of the chamber (short width)
double	moduleWidthL () const
	Returns the length of the top edge of the chamber (top width)
double	moduleHeight () const
	Returns the height of the chamber (Distance bottom - topWidth)
double	moduleThickness () const
	Returns the thickness of the chamber.
Amg::Vector3D	globalTubePos (const ActsTrk::GeometryContext &ctx, const Identifier &measId) const
	Returns the position of the tube mid point in the ATLAS coordinate frame.
Amg::Vector3D	globalTubePos (const ActsTrk::GeometryContext &ctx, const IdentifierHash &hash) const
	Returns the position of the tube mid point in the ATLAS coordinate frame.
Amg::Vector3D	readOutPos (const ActsTrk::GeometryContext &ctx, const Identifier &measId) const
	Returns the endpoint of the tube where the readout card is mounted in the ATLAS coordinate frame.
Amg::Vector3D	readOutPos (const ActsTrk::GeometryContext &ctx, const IdentifierHash &hash) const
	Returns the endpoint of the tube where the readout card is mounted in the ATLAS coordinate frame.
Amg::Vector3D	highVoltPos (const ActsTrk::GeometryContext &ctx, const Identifier &measId) const
	Returns the endpoint of the tube connected to the high voltage in the ATLAS coordinate frame.
Amg::Vector3D	highVoltPos (const ActsTrk::GeometryContext &ctx, const IdentifierHash &hash) const
	Returns the endpoint of the tube connected to the high voltage in the ATLAS coordinate frame.
double	distanceToReadout (const ActsTrk::GeometryContext &ctx, const Identifier &measId, const Amg::Vector3D &globPoint) const
	Returns the distance to the readout card along the wire.
double	distanceToReadout (const ActsTrk::GeometryContext &ctx, const IdentifierHash &measHash, const Amg::Vector3D &globPoint) const
	Returns the distance to the readout card along the wire.
double	distanceToReadout (const IdentifierHash &measHash, const Amg::Vector3D &localPoint) const
	Returns the distance to the readout assuming that the parsed point is expressed in the local coordinate system of the tube.
double	activeTubeLength (const IdentifierHash &hash) const
double	tubeLength (const IdentifierHash &hash) const
double	wireLength (const IdentifierHash &hash) const
double	uncutTubeLength (const IdentifierHash &tubeHash) const
	Returns the uncut tube length.
void	setComplementaryReadoutEle (const MdtReadoutElement *other)
	Set the link to the second readout element inside the muon station.
Amg::Vector3D	bLineReferencePoint () const
	Returns the fixed point of the B-line & as-bult defromation model expressed in the as-built frame.
Amg::Vector3D	localTubePos (const IdentifierHash &hash) const
	Returns the tube position in the chamber coordinate frame (Not applying the B-line corrections)
Amg::Transform3D	asBuiltRefFrame () const
	Returns the transformation to go into the reference frame of the as-buit & b-line model starting from the readout element frame.
const MdtReadoutElement *	complementaryRE () const
	Returns the pointer to the other readout element inside the muon station.
const GeoAlignableTransform *	alignableTransform () const
	Return the alignable transform node of the readout element.
Identifier	identify () const override final
	Return the ATLAS identifier.
IdentifierHash	identHash () const
	Returns the hash of the readout element which is identical to the detector element hash provided by the associated idHelper.
int	stationName () const
	Returns the stationName (BIS, BOS, etc) encoded into the integer.
int	stationEta () const
	Returns the stationEta (positive A site, negative C site)
int	stationPhi () const
	Returns the stationPhi (1-8) -> sector (2*phi - (isSmall))
Muon::MuonStationIndex::ChIndex	chamberIndex () const
	Returns the chamber index of the Identifier (MMS & STS) have the same chamber Index (EIS)
const std::string &	chamberDesign () const
	The chamber design refers to the construction parameters of a readout element.
const Muon::IMuonIdHelperSvc *	idHelperSvc () const
	Returns the pointer to the muonIdHelperSvc.
Amg::Vector3D	center (const ActsTrk::GeometryContext &ctx) const
	Returns the geometrical center point of the readout element.
Amg::Vector3D	center (const ActsTrk::GeometryContext &ctx, const Identifier &id) const
	Returns the origin of the readout element's transform.
Amg::Vector3D	center (const ActsTrk::GeometryContext &ctx, const IdentifierHash &hash) const
	Returns the origin of the readout element's transform.
Amg::Transform3D	globalToLocalTransform (const ActsTrk::GeometryContext &ctx) const
	Returns the transformation from the global ATLAS coordinate system into the local coordinate system of the readout element.
Amg::Transform3D	globalToLocalTransform (const ActsTrk::GeometryContext &ctx, const Identifier &id) const
	Returns the transformations from the ATLAS coordinate system into the local coordinate system of the readout sensor.
Amg::Transform3D	globalToLocalTransform (const ActsTrk::GeometryContext &ctx, const IdentifierHash &hash) const
	Returns the transformations from the ATLAS coordinate system into the local coordinate system using the measurement / layer hash mechanism.
const Amg::Transform3D &	localToGlobalTransform (const ActsTrk::GeometryContext &ctx) const
	Returns the transformation from the local coordinate system of the readout element into the global ATLAS coordinate system (inverse of globalToLocal).
const Amg::Transform3D &	localToGlobalTransform (const ActsTrk::GeometryContext &ctx, const Identifier &id) const
	Returns the transformation from the local coordinate system of the readout element into the global ATLAS coordinate system (inverse of globalToLocal).
const Amg::Transform3D &	localToGlobalTransform (const ActsTrk::GeometryContext &ctx, const IdentifierHash &id) const
	Returns the transformation from the local coordinate system of the readout element into the global ATLAS coordinate system (inverse of globalToLocal).
const Amg::Transform3D &	localToGlobalTransform (const Acts::GeometryContext &gctx) const override final
	Wrapper function of the localToGlobalTransform method to satisfy the Acts::IDetectorElementBase interface.
const Acts::Surface &	surface () const override final
	Returns the surface associated with the readout element.
Acts::Surface &	surface () override final
	Returns the mutable surface associated with the readout element.
const Acts::Surface &	surface (const IdentifierHash &hash) const
	Returns the surface associated with the transform of a given readout layer.
Acts::Surface &	surface (const IdentifierHash &hash)
	Returns the mutable surface associated with the transform of a given readout layer.
std::shared_ptr< Acts::Surface >	surfacePtr (const IdentifierHash &hash) const
	Returns the mutable surface pointer associated with the transform of a given readout layer.
std::vector< std::shared_ptr< Acts::Surface > >	getSurfaces () const
	Returns all surfaces that are associated with the active readout planes.
void	setChamberLink (const Chamber *chamber)
	Sets the link to the enclosing chamber.
void	setSectorLink (const SpectrometerSector *envelope)
	Set the link to the enclosing sector envelope.
const SpectrometerSector *	msSector () const
	Returns the pointer to the envelope volume enclosing all chambers in the sector.
const Chamber *	chamber () const
	Returns the pointer to the chamber enclosing this readout element.
virtual bool	isSensitive () const final override
	Returns whether the detector element is sensitive.
void	releaseUnAlignedTrfs () const
	Release all transforms from the memory that are not connected with a geometry context but cached by the readout element itself.
unsigned int	storeAlignedTransforms (const ActsTrk::DetectorAlignStore &store) const override final
	Construct the final aligned transformations and store them in the alignment store.
bool	msgLvl (const MSG::Level lvl) const
	Test the output level.
MsgStream &	msg () const
	The standard message stream.
MsgStream &	msg (const MSG::Level lvl) const
	The standard message stream.
void	setLevel (MSG::Level lvl)
	Change the current logging level.

Static Public Member Functions
static IdentifierHash	measurementHash (unsigned layerNumber, unsigned tubeNumber)
	Constructs a Measurement hash from layer && tube number.
static unsigned	tubeNumber (const IdentifierHash &hash)
	Transforms the measurement hash into a tube number ranging from [0; numTubeInLay() -1].
static unsigned	layerNumber (const IdentifierHash &hash)
	Transforms the measurement hash into a tube-layer number ranging from [0; numLayers() -1].
static IdentifierHash	layerHash (const IdentifierHash &measHash)
	Static method to tranform a measurement hash into a layer hash.

Protected Member Functions
const Amg::Transform3D &	toStation (const ActsTrk::DetectorAlignStore *alignStore) const
	Returns the transformation from the GeoModel tree and applies the A-lines if a valid alignment store pointer is provided.
template<class MuonDetImpl>
StatusCode	insertTransform (const IdentifierHash &hash)
	Constructs the TransformDetEleCache associated with the hash of the given Mdt tube or strip layer.
StatusCode	createGeoTransform ()
	Creates the TransformCacheDetEle corresponding the generic local -> global transformation of the readout element.
StatusCode	strawSurfaceFactory (const IdentifierHash &hash, std::shared_ptr< const Acts::LineBounds > lBounds)
	Invokes the factory to create straw surfaces && to associate them with the particular transform cache.
StatusCode	planeSurfaceFactory (const IdentifierHash &hash, std::shared_ptr< const Acts::PlanarBounds > pBounds)
	Invokes the factory to create plane surfaces && to associate them with the particular transform cache.

Static Protected Member Functions
static IdentifierHash	geoTransformHash ()
	Returns the hash that is associated with the surface cache holding the transformation that is placing the ReadoutElement inside the ATLAS coordinate system.

Private Types
using	tubeSide_t = MdtAsBuiltPar::tubeSide_t
	Moves the wire endpoints according to the as-built model.
using	TransformCacheMap = std::vector<std::unique_ptr<ActsTrk::TransformCache>>
	The transform caches corresponding to the surfaces of the tubes and gas gap planes.

Private Member Functions
Amg::Transform3D	toChamberLayer (const IdentifierHash &hash) const
	Returns the transformation into the rest frame of the tube x-axis: Pointing towards the next layer y-axis: Pointing parallel to the wire layer z-axis: Pointing along the wire.
Amg::Transform3D	toTubeFrame (const IdentifierHash &hash) const
	Returns the transformation into the rest frame of the tube x-axis: Pointing towards the next layer y-axis: Pointing parallel to the wire layer z-axis: Pointing along the wire.
Amg::Transform3D	fromIdealToDeformed (const IdentifierHash &tubeHash, const ActsTrk::DetectorAlignStore *store) const
	Applies the B & as-built parameters.
Amg::Vector3D	wireEndpointAsBuilt (const MdtAsBuiltPar &asBuilt, const IdentifierHash &tubeHash, const Amg::Vector3D &nominalEnd, const tubeSide_t side) const
Amg::Vector3D	applyBlineCorrections (const BLinePar &bline, const Amg::Vector3D &localTubeEndPoint, const Amg::Vector3D &fixedPoint, const double thickness) const
	Apply the B-line model correction to a tube endpoint.
const ActsTrk::TransformCache *	transformCache (const IdentifierHash &measHash) const
	Returns the pointer to the TransformCache associated with this measurement hash.
void	initMessaging () const
	Initialize our message level and MessageSvc.

Private Attributes
parameterBook	m_pars {}
	defining parameter set
const MdtIdHelper &	m_idHelper {idHelperSvc()->mdtIdHelper()}
	Detector identifier helper to quickly extract the ID fields.
int	m_stML {m_idHelper.multilayer(identify())}
	Identifier index of the multilayer (1-2)
bool	m_isBarrel {m_idHelper.isBarrel(identify())}
	Flag defining whether the chamber is barrel or not.
const MdtReadoutElement *	m_reOtherMl {this}
	Complementary readout element.
ServiceHandle< Muon::IMuonIdHelperSvc >	m_idHelperSvc {"Muon::MuonIdHelperSvc/MuonIdHelperSvc", "MuonReadoutElement"}
	IdHelperSvc for Identifier manipulation.
const defineArgs	m_args {}
IdentifierHash	m_detElHash {}
	Cache of the detector element hash.
int	m_stName {-1}
	Cache the station name of the identifier.
int	m_stEta {-1}
	Cache the station eta of the identifier.
int	m_stPhi {-1}
	Cache the station phi of the identifier.
TransformCacheMap	m_localToGlobalCaches {}
std::unique_ptr< ActsTrk::TransformCache >	m_centralTrfCache {}
	Cache of the transform of the readout element itself.
Muon::MuonStationIndex::ChIndex	m_chIdx {Muon::MuonStationIndex::ChIndex::ChUnknown}
	Cache the chamber index of the Identifier.
ActsTrk::SurfaceCacheSet	m_surfaces
	Cache of all associated surfaces.
const SpectrometerSector *	m_msSectorLink {}
	Pointer to the associated MS-sector & MuonChamber.
const Chamber *	m_chambLink {nullptr}
std::string	m_nm
	Message source name.
boost::thread_specific_ptr< MsgStream >	m_msg_tls
	MsgStream instance (a std::cout like with print-out levels)
std::atomic< IMessageSvc * >	m_imsg { nullptr }
	MessageSvc pointer.
std::atomic< MSG::Level >	m_lvl { MSG::NIL }
	Current logging level.
std::atomic_flag m_initialized	ATLAS_THREAD_SAFE = ATOMIC_FLAG_INIT
	Messaging initialized (initMessaging)

Detailed Description

Readout element to describe the Monitored Drift Tube (Mdt) chambers Mdt chambers usually comrpise out of two packs consisting out of 3 or 4 tube layers which are separated by a space frame onto which they are glued.

Each readout element covers the description of one such pack called a multilayer. The multilayers have an internal numbering of tubes and layers. The first tube of the first layer is defined to be closed to the IP.

Definition at line 25 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

Member Typedef Documentation

TransformCacheMap

using MuonGMR4::MuonReadoutElement::TransformCacheMap = std::vector<std::unique_ptr<ActsTrk::TransformCache>>

privateinherited

The transform caches corresponding to the surfaces of the tubes and gas gap planes.

Definition at line 271 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

tubeSide_t

using MuonGMR4::MdtReadoutElement::tubeSide_t = MdtAsBuiltPar::tubeSide_t

private

Moves the wire endpoints according to the as-built model.

Parameters

asBuilt	As-built model parameters
tubeHash	Measurement hash of the considered tube
nominalEnd	Tube end of a nominally uncut tube
side	Does the end represent positive or negative z

Definition at line 263 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

Constructor & Destructor Documentation

MdtReadoutElement()

MuonGMR4::MdtReadoutElement::MdtReadoutElement

(

defineArgs &&

args

)

Constructor with the define arguments.

Definition at line 41 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

    : MuonReadoutElement(args),
      m_pars{std::move(args)} {
}

~MdtReadoutElement()

MuonGMR4::MdtReadoutElement::~MdtReadoutElement ( )

virtualdefault

Destructor.

Member Function Documentation

activeTubeLength()

double MuonGMR4::MdtReadoutElement::activeTubeLength

(

const IdentifierHash &

hash

)

const

Definition at line 173 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                           {
   const unsigned int layer = layerNumber(hash);
   const unsigned int tube = tubeNumber(hash);
   const MdtTubeLayer& zeroT{*m_pars.tubeLayers[layer]}; 
   return 2. * zeroT.tubeHalfLength(tube);
}

alignableTransform()

const GeoAlignableTransform * MuonGMR4::MuonReadoutElement::alignableTransform ( ) const

inherited

Return the alignable transform node of the readout element.

applyBlineCorrections()

Amg::Vector3D MuonGMR4::MdtReadoutElement::applyBlineCorrections ( const BLinePar & bline, const Amg::Vector3D & localTubeEndPoint, const Amg::Vector3D & fixedPoint, const double thickness ) const

private

Apply the B-line model correction to a tube endpoint.

Parameters

bline	Set of b-line parameters
localTubeEndPoint	Endpoint of the tube to correct
fixedPoint	Point in the chamber that's invariant in the b-line model
thickness	Thickness of the two multilayers

Definition at line 320 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                            {
   
   using Parameter = BLinePar::Parameter;
   Amg::Vector3D deformedPos{localTubeEndPoint};
   // MDT deformations like tube bow: bz,bp,bn bend the tube while the wire endpoints are not affected
   //                                 => the wire keeps it's nominal straight line trajectory but it is not concentric to the tube
   //                                 ==> in this function bz, bp and bn are ignored or set to 0
   // MDT deformations that extend/contract the wire longitudinally (while keeping it straight):
   //                                 delta_s from eg and tr are irrelevant for the tube geometry
   //                                 and for the wire trajectory => set to 0 here
   //                                 (should be applied as a correction to the
   //                                 tube lenght => tube surface bounds
   //                                 =++>>>> effect in tracking just through the gravitational sagging TOTALLY NEGLIGIBLE=> ignore)
   // pg is irrelevant for tracking purposes and (at least for the endcaps) is applies to the internal bars only, not to the tubes !!!
   //                                 =++>>>> IGNORE IT
   // ep,en: bend the tube by moving (differently) the endplugs ===> the wire straight trajectory is moved w.r.t. the nominal one
   //                                 in addition the tubes keep their nominal position at the center => the wire is not concentric to
   //                                 the tube delta_s from ep,en must also be considered for the implementation of the realistic tube
   //                                 trajectory induced by ep,en
   // tw,sp,sn,pg (for deltaT and deltaZ) are geometrical effects, that impact on tracking and keep the wire straight.
   const double chamberHeight = std::max(moduleHeight(), m_reOtherMl->moduleHeight());
      
 
   // NOTE s0,z0,t0 are the coord. in the amdb frame of this point: the origin of the frame can be different than the fixed point for
   // deformations s0mdt,z0mdt,t0mdt
   //    (always equal to the point at lowest t,z and s=0 of the MDT stack)
   ATH_MSG_VERBOSE( "** In "<<__func__<<" - moduleWidthS " << moduleWidthS()<<", moduleWidthL: "
                       <<moduleWidthL() <<", height: "<<chamberHeight<<", thickness: " <<chamberThickness << "." );
   ATH_MSG_VERBOSE( "** In "<<__func__<<" - going to correct for B-line the position of Point at " << Amg::toString(localTubeEndPoint));
 
   double s0mdt = localTubeEndPoint.x();  // always I think !
   if (std::abs(fixedPoint.x()) > 0.01) {
      s0mdt = localTubeEndPoint.x() - fixedPoint.x();
   }
   double z0mdt = localTubeEndPoint.y();  
   // unless in the D section of this station there's a dy diff. from 0 for the innermost MDT multilayer (sometimes
   // in the barrel)
   // unless in the D section of this station there's a dz diff. from 0 for the innermost MDT multilayer (often in barrel)
   if (std::abs(fixedPoint.y()) > 0.01) {
      z0mdt = localTubeEndPoint.y() - fixedPoint.y();
   }
   double t0mdt = localTubeEndPoint.z();  
   if (std::abs(fixedPoint.z()) > 0.01) {
      t0mdt = localTubeEndPoint.z() - fixedPoint.z();
   }
   if (z0mdt < 0 || t0mdt < 0) {
      ATH_MSG_WARNING(""<<__func__<<": correcting the local position of a point outside the mdt station (2 multilayers) volume -- RE "
                  << idHelperSvc()->toStringDetEl(identify()) << " local point: szt=" <<Amg::toString(localTubeEndPoint)
                  << " fixedPoint " <<Amg::toString(fixedPoint)<<", z0mdt: "<<z0mdt<<", t0mdt"<<t0mdt);
   }
   ATH_MSG_VERBOSE( "** In "<<__func__<<" - correct for offset of B-line fixed point " << s0mdt << " " << z0mdt << " " << t0mdt);
 
   constexpr double amdbMargin  = 1.*Gaudi::Units::cm;
   const double width_actual = moduleWidthS() - amdbMargin + (moduleWidthL() - moduleWidthS()) * (z0mdt / chamberHeight);
   const double s_rel = s0mdt / (width_actual / 2.);
   const double z_rel = (z0mdt - chamberHeight / 2.) / (chamberHeight / 2.);
   const double t_rel = (t0mdt - chamberThickness / 2.) / (chamberThickness / 2.);
 
   ATH_MSG_VERBOSE( "** In "<<__func__<<" - width_actual: "<<width_actual<<", s_rel: "<<s_rel<<", z_rel: "<<z_rel
                  <<", t_rel:" << t_rel );
   double ds{0.},dz{0.},dt{0.};
   
   // sp, sn - cross plate sag out of plane
   if ( bline.getParameter(Parameter::sp) || bline.getParameter(Parameter::sn)) {
      double ztmp = z_rel * z_rel - 1;
      dt += 0.5 * (bline.getParameter(Parameter::sp) + bline.getParameter(Parameter::sn)) * ztmp 
         +  0.5 * (bline.getParameter(Parameter::sp) - bline.getParameter(Parameter::sn)) * ztmp * s_rel;
   }
 
   // tw     - twist
   if (bline.getParameter(Parameter::tw)) {
      dt -= bline.getParameter(Parameter::tw) * s_rel * z_rel;
      dz += bline.getParameter(Parameter::tw) * s_rel * t_rel * chamberThickness / chamberHeight;
      ATH_MSG_VERBOSE( "** In "<<__func__<<": tw=" << bline.getParameter(Parameter::tw) << " dt: "<<dt<<", dz: "<< dz );
   }
 
   constexpr double expansionScale = BLinePar::expansionScale;
     // eg     - global expansion
   if (bline.getParameter(Parameter::eg)) {
      double egppm = bline.getParameter(Parameter::eg) * expansionScale;
      ds += 0.;
      dz += z0mdt * egppm;
      dt += t0mdt * egppm;
   }
 
   // ep, en - local expansion
   //
   // Imporant note: the chamber height and length, as they denoted in Christoph's talk,
   // correspond to thickness and height parameters of this function;
   //
 
   if (bline.getParameter(Parameter::ep) || bline.getParameter(Parameter::en)) {
      const double ep = bline.getParameter(Parameter::ep) * expansionScale;
      const double en = bline.getParameter(Parameter::en) * expansionScale;
      const double phi = 0.5 * (ep + en) * s_rel * s_rel + 0.5 * (ep - en) * s_rel;
      const double localDt = phi * (t0mdt - chamberThickness / 2.);
      const double localDz = phi * (z0mdt - chamberHeight / 2.);
      dt += localDt;
      dz += localDz;
   }
 
   ATH_MSG_VERBOSE( "posOnDefChamStraighWire: ds="<<ds<<",z="<<dz<<",t="<<dt);
   deformedPos[0] = localTubeEndPoint[0] + ds;
   deformedPos[1] = localTubeEndPoint[1] + dz;
   deformedPos[2] = localTubeEndPoint[2] + dt;
   return deformedPos;
}

asBuiltRefFrame()

Amg::Transform3D MuonGMR4::MdtReadoutElement::asBuiltRefFrame

(

)

const

Returns the transformation to go into the reference frame of the as-buit & b-line model starting from the readout element frame.

Definition at line 219 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                        {
      return alignableTransform()->getDefTransform().inverse()*
             getMaterialGeom()->getParent()->getX() *
             getMaterialGeom()->getX();
}

bLineReferencePoint()

Amg::Vector3D MuonGMR4::MdtReadoutElement::bLineReferencePoint

(

)

const

Returns the fixed point of the B-line & as-bult defromation model expressed in the as-built frame.

Definition at line 233 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                         {
   /* The fix point is the point that's closest to the interaction point. 
   /  Recall that the readout element origin is expressed in the geometric centre & 
      the x-axis points upwards. The point is then transformed into the Muon station frame */ 
   const MdtReadoutElement* refEle{multilayer() == 1 ? this : m_reOtherMl};
   return refEle->asBuiltRefFrame()*(-0.5*( refEle->moduleThickness() *Amg::Vector3D::UnitX() + 
                                            (stationEta() >0 || !isBarrel() ? 1. : -1.)*refEle->moduleHeight() * Amg::Vector3D::UnitZ()));
}

center() [1/3]

Amg::Vector3D MuonGMR4::MuonReadoutElement::center ( const ActsTrk::GeometryContext & ctx ) const

inherited

Returns the geometrical center point of the readout element.

Parameters

ctx	Geometry context to take the alignment corrections into account

center() [2/3]

Amg::Vector3D MuonGMR4::MuonReadoutElement::center ( const ActsTrk::GeometryContext & ctx, const Identifier & id ) const

inherited

Returns the origin of the readout element's transform.

Parameters

ctx	Geometry context to take the alignment corrections into account
id	Identifier of the measurement channel to be retrieved

center() [3/3]

Amg::Vector3D MuonGMR4::MuonReadoutElement::center ( const ActsTrk::GeometryContext & ctx, const IdentifierHash & hash ) const

inherited

Returns the origin of the readout element's transform.

Parameters

ctx	Geometry context to take the alignment corrections into account
hash	Measurement hash of the transform to be retrieved

chamber()

const Chamber * MuonGMR4::MuonReadoutElement::chamber ( ) const

inherited

Returns the pointer to the chamber enclosing this readout element.

chamberDesign()

const std::string & MuonGMR4::MuonReadoutElement::chamberDesign ( ) const

inherited

The chamber design refers to the construction parameters of a readout element.

It's used for the retrieval of the chamber meta data containing the information about the number of sensors, their sepration etc.

chamberIndex()

Muon::MuonStationIndex::ChIndex MuonGMR4::MuonReadoutElement::chamberIndex ( ) const

inherited

Returns the chamber index of the Identifier (MMS & STS) have the same chamber Index (EIS)

complementaryRE()

const MdtReadoutElement * MuonGMR4::MdtReadoutElement::complementaryRE

(

)

const

Returns the pointer to the other readout element inside the muon station.

createGeoTransform()

StatusCode MuonGMR4::MuonReadoutElement::createGeoTransform ( )

protectedinherited

Creates the TransformCacheDetEle corresponding the generic local -> global transformation of the readout element.

Needs to be called by each technology during initialization

Check that the alignable node has been assigned

Definition at line 32 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                  {
    if(!alignableTransform()) {
       ATH_MSG_FATAL("The readout element "<<idHelperSvc()->toStringDetEl(identify())<<" has no assigned alignable node");
       return StatusCode::FAILURE;
    }
    m_centralTrfCache = std::make_unique<TransformCacheDetEle<MuonReadoutElement>>(geoTransformHash(), this);
    return StatusCode::SUCCESS;
}

detectorType()

ActsTrk::DetectorType MuonGMR4::MdtReadoutElement::detectorType ( ) const

inlinefinaloverridevirtual

Overload the detector type.

Implements ActsTrk::IDetectorElementBase.

Definition at line 89 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

                                                                {
            return ActsTrk::DetectorType::Mdt;
        }

distanceToReadout() [1/3]

double MuonGMR4::MdtReadoutElement::distanceToReadout	(	const ActsTrk::GeometryContext &	ctx,
		const Identifier &	measId,
		const Amg::Vector3D &	globPoint ) const

Returns the distance to the readout card along the wire.

Parameters

ctx	Geometry context carrying the current alignment
measId	Identifier of the tube for which the distance is to be calculated
globPoint	External point in the ATLAS coordinate frame

distanceToReadout() [2/3]

double MuonGMR4::MdtReadoutElement::distanceToReadout	(	const ActsTrk::GeometryContext &	ctx,
		const IdentifierHash &	measHash,
		const Amg::Vector3D &	globPoint ) const

Returns the distance to the readout card along the wire.

Parameters

ctx	Geometry context carrying the current alignment
measHash	Measurement hash of the tube for which the distance is to be calculated
globPoint	External point in the ATLAS coordinate frame

Definition at line 191 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                {
    return distanceToReadout(measHash, globalToLocalTransform(ctx, measHash) * globPoint);
 
}

distanceToReadout() [3/3]

double MuonGMR4::MdtReadoutElement::distanceToReadout	(	const IdentifierHash &	measHash,
		const Amg::Vector3D &	localPoint ) const

Returns the distance to the readout assuming that the parsed point is expressed in the local coordinate system of the tube.

I.e. the wire points along the z-axis

Parameters

measHash	IdentifierHash of the tube
localPoint	External local point inside the tube (No check is made whether that's the case).

The position of the readout chip is at the negative tube side

Definition at line 197 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                 {
    const unsigned int layer = layerNumber(measHash);
    const unsigned int tube = tubeNumber(measHash);
    const MdtTubeLayer& zeroT{*m_pars.tubeLayers[layer]};
    const double readOutPos = m_pars.readoutSide * zeroT.tubeHalfLength(tube);
    return std::abs(readOutPos - localPoint.z());
}

fromIdealToDeformed()

Amg::Transform3D MuonGMR4::MdtReadoutElement::fromIdealToDeformed ( const IdentifierHash & tubeHash, const ActsTrk::DetectorAlignStore * store ) const

private

Applies the B & as-built parameters.

No deformation parameters were parsed at all

No deformation parameters were stored for this particular readout element

Relative sign to calculate the thickness. If multilayer == 1, we want the lower point and the upper point otherwise.

Move the tube into the center

Apply as-built correction

Switch tube ends back to MGM coordinates

Definition at line 440 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                                      {
#ifdef SIMULATIONBASE
   ATH_MSG_VERBOSE("No deformed transformation available "<<idHelperSvc()->toString(measurementId(tubeHash))
                  <<"store address to make the compiler happy: "<<store);
   return Amg::Transform3D::Identity();
#else
   if (!store || !store->internalAlignment) {
      ATH_MSG_VERBOSE("No deformed transformation available "<<idHelperSvc()->toString(measurementId(tubeHash)));
      return Amg::Transform3D::Identity();
   }
   using ChamberDistortions = MdtAlignmentStore::chamberDistortions;

   const ChamberDistortions distortPars = static_cast<const MdtAlignmentStore&>(*store->internalAlignment).getDistortion(identify());
   if (!distortPars) {
      ATH_MSG_VERBOSE("No set of deformation parameters is in the DB for "<<idHelperSvc()->toString(measurementId(tubeHash)));
      return Amg::Transform3D::Identity();
   }
 
   const Amg::Vector3D fixedPoint{bLineReferencePoint()};
   
   
   const double height = std::max(moduleHeight(), m_reOtherMl->moduleHeight()) - 
                         (tubePitch() - 2. * tubeRadius());
 
   const Amg::Transform3D toAMDB{asBuiltRefFrame()};
   const double relSign = (multilayer() == 1 ? -1. : 1.);
   
   const double modHalfThick{0.5*relSign*moduleThickness()}, 
                modHalTHickO{-0.5*relSign*m_reOtherMl->moduleThickness()};
 
   const double thickness = relSign*( (toAMDB* (modHalfThick*Amg::Vector3D::UnitX())) -
                                      (m_reOtherMl->asBuiltRefFrame()*(modHalTHickO* Amg::Vector3D::UnitX()))).z();
 
   
   Amg::Vector3D idealTube = localTubePos(tubeHash);
   idealTube[Amg::y] = 0.;
 
   Amg::Vector3D positiveEnd = toAMDB * (idealTube + 0.5 * uncutTubeLength(tubeHash) * Amg::Vector3D::UnitY());
   Amg::Vector3D negativeEnd = toAMDB * (idealTube - 0.5 * uncutTubeLength(tubeHash) * Amg::Vector3D::UnitY());
   if (distortPars.asBuilt) {
      positiveEnd = wireEndpointAsBuilt(*distortPars.asBuilt, tubeHash, positiveEnd, tubeSide_t::POS);
      negativeEnd = wireEndpointAsBuilt(*distortPars.asBuilt, tubeHash, negativeEnd, tubeSide_t::NEG);
   }
   Amg::Vector3D positiveEndBline{positiveEnd};
   Amg::Vector3D negativeEndBline{negativeEnd};
   if (distortPars.bLine) {
      positiveEndBline = applyBlineCorrections(*distortPars.bLine, positiveEndBline, fixedPoint, thickness);
      negativeEndBline = applyBlineCorrections(*distortPars.bLine, negativeEndBline, fixedPoint, thickness); 
   }
 
   ATH_MSG_VERBOSE("Calculate the deformation parameters of "<<idHelperSvc()->toString(measurementId(tubeHash))
                <<", ideal tube "<<Amg::toString(idealTube)
                <<", fixed point "<<Amg::toString(fixedPoint)
                <<"/ "<<Amg::toString(alignableTransform()->getDefTransform() * fixedPoint)
                <<", thickness: "<<thickness<<", height: "<<height);
 
   const Amg::Transform3D fromAMDB{toAMDB.inverse()};
   positiveEnd = fromAMDB * positiveEnd;
   negativeEnd = fromAMDB * negativeEnd;
   positiveEndBline = fromAMDB * positiveEndBline;
   negativeEndBline = fromAMDB * negativeEndBline;
 
   // Calculate deformation. Make sure that the wire length stays the same.
   // Code in positionOnDeformedChamber does not provide this by default.
   // Break transformation into translation of the wire center and the rotation of the wire
   // Move to the coordinate system originated at the wire center, then rotate the wire, then
   // move wire center to the new position
   const Amg::Transform3D to_center{Amg::getTranslate3D(-idealTube)};
   const Amg::Transform3D from_center{Amg::getTranslate3D( 0.5 * (positiveEndBline + negativeEndBline))};
   const Amg::Vector3D old_direction = (positiveEnd - negativeEnd).unit();
   const Amg::Vector3D new_direction = (positiveEndBline - negativeEndBline).unit();
   const Amg::Vector3D rotation_vector = old_direction.cross(new_direction);
 
  Amg::Transform3D deformedTransform{Amg::Transform3D::Identity()};
   if (rotation_vector.mag() > 10. * std::numeric_limits<double>::epsilon()) {
      const Amg::AngleAxis3D wire_rotation(std::asin(rotation_vector.mag()), rotation_vector.unit());
      deformedTransform = from_center * wire_rotation * to_center;
   } else {
      deformedTransform = from_center * to_center;
   }
   ATH_MSG_VERBOSE("To center "<<GeoTrf::toString(to_center)<<" from: "<<GeoTrf::toString(from_center)<<
            " -- direction: "<<GeoTrf::toString(old_direction)<<" vs. "<<GeoTrf::toString(new_direction)
            <<" --> rot: "<<GeoTrf::toString(rotation_vector)<<" ==> "<<GeoTrf::toString(deformedTransform,true));
   return deformedTransform;
#endif
}

geoTransformHash()

IdentifierHash MuonGMR4::MuonReadoutElement::geoTransformHash ( )

staticprotectedinherited

Returns the hash that is associated with the surface cache holding the transformation that is placing the ReadoutElement inside the ATLAS coordinate system.

Definition at line 41 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                    {     
    static const IdentifierHash hash{static_cast<unsigned>(~0)-1};
    return hash;
}

getParameters()

const MdtReadoutElement::parameterBook & MuonGMR4::MdtReadoutElement::getParameters

(

)

const

Get a const reference to the parameter book.

Definition at line 45 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

{return m_pars;}

getSurfaces()

std::vector< std::shared_ptr< Acts::Surface > > MuonGMR4::MuonReadoutElement::getSurfaces ( ) const

inherited

Returns all surfaces that are associated with the active readout planes.

Definition at line 146 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                            {
    std::vector<std::shared_ptr<Acts::Surface>> surfaces{};
    surfaces.reserve(m_surfaces.size());
    for (const std::unique_ptr<SurfaceCache>& cache : m_surfaces) {
        if (cache->hash() != geoTransformHash()) {
            surfaces.push_back(cache->getSurface());
            ATH_MSG_VERBOSE("Add surface "<<idHelperSvc()->toString(cache->identify())
                           <<std::endl<<(surfaces.back()->bounds()));
        }
    }
    return surfaces;
}

globalToLocalTransform() [1/3]

Amg::Transform3D MuonGMR4::MuonReadoutElement::globalToLocalTransform ( const ActsTrk::GeometryContext & ctx ) const

inherited

Returns the transformation from the global ATLAS coordinate system into the local coordinate system of the readout element.

The local axes are oriented such that x-axis: Is parallel to the sensors measuring the eta coordinate (e.g. parallel to the Mdt tube wire) y-axis: Is parallel to the sensors measuring the phi coordinate (e.g. to the next tube wire) z-axis: Points vertically outwards the chamber (e.g. radially outwards for barrel or to the endcap cavern wall)

Parameters

ctx	Geometry context to take the alignment corrections into account

Definition at line 71 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                          {
    return globalToLocalTransform(ctx, geoTransformHash());
}

globalToLocalTransform() [2/3]

Amg::Transform3D MuonGMR4::MuonReadoutElement::globalToLocalTransform ( const ActsTrk::GeometryContext & ctx, const Identifier & id ) const

inherited

Returns the transformations from the ATLAS coordinate system into the local coordinate system of the readout sensor.

The orientiation of the axes depends on whether the sensor is described by a plane or by a tube wire. In the former case, the axes are oriented such that x-axis: Points to the next eta sensor such that local-x always constrains the precision coordinate y-axis: Points to the next phi sensor such that local y always constains the coordinate along the precision sensor z-axis: Is the cross-product of the other two For Mdt tubes the axis orientiation is such that x-axis: Points to the next tube in the same tube-layer y-axis: Points to the next tube-layer plane z-axis: Points along the tube wire

Parameters

ctx	Geometry context to take the alignment corrections into account
id	Identifier of the measurement for which the transform shall be retrieved

globalToLocalTransform() [3/3]

Amg::Transform3D MuonGMR4::MuonReadoutElement::globalToLocalTransform ( const ActsTrk::GeometryContext & ctx, const IdentifierHash & hash ) const

inherited

Returns the transformations from the ATLAS coordinate system into the local coordinate system using the measurement / layer hash mechanism.

For strip-like detectors a layer hash must always be parsed. For the Mdts a measurement or layer hash can be parsed depending on whether the plane transform or the particular tube transform shall be retrieved.

Parameters

ctx	Geometry context to take the alignment corrections into account.
hash	Hash of the transform to fetch (Measurement or layer hash).

globalTubePos() [1/2]

Amg::Vector3D MuonGMR4::MdtReadoutElement::globalTubePos	(	const ActsTrk::GeometryContext &	ctx,
		const Identifier &	measId ) const

Returns the position of the tube mid point in the ATLAS coordinate frame.

Parameters

ctx	Geometry context carrying the current alignment
measId	Identifier of the tube for which the position is to be retrieved

globalTubePos() [2/2]

Amg::Vector3D MuonGMR4::MdtReadoutElement::globalTubePos	(	const ActsTrk::GeometryContext &	ctx,
		const IdentifierHash &	hash ) const

Returns the position of the tube mid point in the ATLAS coordinate frame.

Parameters

ctx	Geometry context carrying the current alignment
hash	Measurement hash of the tube for which the position is to be retrieved

Definition at line 144 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                 {
   return localToGlobalTransform(ctx, hash).translation();
}

highVoltPos() [1/2]

Amg::Vector3D MuonGMR4::MdtReadoutElement::highVoltPos	(	const ActsTrk::GeometryContext &	ctx,
		const Identifier &	measId ) const

Returns the endpoint of the tube connected to the high voltage in the ATLAS coordinate frame.

Parameters

ctx	Geometry context carrying the current alignment
measId	Identifier of the tube for which the position is to be retrieved

highVoltPos() [2/2]

Amg::Vector3D MuonGMR4::MdtReadoutElement::highVoltPos	(	const ActsTrk::GeometryContext &	ctx,
		const IdentifierHash &	hash ) const

Returns the endpoint of the tube connected to the high voltage in the ATLAS coordinate frame.

Parameters

ctx	Geometry context carrying the current alignment
hash	Measurement hash of the tube for which the position is to be retrieved

Definition at line 157 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                               {
   return localToGlobalTransform(ctx, hash) * 
          (-0.5*activeTubeLength(hash) * m_pars.readoutSide * Amg::Vector3D::UnitZ());
}

identHash()

IdentifierHash MuonGMR4::MuonReadoutElement::identHash ( ) const

inherited

Returns the hash of the readout element which is identical to the detector element hash provided by the associated idHelper.

identify()

Identifier MuonGMR4::MuonReadoutElement::identify ( ) const

finaloverridevirtualinherited

Return the ATLAS identifier.

Implements ActsTrk::IDetectorElementBase.

idHelperSvc()

const Muon::IMuonIdHelperSvc * MuonGMR4::MuonReadoutElement::idHelperSvc ( ) const

inherited

Returns the pointer to the muonIdHelperSvc.

initElement()

StatusCode MuonGMR4::MdtReadoutElement::initElement ( )

finaloverridevirtual

Overload from MuonReadoutElement.

First check whether we're having tubes

Create bounds that are representing the surface planes of each tube layer & the readout element itself

Coordinate system of the trapezoid is in the center while the tubes are defined w.r.t. to the chamber edge. Move first tube into the proper position

Cache the transformations to the chamber layers

Cache the transformations to the tube layers

Ensure that all linear transformations are rotations

Ensure that all tubes have the same pitch

Implements MuonGMR4::MuonReadoutElement.

Definition at line 51 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                          {
  ATH_CHECK(createGeoTransform());
  if (!numLayers() || !numTubesInLay()) {
     ATH_MSG_FATAL("The readout element "<< idHelperSvc()->toStringDetEl(identify())<<" has no tubes. Please check "<<std::endl<<m_pars);
     return StatusCode::FAILURE;
  }
  if (m_pars.tubePitch<=tubeRadius()) {
     ATH_MSG_FATAL("The tubes of "<<idHelperSvc()->toStringDetEl(identify())<<" will fall together on a single point. Please check "<<std::endl<<m_pars);
     return StatusCode::FAILURE;
  }
#ifndef SIMULATIONBASE
  ATH_CHECK(planeSurfaceFactory(geoTransformHash(), m_pars.boundFactory->makeBounds<Acts::TrapezoidBounds>(m_pars.shortHalfX, 
                                                                                                           m_pars.longHalfX, 
                                                                                                           m_pars.halfY)));
#endif
 
  std::optional<Amg::Vector3D> prevLayPos{std::nullopt};
 
  for (unsigned int lay =1 ; lay <= numLayers() ; ++lay) {
     const IdentifierHash layHash = measurementHash(lay,0);
     ATH_CHECK(insertTransform<MdtReadoutElement>(layHash));
#ifdef SIMULATIONBASE_REMOVEPLANESURFACE
     ATH_CHECK(planeSurfaceFactory(layHash, m_pars.boundFactory->makeBounds<Acts::TrapezoidBounds>(m_pars.shortHalfX, 
                                                                                                   m_pars.longHalfX, 
                                                                                                   m_pars.halfY)));
#endif
    std::optional<Amg::Vector3D> prevTubePos{std::nullopt};
    MdtTubeLayer& layer = *m_pars.tubeLayers[lay-1];
 
    for (unsigned int tube = 1; tube <= numTubesInLay(); ++ tube) {
      const IdentifierHash idHash = measurementHash(lay,tube);
      if (m_pars.removedTubes.count(idHash)) {
         prevTubePos = std::nullopt;
         continue;
      }
      ATH_CHECK(insertTransform<MdtReadoutElement>(idHash));
#ifndef SIMULATIONBASE
      ATH_CHECK(strawSurfaceFactory(idHash, m_pars.boundFactory->
                              makeBounds<Acts::LineBounds>(tubeRadius(), 
                                                           0.5*tubeLength(idHash))));
#endif
      GeoTrf::Transform3D tubeFrame = layer.tubeTransform(tubeNumber(idHash));
      const AmgSymMatrix(3) tubeRot = tubeFrame.linear();
      if (std::abs(tubeRot.determinant()- 1.) > std::numeric_limits<float>::epsilon()){
         ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" Transformation matrix is not a pure rotation for "<<
                       idHelperSvc()->toStringDetEl(identify())<<" in layer: "<<lay<<", tube: "<<tube
                       <<Amg::toString(tubeFrame));
         return StatusCode::FAILURE;
      }
      const Amg::Vector3D tubePos = tubeFrame.translation();
      
      constexpr double pitchTolerance = 20. * Gaudi::Units::micrometer;
      if (prevTubePos) {
         const double dR = std::abs((tubePos - (*prevTubePos)).z());
         if (std::abs(dR - tubePitch()) > pitchTolerance) {
            ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" Detected irregular tube in "<<
                          idHelperSvc()->toStringDetEl(identify())<<" in layer: "<<lay<<", tube: "<<tube
                          <<". Expected tube pitch: "<<tubePitch()<<" measured tube pitch: "
                          <<dR<<" tube position: "<<Amg::toString(tubePos,2)
                          <<" previous: "<<Amg::toString((*prevTubePos), 2));
            return StatusCode::FAILURE;
         }
      }  
      if (prevLayPos && tube == 1) {
         const double dR = (tubePos - (*prevLayPos)).mag();       
         if (std::abs(dR - tubePitch()) > pitchTolerance) {
            ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" Detected irregular layer pitch in "<<
                          idHelperSvc()->toStringDetEl(identify())<<" for layer "<<lay
                          <<". Expected tube pitch: "<<tubePitch()<<" measured tube pitch: "
                          <<dR<<" tube position: "<<Amg::toString(tubePos,2)
                          <<" previous:"<<Amg::toString((*prevLayPos), 2));
         }
      }
      if (tube == 1) {
         prevLayPos = std::make_optional<Amg::Vector3D>(tubePos);
      }
      prevTubePos = std::make_optional<Amg::Vector3D>(tubePos);
    }
  }
#ifndef SIMULATIONBASE
  m_pars.boundFactory.reset();
#endif
  return StatusCode::SUCCESS;
}

initMessaging()

void AthMessaging::initMessaging ( ) const

privateinherited

Initialize our message level and MessageSvc.

This method should only be called once.

Definition at line 39 of file AthMessaging.cxx.

{
  m_imsg = Athena::getMessageSvc();
  // If user did not set an explicit level, set a default
  if (m_lvl == MSG::NIL) {
    m_lvl = m_imsg ?
      static_cast<MSG::Level>( m_imsg.load()->outputLevel(m_nm) ) :
      MSG::INFO;
  }
}

innerTubeRadius()

double MuonGMR4::MdtReadoutElement::innerTubeRadius

(

)

const

Returns the inner tube radius.

insertTransform()

template<class MuonDetImpl>

StatusCode MuonGMR4::MuonReadoutElement::insertTransform ( const IdentifierHash & hash )

protectedinherited

Constructs the TransformDetEleCache associated with the hash of the given Mdt tube or strip layer.

The method is templated over the specific implementation of the readout element as the TransformCacheDetEle implements the assembly of the final transforms. The method returns a failure of an instance for the same hash has already been invoked earlier

Parameters

hash	Measurement / layer hash to identifier the transform of the readout layer

isBarrel()

bool MuonGMR4::MdtReadoutElement::isBarrel

(

)

const

States whether the chamber is built into the barrel or not.

isSensitive()

virtual bool MuonGMR4::MuonReadoutElement::isSensitive ( ) const

inlinefinaloverridevirtualinherited

Returns whether the detector element is sensitive.

Definition at line 206 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{ return true; }

isValid()

bool MuonGMR4::MdtReadoutElement::isValid

(

const IdentifierHash &

measHash

)

const

Checks whether the passed meaurement hash corresponds to a valid tube described by the readout element.

Parameters

measHash

Associated measurement hash encoding tube & layer number

layerHash() [1/2]

IdentifierHash MuonGMR4::MdtReadoutElement::layerHash ( const Identifier & measId ) const

finaloverridevirtual

Projects the measurement hash onto the layerHash mainly used to access the plane surface in the center of each tube layer.

Parameters

measId

Identifier of an associated Mdt measurement

Implements MuonGMR4::MuonReadoutElement.

layerHash() [2/2]

IdentifierHash MuonGMR4::MdtReadoutElement::layerHash ( const IdentifierHash & measHash )

static

Static method to tranform a measurement hash into a layer hash.

Parameters

measHash

Measurement corresponding to this readout element

layerNumber()

unsigned MuonGMR4::MdtReadoutElement::layerNumber ( const IdentifierHash & hash )

static

Transforms the measurement hash into a tube-layer number ranging from [0; numLayers() -1].

Parameters

hash	Measurement hash to transform

localToGlobalTransform() [1/4]

const Acts::Transform3 & MuonGMR4::MuonReadoutElement::localToGlobalTransform ( const Acts::GeometryContext & gctx ) const

finaloverrideinherited

Wrapper function of the localToGlobalTransform method to satisfy the Acts::IDetectorElementBase interface.

Parameters

gctx	Acts representation of the GeometryContext

Definition at line 78 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                                         {
    const GeometryContext *gctx = anygctx.get<const GeometryContext *>();
    return localToGlobalTransform(*gctx, geoTransformHash());
}

localToGlobalTransform() [2/4]

const Amg::Transform3D & MuonGMR4::MuonReadoutElement::localToGlobalTransform ( const ActsTrk::GeometryContext & ctx ) const

inherited

Returns the transformation from the local coordinate system of the readout element into the global ATLAS coordinate system (inverse of globalToLocal).

Parameters

ctx	Geometry context to take the alignment corrections into account.

Definition at line 74 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                                 {
    return localToGlobalTransform(ctx, geoTransformHash());
}

localToGlobalTransform() [3/4]

const Amg::Transform3D & MuonGMR4::MuonReadoutElement::localToGlobalTransform ( const ActsTrk::GeometryContext & ctx, const Identifier & id ) const

inherited

Returns the transformation from the local coordinate system of the readout element into the global ATLAS coordinate system (inverse of globalToLocal).

Parameters

ctx	Geometry context to take the alignment corrections into account
id	Identifier of the measurement for which the transform shall be retrieved

localToGlobalTransform() [4/4]

const Amg::Transform3D & MuonGMR4::MuonReadoutElement::localToGlobalTransform ( const ActsTrk::GeometryContext & ctx, const IdentifierHash & id ) const

inherited

Returns the transformation from the local coordinate system of the readout element into the global ATLAS coordinate system (inverse of globalToLocal).

Parameters

ctx	Geometry context to take the alignment corrections into account
hash	Hash of the transform to fetch (Measurement or layer hash).

localTubePos()

Amg::Vector3D MuonGMR4::MdtReadoutElement::localTubePos

(

const IdentifierHash &

hash

)

const

Returns the tube position in the chamber coordinate frame (Not applying the B-line corrections)

Definition at line 149 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                            {
  return toTubeFrame(hash).translation();
}

measurementHash() [1/2]

IdentifierHash MuonGMR4::MdtReadoutElement::measurementHash ( const Identifier & measId ) const

finaloverridevirtual

Constructs the measurement hash from the full measurement Identifier.

The hash is always defined w.r.t the specific detector element and used to access the information in memory quickly

Parameters

measId

Identifier of an associated Mdt measurement

Implements MuonGMR4::MuonReadoutElement.

measurementHash() [2/2]

IdentifierHash MuonGMR4::MdtReadoutElement::measurementHash ( unsigned layerNumber, unsigned tubeNumber )

static

Constructs a Measurement hash from layer && tube number.

Parameters

layerNumber	Number of the tube layer [1;numLayers()]
tubenumber	Number of the tube inside the layer [1;numTubesInLay()]

measurementId()

Identifier MuonGMR4::MdtReadoutElement::measurementId ( const IdentifierHash & measHash ) const

finaloverridevirtual

Back conversion of the measurement hash towards a full identifier Tube & layer number are extracted from the hash and combined with the mising Identifier fields from the readout element.

Parameters

measHash

Measurement hash to transform

Implements MuonGMR4::MuonReadoutElement.

Definition at line 46 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                {
    return m_idHelper.channelID(identify(), multilayer(),
                                layerNumber(measHash) + 1,
                                tubeNumber(measHash) + 1);
}

moduleHeight()

double MuonGMR4::MdtReadoutElement::moduleHeight

(

)

const

Returns the height of the chamber (Distance bottom - topWidth)

moduleThickness()

double MuonGMR4::MdtReadoutElement::moduleThickness

(

)

const

Returns the thickness of the chamber.

moduleWidthL()

double MuonGMR4::MdtReadoutElement::moduleWidthL

(

)

const

Returns the length of the top edge of the chamber (top width)

moduleWidthS()

double MuonGMR4::MdtReadoutElement::moduleWidthS

(

)

const

Returns the length of the bottom edge of the chamber (short width)

msg() [1/2]

MsgStream & AthMessaging::msg ( ) const

inlineinherited

The standard message stream.

Returns a reference to the default message stream May not be invoked before sysInitialize() has been invoked.

Definition at line 167 of file AthMessaging.h.

{
  MsgStream* ms = m_msg_tls.get();
  if (!ms) {
    if (!m_initialized.test_and_set()) initMessaging();
    ms = new MsgStream(m_imsg,m_nm);
    m_msg_tls.reset( ms );
  }
 
  ms->setLevel (m_lvl);
  return *ms;
}

msg() [2/2]

MsgStream & AthMessaging::msg ( const MSG::Level lvl ) const

inlineinherited

The standard message stream.

Returns a reference to the default message stream May not be invoked before sysInitialize() has been invoked.

Definition at line 182 of file AthMessaging.h.

{ return msg() << lvl; }

msgLvl()

bool AthMessaging::msgLvl ( const MSG::Level lvl ) const

inlineinherited

Test the output level.

Parameters

lvl	The message level to test against

Returns

boolean Indicating if messages at given level will be printed

Return values

true	Messages at level "lvl" will be printed

Definition at line 151 of file AthMessaging.h.

{
  // If user did not set explicit message level we have to initialize
  // the messaging and retrieve the default via the MessageSvc.
  if (m_lvl==MSG::NIL && !m_initialized.test_and_set()) initMessaging();
 
  if (m_lvl <= lvl) {
    msg() << lvl;
    return true;
  } else {
    return false;
  }
}

msSector()

const SpectrometerSector * MuonGMR4::MuonReadoutElement::msSector ( ) const

inherited

Returns the pointer to the envelope volume enclosing all chambers in the sector.

multilayer()

unsigned MuonGMR4::MdtReadoutElement::multilayer

(

)

const

Returns the multi layer of the readout element [1;\2].

numLayers()

unsigned MuonGMR4::MdtReadoutElement::numLayers

(

)

const

Returns how many tube layers are inside the multi layer [1;4].

numTubesInLay()

unsigned MuonGMR4::MdtReadoutElement::numTubesInLay

(

)

const

Returns the number of tubes in a layer.

planeSurfaceFactory()

StatusCode MuonGMR4::MuonReadoutElement::planeSurfaceFactory ( const IdentifierHash & hash, std::shared_ptr< const Acts::PlanarBounds > pBounds )

protectedinherited

Invokes the factory to create plane surfaces && to associate them with the particular transform cache.

Parameters

hash	Layer hash of the readout plane of interest
lBounds	Bounds describing the rectangle or trapezoidal surface's dimensions

Definition at line 118 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                                 {
 
    //get the local to global transform cache
    const TransformCache* cache = transformCache(hash);
    if (!cache) {
        ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" - "<<idHelperSvc()->toString(identify())
                   <<" no transform cache available for hash "<<hash);
        return StatusCode::FAILURE;
    }
    auto insert_itr = m_surfaces.insert(std::make_unique<SurfaceCache>(cache));
    if(!insert_itr.second){
        ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" - "<<idHelperSvc()->toString(identify())
                   <<" Insertion to muon surface cache failed for hash "<<hash);
        return StatusCode::FAILURE;
    }
    //Create a plane surface for the surface cache
    (*insert_itr.first)->setSurface(Acts::Surface::makeShared<Acts::PlaneSurface>(pBounds, **insert_itr.first));
    return StatusCode::SUCCESS;
}

readOutPos() [1/2]

Amg::Vector3D MuonGMR4::MdtReadoutElement::readOutPos	(	const ActsTrk::GeometryContext &	ctx,
		const Identifier &	measId ) const

Returns the endpoint of the tube where the readout card is mounted in the ATLAS coordinate frame.

Parameters

ctx	Geometry context carrying the current alignment
measId	Identifier of the tube for which the position is to be retrieved

readOutPos() [2/2]

Amg::Vector3D MuonGMR4::MdtReadoutElement::readOutPos	(	const ActsTrk::GeometryContext &	ctx,
		const IdentifierHash &	hash ) const

Returns the endpoint of the tube where the readout card is mounted in the ATLAS coordinate frame.

Parameters

ctx	Geometry context carrying the current alignment
hash	Measurement hash of the tube for which the position is to be retrieved

Definition at line 152 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                              {
   return localToGlobalTransform(ctx, hash) * 
          (0.5*activeTubeLength(hash) * m_pars.readoutSide * Amg::Vector3D::UnitZ());
}

releaseUnAlignedTrfs()

void MuonGMR4::MuonReadoutElement::releaseUnAlignedTrfs ( ) const

inherited

Release all transforms from the memory that are not connected with a geometry context but cached by the readout element itself.

Definition at line 49 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                    {
    for (const auto& cache : m_localToGlobalCaches) {
        if (cache){
            cache->releaseNominalCache();
        }
    }
    m_centralTrfCache->releaseNominalCache();
}

setChamberLink()

void MuonGMR4::MuonReadoutElement::setChamberLink ( const Chamber * chamber )

inherited

Sets the link to the enclosing chamber.

Definition at line 139 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                              {
    m_chambLink = chamber;
}

setComplementaryReadoutEle()

void MuonGMR4::MdtReadoutElement::setComplementaryReadoutEle

(

const MdtReadoutElement *

other

)

Set the link to the second readout element inside the muon station.

Parameters

other

pointer to the readoutElement

Definition at line 207 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                 {
      m_reOtherMl = other;
}

setLevel()

void AthMessaging::setLevel ( MSG::Level lvl )

inherited

Change the current logging level.

Use this rather than msg().setLevel() for proper operation with MT.

Definition at line 28 of file AthMessaging.cxx.

{
  m_lvl = lvl;
}

setSectorLink()

void MuonGMR4::MuonReadoutElement::setSectorLink ( const SpectrometerSector * envelope )

inherited

Set the link to the enclosing sector envelope.

Definition at line 142 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                         {
    m_msSectorLink = envelope;
}

stationEta()

int MuonGMR4::MuonReadoutElement::stationEta ( ) const

inherited

Returns the stationEta (positive A site, negative C site)

stationName()

int MuonGMR4::MuonReadoutElement::stationName ( ) const

inherited

Returns the stationName (BIS, BOS, etc) encoded into the integer.

stationPhi()

int MuonGMR4::MuonReadoutElement::stationPhi ( ) const

inherited

Returns the stationPhi (1-8) -> sector (2*phi - (isSmall))

storeAlignedTransforms()

unsigned MuonGMR4::MuonReadoutElement::storeAlignedTransforms ( const ActsTrk::DetectorAlignStore & store ) const

finaloverridevirtualinherited

Construct the final aligned transformations and store them in the alignment store.

Returns the number of how many transformations have been stored

Implements ActsTrk::IDetectorElement.

Definition at line 58 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                         {
    if (store.detType != detectorType()) return 0;
    unsigned int aligned{1};
    m_centralTrfCache->getTransform(&store);
    for (const auto& cache : m_localToGlobalCaches) {
        if (cache) {
            cache->getTransform(&store);
        }
        ++aligned;
    }
    return aligned;
}

strawSurfaceFactory()

StatusCode MuonGMR4::MuonReadoutElement::strawSurfaceFactory ( const IdentifierHash & hash, std::shared_ptr< const Acts::LineBounds > lBounds )

protectedinherited

Invokes the factory to create straw surfaces && to associate them with the particular transform cache.

Parameters

hash	Measurement hash of the tube of interest
lBounds	Surface bound object describing the straw radius and the active tube length

Definition at line 95 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                                {
 
    //get the local to global transform cache
    const TransformCache* cache = transformCache(hash);
    if (!cache) {
        ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" - "<<idHelperSvc()->toString(identify())
                   <<" no transform cache available for hash "<<hash);
        return StatusCode::FAILURE;
    }
 
    auto insert_itr = m_surfaces.insert(std::make_unique<SurfaceCache>(cache));
    if(!insert_itr.second){
        ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" - "<<idHelperSvc()->toString(identify())
                   <<" Insertion to muon surface cache failed for hash "<<hash);
        return StatusCode::FAILURE;
    }
    //Create straw surface for the surface cache
    (*insert_itr.first)->setSurface(Acts::Surface::makeShared<Acts::StrawSurface>(lBounds, **insert_itr.first));
    return StatusCode::SUCCESS;
 
}

surface() [1/4]

const Acts::Surface & MuonGMR4::MuonReadoutElement::surface ( ) const

finaloverrideinherited

Returns the surface associated with the readout element.

It is placed in the center of the readout element's volume and has the volumes surface bounds

Definition at line 90 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

{ return surface(geoTransformHash()); }

surface() [2/4]

Acts::Surface & MuonGMR4::MuonReadoutElement::surface ( )

finaloverrideinherited

Returns the mutable surface associated with the readout element.

Definition at line 91 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

{ return surface(geoTransformHash()); }

surface() [3/4]

Acts::Surface & MuonGMR4::MuonReadoutElement::surface ( const IdentifierHash & hash )

inherited

Returns the mutable surface associated with the transform of a given readout layer.

(E.g. tube or the strip plane)

Parameters

hash	Hash of the surface to fetch (Measurement or layer hash).

Definition at line 93 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

{ return *surfacePtr(hash); }

surface() [4/4]

const Acts::Surface & MuonGMR4::MuonReadoutElement::surface ( const IdentifierHash & hash ) const

inherited

Returns the surface associated with the transform of a given readout layer.

(E.g. tube or the strip plane)

Parameters

hash	Hash of the surface to fetch (Measurement or layer hash).

Definition at line 92 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

{ return *surfacePtr(hash); }

surfacePtr()

std::shared_ptr< Acts::Surface > MuonGMR4::MuonReadoutElement::surfacePtr ( const IdentifierHash & hash ) const

inherited

Returns the mutable surface pointer associated with the transform of a given readout layer.

(E.g. tube or the strip plane)

Parameters

hash	Hash of the surface to fetch (Measurement or layer hash).

Definition at line 82 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                          {
    SurfaceCacheSet::const_iterator cache = m_surfaces.find(hash);
    if(cache != m_surfaces.end()) return (*cache)->getSurface();
    ATH_MSG_FATAL(__FILE__<<":"<<__LINE__<<" "<<__func__<<"() -- Hash "<<hash
               <<" is unknown to "<<idHelperSvc()->toStringDetEl(identify()));
    return nullptr;
}

thickness()

double MuonGMR4::MdtReadoutElement::thickness ( ) const

finaloverridevirtual

Overload from the Acts::DetectorElement (2 * halfheight)

Implements MuonGMR4::MuonReadoutElement.

toChamberLayer()

Amg::Transform3D MuonGMR4::MdtReadoutElement::toChamberLayer ( const IdentifierHash & hash ) const

private

Returns the transformation into the rest frame of the tube x-axis: Pointing towards the next layer y-axis: Pointing parallel to the wire layer z-axis: Pointing along the wire.

Definition at line 162 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                 {   
   const unsigned int layer = layerNumber(hash);
   const MdtTubeLayer& zeroT{*m_pars.tubeLayers[layer]};
   return zeroT.layerTransform();
}

toStation()

const Amg::Transform3D & MuonGMR4::MuonReadoutElement::toStation ( const ActsTrk::DetectorAlignStore * alignStore ) const

protectedinherited

Returns the transformation from the GeoModel tree and applies the A-lines if a valid alignment store pointer is provided.

The local coordinate system in GeoModel differs from the system used by the localToGlobaTransformations. It is referred to the AMDB coordinate system used to describe the MS in Run 1-3 x-axis: Points along the thickness of the readout element (e.g. radially outwards for barrel chambers or along global Z for detector mounted in the endcaps) y-axis: Points along the edge which is parallel to the eta sensors z-axis: Points along towards the next eta sensor

Definition at line 46 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MuonReadoutElement.cxx.

                                                                                              {
   return getMaterialGeom()->getAbsoluteTransform(alignStore ? alignStore->geoModelAlignment.get() : nullptr);
}

toTubeFrame()

Amg::Transform3D MuonGMR4::MdtReadoutElement::toTubeFrame ( const IdentifierHash & hash ) const

private

Returns the transformation into the rest frame of the tube x-axis: Pointing towards the next layer y-axis: Pointing parallel to the wire layer z-axis: Pointing along the wire.

Definition at line 167 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                              {
   const unsigned int layer = layerNumber(hash);
   const unsigned int tube = tubeNumber(hash);
   const MdtTubeLayer& zeroT{*m_pars.tubeLayers[layer]};
   return zeroT.tubeTransform(tube);  
}

transformCache()

const ActsTrk::TransformCache * MuonGMR4::MuonReadoutElement::transformCache ( const IdentifierHash & measHash ) const

privateinherited

Returns the pointer to the TransformCache associated with this measurement hash.

Parameters

measHash

Measurement hash for which the cache shall be returned

tubeLength()

double MuonGMR4::MdtReadoutElement::tubeLength

(

const IdentifierHash &

hash

)

const

Definition at line 185 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                     {
  return activeTubeLength(hash) + 2.*m_pars.deadLength;
}

tubeNumber()

unsigned MuonGMR4::MdtReadoutElement::tubeNumber ( const IdentifierHash & hash )

static

Transforms the measurement hash into a tube number ranging from [0; numTubeInLay() -1].

Parameters

hash	Measurement hash to transform

tubePitch()

double MuonGMR4::MdtReadoutElement::tubePitch

(

)

const

Returns the pitch between 2 tubes in a layer.

tubeRadius()

double MuonGMR4::MdtReadoutElement::tubeRadius

(

)

const

Adds the thickness of the tube wall onto the radius.

uncutTubeLength()

double MuonGMR4::MdtReadoutElement::uncutTubeLength

(

const IdentifierHash &

tubeHash

)

const

Returns the uncut tube length.

Definition at line 179 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                              {
   const unsigned int layer = layerNumber(tubeHash);
   const unsigned int tube = tubeNumber(tubeHash);
   const MdtTubeLayer& zeroT{*m_pars.tubeLayers[layer]}; 
   return 2.*zeroT.uncutHalfLength(tube);
}

wireEndpointAsBuilt()

Amg::Vector3D MuonGMR4::MdtReadoutElement::wireEndpointAsBuilt ( const MdtAsBuiltPar & asBuilt, const IdentifierHash & tubeHash, const Amg::Vector3D & nominalEnd, const tubeSide_t side ) const

private

Definition at line 250 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                                  {
      
 
   ATH_MSG_VERBOSE( "Applying as-built parameters for chamber " << idHelperSvc()->toString(measurementId(tubeHash)));
 
  
   using tubeSide_t = MdtAsBuiltPar::tubeSide_t;
   using multilayer_t = MdtAsBuiltPar::multilayer_t;
   const multilayer_t ml = (multilayer() == 1) ? multilayer_t::ML1 : multilayer_t::ML2;
 
   const IdentifierHash refLayer{measurementHash((ml == multilayer_t::ML1) ? numLayers() : 1, 1)};
   const Amg::Vector3D refTube{localTubePos(refLayer)};
 
  
   const double sideSign = 0.5*(1.- 2.*(side ==tubeSide_t::NEG));
   // Compute the reference for the as-built parameters
   const Amg::Vector3D reference_point = asBuiltRefFrame() *
                                             Amg::Vector3D {refTube.x() + (1. - 2.*(ml == multilayer_t::ML2)) * tubeRadius(),
                                                            sideSign*uncutTubeLength(refLayer),
                                                            -0.5*moduleHeight()};
   ATH_MSG_VERBOSE("AMDB transform "<<" "<<idHelperSvc()->toStringDetEl(identify())<<
                  " "<<GeoTrf::toString(asBuiltRefFrame(), true)<<", reference point: "<<Amg::toString(reference_point));
 
   
   const int tubeLayer = layerNumber(tubeHash);
   const int tube = tubeNumber(tubeHash);
   const int layer_delta = ml == multilayer_t::ML1 ?  numLayers() - tubeLayer : tubeLayer +1;
 
 
   // Get the As-Built parameters for this ML and side of the chamber
   const double zpitch = params.zpitch(ml, side);
   const double ypitch = params.ypitch(ml, side);
   const double stagg =  params.stagg(ml, side);
   const double alpha = params.alpha(ml, side);
   const double y0 = params.y0(ml, side);
   const double z0 = params.z0(ml, side);
 
   const Amg::Transform3D planeRot{Amg::getRotateX3D(-alpha)};
   ATH_MSG_VERBOSE("Rotation angle "<<(alpha/Gaudi::Units::deg));
 
   // Find the vector from the reference_point to the endplug
   // 0 for layer 1 and 3, 1 for layer 2 and 4
   const double offset_stagg = 0.5 * zpitch * stagg * ( (layer_delta-1)  % 2);
   const Amg::Vector3D endPlug = planeRot * Amg::Vector3D{0., 
                                                            tube* zpitch + offset_stagg, 
                                                            (layer_delta-1) * ypitch};
 
   // Calculate x position, which varies for endcap chambers
   const double xshift = sideSign*(uncutTubeLength(tubeHash) - uncutTubeLength(refLayer));
   ATH_MSG_VERBOSE("Off set staggering "<<offset_stagg<<", layer_delta: "<<layer_delta<<", zpitch: "<<zpitch<<", ypitch: "<<ypitch
                 <<", xshift: "<<xshift);
 
   Amg::Vector3D ret(reference_point.x() + xshift, 
                     reference_point.y() + z0 + endPlug.y(),
                     reference_point.z() + y0 + endPlug.z());
 
   
   if ((ret - wireEnd).mag() > 3. * Gaudi::Units::mm) {
      ATH_MSG_WARNING("Large as-built correction for chamber " << idHelperSvc()->toString(measurementId(tubeHash))
                        << ", side "<< (side == tubeSide_t::POS ? "positive" : "negative") 
                        << ", endpoint "<<Amg::toString(wireEnd)<<", return: "<<Amg::toString(ret));
   }
   ATH_MSG_VERBOSE((side == tubeSide_t::POS ? "positive" : "negative")<<" wire end has moved from "
                   <<Amg::toString(wireEnd)<<" to "<<Amg::toString(ret)<<" End plug: "<<Amg::toString(endPlug));
   return ret;
}

wireLength()

double MuonGMR4::MdtReadoutElement::wireLength

(

const IdentifierHash &

hash

)

const

Definition at line 188 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx.

                                                                     {
   return tubeLength(hash) - 2.*m_pars.endPlugLength;
}

Member Data Documentation

ATLAS_THREAD_SAFE

std::atomic_flag m_initialized AthMessaging::ATLAS_THREAD_SAFE = ATOMIC_FLAG_INIT

mutableprivateinherited

Messaging initialized (initMessaging)

Definition at line 141 of file AthMessaging.h.

m_args

const defineArgs MuonGMR4::MuonReadoutElement::m_args {}

privateinherited

Definition at line 261 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{};

m_centralTrfCache

std::unique_ptr<ActsTrk::TransformCache> MuonGMR4::MuonReadoutElement::m_centralTrfCache {}

privateinherited

Cache of the transform of the readout element itself.

Definition at line 274 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{};

m_chambLink

const Chamber* MuonGMR4::MuonReadoutElement::m_chambLink {nullptr}

privateinherited

Definition at line 284 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{nullptr};

m_chIdx

Muon::MuonStationIndex::ChIndex MuonGMR4::MuonReadoutElement::m_chIdx {Muon::MuonStationIndex::ChIndex::ChUnknown}

privateinherited

Cache the chamber index of the Identifier.

Definition at line 277 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{Muon::MuonStationIndex::ChIndex::ChUnknown};   

m_detElHash

IdentifierHash MuonGMR4::MuonReadoutElement::m_detElHash {}

privateinherited

Cache of the detector element hash.

Definition at line 263 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{};

m_idHelper

const MdtIdHelper& MuonGMR4::MdtReadoutElement::m_idHelper {idHelperSvc()->mdtIdHelper()}

private

Detector identifier helper to quickly extract the ID fields.

Definition at line 283 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

{idHelperSvc()->mdtIdHelper()};

m_idHelperSvc

ServiceHandle<Muon::IMuonIdHelperSvc> MuonGMR4::MuonReadoutElement::m_idHelperSvc {"Muon::MuonIdHelperSvc/MuonIdHelperSvc", "MuonReadoutElement"}

privateinherited

IdHelperSvc for Identifier manipulation.

Definition at line 259 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{"Muon::MuonIdHelperSvc/MuonIdHelperSvc", "MuonReadoutElement"};

m_imsg

std::atomic<IMessageSvc*> AthMessaging::m_imsg { nullptr }

mutableprivateinherited

MessageSvc pointer.

Definition at line 135 of file AthMessaging.h.

{ nullptr };

m_isBarrel

bool MuonGMR4::MdtReadoutElement::m_isBarrel {m_idHelper.isBarrel(identify())}

private

Flag defining whether the chamber is barrel or not.

Definition at line 287 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

{m_idHelper.isBarrel(identify())};

m_localToGlobalCaches

TransformCacheMap MuonGMR4::MuonReadoutElement::m_localToGlobalCaches {}

privateinherited

Definition at line 272 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{};

m_lvl

std::atomic<MSG::Level> AthMessaging::m_lvl { MSG::NIL }

mutableprivateinherited

Current logging level.

Definition at line 138 of file AthMessaging.h.

{ MSG::NIL };

m_msg_tls

boost::thread_specific_ptr<MsgStream> AthMessaging::m_msg_tls

mutableprivateinherited

MsgStream instance (a std::cout like with print-out levels)

Definition at line 132 of file AthMessaging.h.

m_msSectorLink

const SpectrometerSector* MuonGMR4::MuonReadoutElement::m_msSectorLink {}

privateinherited

Pointer to the associated MS-sector & MuonChamber.

Definition at line 283 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{};

m_nm

std::string AthMessaging::m_nm

privateinherited

Message source name.

Definition at line 129 of file AthMessaging.h.

m_pars

parameterBook MuonGMR4::MdtReadoutElement::m_pars {}

private

defining parameter set

Definition at line 281 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

{};

m_reOtherMl

const MdtReadoutElement* MuonGMR4::MdtReadoutElement::m_reOtherMl {this}

private

Complementary readout element.

Definition at line 289 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

{this};

m_stEta

int MuonGMR4::MuonReadoutElement::m_stEta {-1}

privateinherited

Cache the station eta of the identifier.

Definition at line 267 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{-1};

m_stML

int MuonGMR4::MdtReadoutElement::m_stML {m_idHelper.multilayer(identify())}

private

Identifier index of the multilayer (1-2)

Definition at line 285 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h.

{m_idHelper.multilayer(identify())};

m_stName

int MuonGMR4::MuonReadoutElement::m_stName {-1}

privateinherited

Cache the station name of the identifier.

Definition at line 265 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{-1};

m_stPhi

int MuonGMR4::MuonReadoutElement::m_stPhi {-1}

privateinherited

Cache the station phi of the identifier.

Definition at line 269 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

{-1};

m_surfaces

ActsTrk::SurfaceCacheSet MuonGMR4::MuonReadoutElement::m_surfaces

privateinherited

Cache of all associated surfaces.

Definition at line 281 of file MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MuonReadoutElement.h.

---

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

• MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/MuonReadoutGeometryR4/MdtReadoutElement.h
• MuonPhaseII/MuonDetDescr/MuonReadoutGeometryR4/src/MdtReadoutElement.cxx