Trk::MaterialEffectsBase Class Reference

base class to integrate material effects on Trk::Track in a flexible way. More...

#include <MaterialEffectsBase.h>

Inheritance diagram for Trk::MaterialEffectsBase:

Collaboration diagram for Trk::MaterialEffectsBase:

Public Types
enum	MaterialEffectsDerivedType { ESTIMATED_BREM_ON_TRACK = 0 , MATERIAL_EFFECTS_ON_TRACK , NTYPES }
enum	MaterialEffectsType {   ScatteringEffects = 0 , EnergyLossEffects = 1 , MaterialThickness = 2 , BremPoint = 3 ,   UsesMeasurement = 4 , FittedMaterialEffects = 5 , Unknown = 6 , NumberOfMaterialEffectsTypes = 7 }

Public Member Functions
	MaterialEffectsBase ()
	default constructor for POOL
	MaterialEffectsBase (double thicknessInX0, const Surface &assocSurf, const std::bitset< MaterialEffectsBase::NumberOfMaterialEffectsTypes > &typePattern)
	base class constructor with information common to all types of material effects.
virtual	~MaterialEffectsBase ()=default
	destructor.
virtual MaterialEffectsBase *	clone () const =0
	Virtual constructor.
std::unique_ptr< MaterialEffectsBase >	uniqueClone () const
	NVI uniqueClone.
double	thicknessInX0 () const
	returns the actually traversed material \( t/X_0 \).
const Surface &	associatedSurface () const
	returns the surface to which these m.eff. are associated.
bool	type (const MaterialEffectsType &type) const
	returns the flags (bits) which types of ME are present
virtual MaterialEffectsDerivedType	derivedType () const =0
	Returns the concrete derived type.
std::string	dumpType () const
	returns a string with the type of the object
virtual MsgStream &	dump (MsgStream &sl) const
	Interface method for output, can be overloaded by child classes.
virtual std::ostream &	dump (std::ostream &sl) const
	Interface method for output, can be overloaded by child classes* *‍/.
const Surface *	surfacePtr ()
	return the ptr we hold useful for tests
const Surface *	release () noexcept
	release ala unique_ptr release
void	destroySurface () noexcept
	destroySurface deletes the ptr if not null and the surface has not a associatedDetectorElement Usefull also for testing

Static Public Member Functions
static const Surface *	cloneHelper (const Surface *input)
	Helper for cloning or not when we need depending on if we have an associatedDetectorElement.

Protected Member Functions
virtual void	setValues (const Surface *assocSurface)
	allows POOL converter to recreate transient links to DetStore
	MaterialEffectsBase (const MaterialEffectsBase &rhs)=default
	copy constructor
MaterialEffectsBase &	operator= (const MaterialEffectsBase &rhs)=default
	Assignment operator.
	MaterialEffectsBase (MaterialEffectsBase &&rhs)=default
	move constructor
MaterialEffectsBase &	operator= (MaterialEffectsBase &&rhs)=default
	move Assignment operator

Protected Attributes
const Surface *	m_associatedSurface

Private Attributes
double	m_tInX0 {}
	\( t/X_0 \) - the traversed thickness in RadiationLengths
long	m_typeFlags {}

Friends
class	::MaterialEffectsBaseCnv_p1
class	::MaterialEffectsBaseCnv_p2
class	::MaterialEffectsOnTrackCnv_p2
class	::TrackCollectionCnv
class	::ScatteringAngleOnTrackCnv_p1

Detailed Description

base class to integrate material effects on Trk::Track in a flexible way.

It holds the pointer to an associated surface (free or from DetStore) and the layer thickness which was used in estimated the material effects. In case they are external (Calo measurement) they can be 0.

Author

Wolfgang.Liebig http://consult.cern.ch/xwho/people/

Definition at line 34 of file MaterialEffectsBase.h.

Member Enumeration Documentation

MaterialEffectsDerivedType

enum Trk::MaterialEffectsBase::MaterialEffectsDerivedType

Enumerator
ESTIMATED_BREM_ON_TRACK
MATERIAL_EFFECTS_ON_TRACK
NTYPES

Definition at line 37 of file MaterialEffectsBase.h.

                                 {
    ESTIMATED_BREM_ON_TRACK = 0,
    MATERIAL_EFFECTS_ON_TRACK,
    NTYPES
  };

MaterialEffectsType

enum Trk::MaterialEffectsBase::MaterialEffectsType

Enumerator
ScatteringEffects	contains material effects due to multiple scattering
EnergyLossEffects	contains energy loss corrections
MaterialThickness	contains only thickness, needs M.E.Updator to calculate effects
BremPoint	contains q/p covariance noise term
UsesMeasurement	contains energy loss correction based on Calo measurement
FittedMaterialEffects	contains values obtained by fitting the scatterer or e-loss
Unknown	new category
NumberOfMaterialEffectsTypes

Definition at line 42 of file MaterialEffectsBase.h.

  {
    ScatteringEffects = 0,
    // trouble: avoid name clash Trk::Energyloss vs MET::EnergyLoss
    EnergyLossEffects = 1,
    MaterialThickness = 2,
    BremPoint = 3,
    UsesMeasurement = 4,
    FittedMaterialEffects = 5,
    Unknown = 6,
    NumberOfMaterialEffectsTypes = 7
    // WARNING need to edit MaterialEffectsOnTrack.cxx if these enums change
  };

Constructor & Destructor Documentation

MaterialEffectsBase() [1/4]

Trk::MaterialEffectsBase::MaterialEffectsBase

(

)

default constructor for POOL

MaterialEffectsBase() [2/4]

Trk::MaterialEffectsBase::MaterialEffectsBase	(	double	thicknessInX0,
		const Surface &	assocSurf,
		const std::bitset< MaterialEffectsBase::NumberOfMaterialEffectsTypes > &	typePattern )

base class constructor with information common to all types of material effects.

Parameters

[in]	thicknessInX0	is the actually traversed materia t in terms of radiation length x0, including all projective and bending corrections.
[in]	assocSurf	reference to the Surface the material effects are expressed at
[in]	typePattern	bitset to describe and identify the type of material effects at base-class level

~MaterialEffectsBase()

virtual Trk::MaterialEffectsBase::~MaterialEffectsBase ( )

virtualdefault

destructor.

Being virtual forces derived classes to call also this base destructor

MaterialEffectsBase() [3/4]

Trk::MaterialEffectsBase::MaterialEffectsBase ( const MaterialEffectsBase & rhs )

protecteddefault

copy constructor

MaterialEffectsBase() [4/4]

Trk::MaterialEffectsBase::MaterialEffectsBase ( MaterialEffectsBase && rhs )

protecteddefault

move constructor

Member Function Documentation

associatedSurface()

const Surface & Trk::MaterialEffectsBase::associatedSurface

(

)

const

returns the surface to which these m.eff. are associated.

clone()

virtual MaterialEffectsBase * Trk::MaterialEffectsBase::clone ( ) const

pure virtual

Virtual constructor.

Implemented in Trk::EstimatedBremOnTrack, and Trk::MaterialEffectsOnTrack.

cloneHelper()

const Surface * Trk::SurfacePtrHolderImplDetEl< Surface >::cloneHelper ( const Surface * input )

inlinestaticinherited

Helper for cloning or not when we need depending on if we have an associatedDetectorElement.

Definition at line 213 of file SurfaceHolderImpl.h.

  {
    return (input && input->associatedDetectorElement() == nullptr
              ? input->clone()
              : input);
  }

derivedType()

virtual MaterialEffectsDerivedType Trk::MaterialEffectsBase::derivedType ( ) const

pure virtual

Returns the concrete derived type.

Implemented in Trk::EstimatedBremOnTrack, and Trk::MaterialEffectsOnTrack.

destroySurface()

void Trk::SurfacePtrHolderImplDetEl< Surface >::destroySurface ( )

inlinenoexceptinherited

destroySurface deletes the ptr if not null and the surface has not a associatedDetectorElement Usefull also for testing

Definition at line 201 of file SurfaceHolderImpl.h.

  {
    if (m_associatedSurface &&
        m_associatedSurface->associatedDetectorElement() == nullptr) {
      delete m_associatedSurface;
    }
    //
    m_associatedSurface = nullptr;
  }

dump() [1/2]

MsgStream & Trk::MaterialEffectsBase::dump ( MsgStream & sl ) const

virtual

Interface method for output, can be overloaded by child classes.

Reimplemented in Trk::EstimatedBremOnTrack, and Trk::MaterialEffectsOnTrack.

Definition at line 65 of file MaterialEffectsBase.cxx.

{
  std::string name("MaterialEffects ");
  sl << name << "type        : " << dumpType() << endmsg;
  sl << name << "thickness/X0: " << thicknessInX0() << endmsg;
  sl << name << "Surface     : ";
  if (m_associatedSurface == nullptr) {
    sl << "NULL";
  } else {
    if (m_associatedSurface->associatedDetectorElement() != nullptr) {
      sl << "from detector Element";
    } else {
      sl << associatedSurface() << endmsg;
    }
  }
  sl << endmsg;
  return sl;
}

dump() [2/2]

std::ostream & Trk::MaterialEffectsBase::dump ( std::ostream & sl ) const

virtual

Interface method for output, can be overloaded by child classes* *‍/.

Reimplemented in Trk::EstimatedBremOnTrack, and Trk::MaterialEffectsOnTrack.

Definition at line 85 of file MaterialEffectsBase.cxx.

{
  sl << "MaterialEffects type        : " << dumpType() << std::endl;
  sl << "MaterialEffects thickness/X0: " << thicknessInX0() << std::endl;
  sl << "MaterialEffects Surface     : ";
  if (m_associatedSurface == nullptr) {
    sl << "NULL";
  } else {
    if (m_associatedSurface->associatedDetectorElement() != nullptr) {
      sl << "from detector Element";
    } else {
      sl << associatedSurface() << std::endl;
    }
  }
  sl << std::endl;
  return sl;
}

dumpType()

std::string Trk::MaterialEffectsBase::dumpType

(

)

const

returns a string with the type of the object

Definition at line 16 of file MaterialEffectsBase.cxx.

{
  std::string type;
  for (int i = 0; i < NumberOfMaterialEffectsTypes; ++i) {
    if ((1 << i) & m_typeFlags) {
      switch (i) {
        case Trk::MaterialEffectsBase::ScatteringEffects:
          type += "Scattering ";
          break;
        case Trk::MaterialEffectsBase::EnergyLossEffects:
          type += "EnergyLoss ";
          break;
        case Trk::MaterialEffectsBase::MaterialThickness:
          type += "UpdatorInput ";
          break;
        case Trk::MaterialEffectsBase::BremPoint:
          type += "BremPoint ";
          break;
        case Trk::MaterialEffectsBase::UsesMeasurement:
          type += "UsesMeasurement ";
          break;
        case Trk::MaterialEffectsBase::FittedMaterialEffects:
          type += "FittedMaterialEffects ";
          break;
        default:
          type += "Unknown ";
          break;
      }
    }
  }
  return type;
}

operator=() [1/2]

MaterialEffectsBase & Trk::MaterialEffectsBase::operator= ( const MaterialEffectsBase & rhs )

protecteddefault

Assignment operator.

operator=() [2/2]

MaterialEffectsBase & Trk::MaterialEffectsBase::operator= ( MaterialEffectsBase && rhs )

protecteddefault

move Assignment operator

release()

const Surface * Trk::SurfacePtrHolderImplDetEl< Surface >::release ( )

inlinenoexceptinherited

release ala unique_ptr release

Definition at line 192 of file SurfaceHolderImpl.h.

  {
    const S* tmp = m_associatedSurface;
    m_associatedSurface = nullptr;
    return tmp;
  }

setValues()

virtual void Trk::MaterialEffectsBase::setValues ( const Surface * assocSurface )

protectedvirtual

allows POOL converter to recreate transient links to DetStore

surfacePtr()

const Surface * Trk::SurfacePtrHolderImplDetEl< Surface >::surfacePtr ( )

inlineinherited

return the ptr we hold useful for tests

Definition at line 190 of file SurfaceHolderImpl.h.

{ return m_associatedSurface; }

thicknessInX0()

double Trk::MaterialEffectsBase::thicknessInX0

(

)

const

returns the actually traversed material \( t/X_0 \).

Leave 0.0 for external ME.

type()

bool Trk::MaterialEffectsBase::type

(

const MaterialEffectsType &

type

)

const

returns the flags (bits) which types of ME are present

Use this method to find out if the ME is of a certain type: i.e. if ( mefot->type(MaterialEffectsBase::EnergyLoss) { //etc }

Returns

true if the MaterialEffectsBase is of this type

uniqueClone()

std::unique_ptr< MaterialEffectsBase > Trk::MaterialEffectsBase::uniqueClone ( ) const

inline

NVI uniqueClone.

Definition at line 87 of file MaterialEffectsBase.h.

  {
    return std::unique_ptr<MaterialEffectsBase>(clone());
  }

Friends And Related Symbol Documentation

::MaterialEffectsBaseCnv_p1

friend class ::MaterialEffectsBaseCnv_p1

friend

Definition at line 132 of file MaterialEffectsBase.h.

::MaterialEffectsBaseCnv_p2

friend class ::MaterialEffectsBaseCnv_p2

friend

Definition at line 133 of file MaterialEffectsBase.h.

::MaterialEffectsOnTrackCnv_p2

friend class ::MaterialEffectsOnTrackCnv_p2

friend

Definition at line 134 of file MaterialEffectsBase.h.

::ScatteringAngleOnTrackCnv_p1

friend class ::ScatteringAngleOnTrackCnv_p1

friend

Definition at line 136 of file MaterialEffectsBase.h.

::TrackCollectionCnv

friend class ::TrackCollectionCnv

friend

Definition at line 135 of file MaterialEffectsBase.h.

Member Data Documentation

m_associatedSurface

const Surface* Trk::SurfacePtrHolderImplDetEl< Surface >::m_associatedSurface

protectedinherited

Definition at line 221 of file SurfaceHolderImpl.h.

m_tInX0

double Trk::MaterialEffectsBase::m_tInX0 {}

private

\( t/X_0 \) - the traversed thickness in RadiationLengths

Definition at line 139 of file MaterialEffectsBase.h.

{};

m_typeFlags

long Trk::MaterialEffectsBase::m_typeFlags {}

private

Definition at line 140 of file MaterialEffectsBase.h.

{};

---

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

• MaterialEffectsBase.h
• MaterialEffectsBase.cxx