ATLAS Offline Software
Loading...
Searching...
No Matches
EMVertexBuilder Class Reference

This tool builds ID vertices from a given TrackParticleContainer. More...

#include <EMVertexBuilder.h>

Inheritance diagram for EMVertexBuilder:
Collaboration diagram for EMVertexBuilder:

Public Member Functions

 EMVertexBuilder (const std::string &name, ISvcLocator *pSvcLocator)
virtual StatusCode initialize () override final
virtual StatusCode finalize () override final
virtual StatusCode execute (const EventContext &ctx) const override final
virtual StatusCode sysInitialize () override
 Override sysInitialize.
virtual bool isClonable () const override
 Specify if the algorithm is clonable.
virtual unsigned int cardinality () const override
 Cardinality (Maximum number of clones that can exist) special value 0 means that algorithm is reentrant.
virtual StatusCode sysExecute (const EventContext &ctx) override
 Execute an algorithm.
virtual const DataObjIDColl & extraOutputDeps () const override
 Return the list of extra output dependencies.
virtual bool filterPassed (const EventContext &ctx) const
virtual void setFilterPassed (bool state, const EventContext &ctx) const
ServiceHandle< StoreGateSvc > & evtStore ()
 The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.
const ServiceHandle< StoreGateSvc > & detStore () const
 The standard StoreGateSvc/DetectorStore Returns (kind of) a pointer to the StoreGateSvc.
virtual StatusCode sysStart () override
 Handle START transition.
virtual std::vector< Gaudi::DataHandle * > inputHandles () const override
 Return this algorithm's input handles.
virtual std::vector< Gaudi::DataHandle * > outputHandles () const override
 Return this algorithm's output handles.
Gaudi::Details::PropertyBase & declareProperty (Gaudi::Property< T, V, H > &t)
void updateVHKA (Gaudi::Details::PropertyBase &)
MsgStream & msg () const
bool msgLvl (const MSG::Level lvl) const

Protected Member Functions

void renounceArray (SG::VarHandleKeyArray &handlesArray)
 remove all handles from I/O resolution
std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void > renounce (T &h)
void extraDeps_update_handler (Gaudi::Details::PropertyBase &ExtraDeps)
 Add StoreName to extra input/output deps as needed.

Private Types

typedef ServiceHandle< StoreGateSvcStoreGateSvc_t

Private Member Functions

Gaudi::Details::PropertyBase & declareGaudiProperty (Gaudi::Property< T, V, H > &hndl, const SG::VarHandleKeyType &)
 specialization for handling Gaudi::Property<SG::VarHandleKey>

Private Attributes

Gaudi::Property< float > m_maxRadius
 Maximum radius accepted for conversion vertices.
Gaudi::Property< float > m_minPtCut_DoubleTrack
 Minimum Pt, less than that TRT track are pileup for double/single track conversion.
Gaudi::Property< float > m_minPtCut_SingleTrack
SG::ReadHandleKey< xAOD::TrackParticleContainerm_inputTrackParticleContainerKey
 TrackParticle container input name.
SG::WriteHandleKey< xAOD::VertexContainerm_outputConversionContainerKey
 conversion container output name
ToolHandle< InDet::IVertexFinderm_vertexFinderTool
 Tool to find vertices (creates double-track conversions)
ToolHandle< IEMExtrapolationToolsm_EMExtrapolationTool
 EMExtrapolationTool.
DataObjIDColl m_extendedExtraObjects
 Extra output dependency collection, extended by AthAlgorithmDHUpdate to add symlinks.
StoreGateSvc_t m_evtStore
 Pointer to StoreGate (event store by default)
StoreGateSvc_t m_detStore
 Pointer to StoreGate (detector store by default)
std::vector< SG::VarHandleKeyArray * > m_vhka
bool m_varHandleArraysDeclared

Detailed Description

This tool builds ID vertices from a given TrackParticleContainer.

Author
Kerstin Tackmann (based on work by many others)

Input container:

  • InputTrackParticleContainerName (default=GSFTrackParticles): collection of TrackParticles to be used to find vertices Output container:
  • OutputConversionContainerName (default=GSFConversionVertices) collection of fitted vertices

The fitting of the vertices is delegate to a tool implementing the InDet::IVertexFinder interface, configured with the VertexFinderTool property, by default InDetConversionFinderTools.

After the vertex are created only the ones passing the selection are saved.

  • maximum radius (MaxRadius property)
  • for doubleTRT or singleTRT conversion a minimum pT (minPCutSingleTrackConversion and minPCutDoubleTrackConversion)

Vertex are decorated with:

  • momentum at vertex, as sum of the the track extrapolated: px, py, pz
  • eta-at-calo, phi-at-calo computed with the ExtrapolationTool

Definition at line 45 of file EMVertexBuilder.h.

Member Typedef Documentation

◆ StoreGateSvc_t

typedef ServiceHandle<StoreGateSvc> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::StoreGateSvc_t
privateinherited

Definition at line 388 of file AthCommonDataStore.h.

Constructor & Destructor Documentation

◆ EMVertexBuilder()

EMVertexBuilder::EMVertexBuilder ( const std::string & name,
ISvcLocator * pSvcLocator )

Definition at line 29 of file EMVertexBuilder.cxx.

31 : AthReentrantAlgorithm(name, pSvcLocator)
32{
33}

Member Function Documentation

◆ cardinality()

unsigned int AthCommonReentrantAlgorithm< Gaudi::Algorithm >::cardinality ( ) const
overridevirtualinherited

Cardinality (Maximum number of clones that can exist) special value 0 means that algorithm is reentrant.

Override this to return 0 for reentrant algorithms.

Definition at line 75 of file AthCommonReentrantAlgorithm.cxx.

64{
65 return 0;
66}

◆ declareGaudiProperty()

Gaudi::Details::PropertyBase & AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareGaudiProperty ( Gaudi::Property< T, V, H > & hndl,
const SG::VarHandleKeyType &  )
inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleKey>

Definition at line 156 of file AthCommonDataStore.h.

158 {
160 hndl.value(),
161 hndl.documentation());
162
163 }
Gaudi::Details::PropertyBase & declareProperty(Gaudi::Property< T, V, H > &t)

◆ declareProperty()

Gaudi::Details::PropertyBase & AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::declareProperty ( Gaudi::Property< T, V, H > & t)
inlineinherited

Definition at line 145 of file AthCommonDataStore.h.

145 {
146 typedef typename SG::HandleClassifier<T>::type htype;
148 }
Gaudi::Details::PropertyBase & declareGaudiProperty(Gaudi::Property< T, V, H > &hndl, const SG::VarHandleKeyType &)
specialization for handling Gaudi::Property<SG::VarHandleKey>

◆ detStore()

const ServiceHandle< StoreGateSvc > & AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::detStore ( ) const
inlineinherited

The standard StoreGateSvc/DetectorStore Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 95 of file AthCommonDataStore.h.

◆ evtStore()

ServiceHandle< StoreGateSvc > & AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::evtStore ( )
inlineinherited

The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 85 of file AthCommonDataStore.h.

◆ execute()

StatusCode EMVertexBuilder::execute ( const EventContext & ctx) const
finaloverridevirtual

Definition at line 54 of file EMVertexBuilder.cxx.

55{
56
57 //retrieve TrackParticleContainer
58 SG::ReadHandle<xAOD::TrackParticleContainer> TPCol(m_inputTrackParticleContainerKey,ctx);
59
60 // check for serial running only, remove in MT
61 ATH_CHECK(TPCol.isValid());
62
63 std::pair<xAOD::VertexContainer*, xAOD::VertexAuxContainer*> verticesPair =
64 m_vertexFinderTool->findVertex(ctx,TPCol.cptr());
65
66 if (!verticesPair.first || !verticesPair.second){
67 ATH_MSG_ERROR("Null pointer to conversion container");
68 return StatusCode::SUCCESS;
69 }
70
71 SG::WriteHandle<xAOD::VertexContainer>vertices(m_outputConversionContainerKey,ctx);
72
73 ATH_CHECK(vertices.record(std::unique_ptr<xAOD::VertexContainer>(verticesPair.first),
74 std::unique_ptr<xAOD::VertexAuxContainer>(verticesPair.second)));
75
76 ATH_MSG_DEBUG("New conversion container size: " << vertices->size());
77
78 // Remove vertices with radii above m_maxRadius
79 xAOD::VertexContainer::iterator itVtx = vertices->begin();
80 xAOD::VertexContainer::iterator itVtxEnd = vertices->end();
81
82 while (itVtx != itVtxEnd){
83 xAOD::Vertex* vertex = *itVtx;
84
85 Amg::Vector3D momentum(0., 0., 0.);
86 for (unsigned int i = 0; i < vertex->nTrackParticles(); ++i){
87 momentum += m_EMExtrapolationTool->getMomentumAtVertex(ctx,*vertex, i);
88 }
89
90 static const SG::AuxElement::Accessor<float> accPx("px");
91 static const SG::AuxElement::Accessor<float> accPy("py");
92 static const SG::AuxElement::Accessor<float> accPz("pz");
93 accPx(*vertex) = momentum.x();
94 accPy(*vertex) = momentum.y();
95 accPz(*vertex) = momentum.z();
96
98 const bool vxDoubleTRT = (convType == xAOD::EgammaParameters::doubleTRT);
99 const bool vxSingleTRT = (convType == xAOD::EgammaParameters::singleTRT);
100
101 if ((vxDoubleTRT && momentum.perp() < m_minPtCut_DoubleTrack) ||
102 (vxSingleTRT && momentum.perp() < m_minPtCut_SingleTrack) ||
103 ((*itVtx)->position().perp() > m_maxRadius)) {
104
105 itVtx = vertices->erase(itVtx);
106 itVtxEnd = vertices->end();
107 } else {
108 // Decorate the vertices with the momentum at the conversion point and
109 // etaAtCalo, phiAtCalo (extrapolate each vertex)
110 float etaAtCalo = -9999.;
111 float phiAtCalo = -9999.;
112
113 if (!m_EMExtrapolationTool->getEtaPhiAtCalo(
114 ctx, vertex, &etaAtCalo, &phiAtCalo)) {
115 ATH_MSG_DEBUG("getEtaPhiAtCalo failed!");
116 }
117
118 static const SG::AuxElement::Accessor<float> accetaAtCalo("etaAtCalo");
119 static const SG::AuxElement::Accessor<float> accphiAtCalo("phiAtCalo");
120 accetaAtCalo(*vertex) = etaAtCalo;
121 accphiAtCalo(*vertex) = phiAtCalo;
122
123 ++itVtx;
124 }
125 }
126
127 return StatusCode::SUCCESS;
128}
#define ATH_CHECK
Evaluate an expression and check for errors.
#define ATH_MSG_ERROR(x)
#define ATH_MSG_DEBUG(x)
DataModel_detail::iterator< DataVector > iterator
Definition DataVector.h:842
ToolHandle< IEMExtrapolationTools > m_EMExtrapolationTool
EMExtrapolationTool.
SG::WriteHandleKey< xAOD::VertexContainer > m_outputConversionContainerKey
conversion container output name
Gaudi::Property< float > m_minPtCut_SingleTrack
ToolHandle< InDet::IVertexFinder > m_vertexFinderTool
Tool to find vertices (creates double-track conversions)
Gaudi::Property< float > m_maxRadius
Maximum radius accepted for conversion vertices.
SG::ReadHandleKey< xAOD::TrackParticleContainer > m_inputTrackParticleContainerKey
TrackParticle container input name.
Gaudi::Property< float > m_minPtCut_DoubleTrack
Minimum Pt, less than that TRT track are pileup for double/single track conversion.
Eigen::Matrix< double, 3, 1 > Vector3D
xAOD::EgammaParameters::ConversionType conversionType(const xAOD::Photon *ph)
return the photon conversion type (see EgammaEnums)
@ doubleTRT
two tracks, none with Si hits (TRT only)
@ singleTRT
one track only, no Si hits (TRT only)
Vertex_v1 Vertex
Define the latest version of the vertex class.

◆ extraDeps_update_handler()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::extraDeps_update_handler ( Gaudi::Details::PropertyBase & ExtraDeps)
protectedinherited

Add StoreName to extra input/output deps as needed.

use the logic of the VarHandleKey to parse the DataObjID keys supplied via the ExtraInputs and ExtraOuputs Properties to add the StoreName if it's not explicitly given

◆ extraOutputDeps()

const DataObjIDColl & AthCommonReentrantAlgorithm< Gaudi::Algorithm >::extraOutputDeps ( ) const
overridevirtualinherited

Return the list of extra output dependencies.

This list is extended to include symlinks implied by inheritance relations.

Definition at line 94 of file AthCommonReentrantAlgorithm.cxx.

90{
91 // If we didn't find any symlinks to add, just return the collection
92 // from the base class. Otherwise, return the extended collection.
93 if (!m_extendedExtraObjects.empty()) {
95 }
97}
An algorithm that can be simultaneously executed in multiple threads.

◆ filterPassed()

virtual bool AthCommonReentrantAlgorithm< Gaudi::Algorithm >::filterPassed ( const EventContext & ctx) const
inlinevirtualinherited

Definition at line 96 of file AthCommonReentrantAlgorithm.h.

96 {
97 return execState( ctx ).filterPassed();
98 }
virtual bool filterPassed(const EventContext &ctx) const

◆ finalize()

StatusCode EMVertexBuilder::finalize ( )
finaloverridevirtual

Definition at line 50 of file EMVertexBuilder.cxx.

50 {
51 return StatusCode::SUCCESS;
52}

◆ initialize()

StatusCode EMVertexBuilder::initialize ( )
finaloverridevirtual

Definition at line 35 of file EMVertexBuilder.cxx.

35 {
36
37 ATH_MSG_DEBUG( "Initializing " << name() << "...");
38
41
42 // Get the ID VertexFinderTool
43 ATH_CHECK( m_vertexFinderTool.retrieve());
44 // Retrieve EMExtrapolationTool
46
47 return StatusCode::SUCCESS;
48}

◆ inputHandles()

virtual std::vector< Gaudi::DataHandle * > AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::inputHandles ( ) const
overridevirtualinherited

Return this algorithm's input handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

◆ isClonable()

◆ msg()

MsgStream & AthCommonMsg< Gaudi::Algorithm >::msg ( ) const
inlineinherited

Definition at line 24 of file AthCommonMsg.h.

24 {
25 return this->msgStream();
26 }

◆ msgLvl()

bool AthCommonMsg< Gaudi::Algorithm >::msgLvl ( const MSG::Level lvl) const
inlineinherited

Definition at line 30 of file AthCommonMsg.h.

30 {
31 return this->msgLevel(lvl);
32 }

◆ outputHandles()

virtual std::vector< Gaudi::DataHandle * > AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::outputHandles ( ) const
overridevirtualinherited

Return this algorithm's output handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

◆ renounce()

std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void > AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::renounce ( T & h)
inlineprotectedinherited

Definition at line 380 of file AthCommonDataStore.h.

381 {
382 h.renounce();
384 }
std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void > renounce(T &h)

◆ renounceArray()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::renounceArray ( SG::VarHandleKeyArray & handlesArray)
inlineprotectedinherited

remove all handles from I/O resolution

Definition at line 364 of file AthCommonDataStore.h.

364 {
366 }

◆ setFilterPassed()

virtual void AthCommonReentrantAlgorithm< Gaudi::Algorithm >::setFilterPassed ( bool state,
const EventContext & ctx ) const
inlinevirtualinherited

Definition at line 100 of file AthCommonReentrantAlgorithm.h.

100 {
102 }
virtual void setFilterPassed(bool state, const EventContext &ctx) const

◆ sysExecute()

StatusCode AthCommonReentrantAlgorithm< Gaudi::Algorithm >::sysExecute ( const EventContext & ctx)
overridevirtualinherited

Execute an algorithm.

We override this in order to work around an issue with the Algorithm base class storing the event context in a member variable that can cause crashes in MT jobs.

Definition at line 85 of file AthCommonReentrantAlgorithm.cxx.

77{
78 return BaseAlg::sysExecute (ctx);
79}

◆ sysInitialize()

StatusCode AthCommonReentrantAlgorithm< Gaudi::Algorithm >::sysInitialize ( )
overridevirtualinherited

Override sysInitialize.

Override sysInitialize from the base class.

Loop through all output handles, and if they're WriteCondHandles, automatically register them and this Algorithm with the CondSvc

Scan through all outputHandles, and if they're WriteCondHandles, register them with the CondSvc

Reimplemented from AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >.

Reimplemented in HypoBase, and InputMakerBase.

Definition at line 61 of file AthCommonReentrantAlgorithm.cxx.

107 {
109
110 if (sc.isFailure()) {
111 return sc;
112 }
113
114 ServiceHandle<ICondSvc> cs("CondSvc",name());
115 for (auto h : outputHandles()) {
116 if (h->isCondition() && h->mode() == Gaudi::DataHandle::Writer) {
117 // do this inside the loop so we don't create the CondSvc until needed
118 if ( cs.retrieve().isFailure() ) {
119 ATH_MSG_WARNING("no CondSvc found: won't autoreg WriteCondHandles");
120 return StatusCode::SUCCESS;
121 }
122 if (cs->regHandle(this,*h).isFailure()) {
124 ATH_MSG_ERROR("unable to register WriteCondHandle " << h->fullKey()
125 << " with CondSvc");
126 }
127 }
128 }
129 return sc;
130}
#define ATH_MSG_WARNING(x)
virtual std::vector< Gaudi::DataHandle * > outputHandles() const override

◆ sysStart()

virtual StatusCode AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::sysStart ( )
overridevirtualinherited

Handle START transition.

We override this in order to make sure that conditions handle keys can cache a pointer to the conditions container.

◆ updateVHKA()

void AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::updateVHKA ( Gaudi::Details::PropertyBase & )
inlineinherited

Definition at line 308 of file AthCommonDataStore.h.

308 {
309 // debug() << "updateVHKA for property " << p.name() << " " << p.toString()
310 // << " size: " << m_vhka.size() << endmsg;
311 for (auto &a : m_vhka) {
313 for (auto k : keys) {
314 k->setOwner(this);
315 }
316 }
317 }

Member Data Documentation

◆ m_detStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_detStore
privateinherited

Pointer to StoreGate (detector store by default)

Definition at line 393 of file AthCommonDataStore.h.

◆ m_EMExtrapolationTool

ToolHandle<IEMExtrapolationTools> EMVertexBuilder::m_EMExtrapolationTool
private
Initial value:
{this,
"ExtrapolationTool", "EMExtrapolationTools", "Handle of the extrapolation tool"}

EMExtrapolationTool.

Definition at line 84 of file EMVertexBuilder.h.

84 {this,
85 "ExtrapolationTool", "EMExtrapolationTools", "Handle of the extrapolation tool"};

◆ m_evtStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_evtStore
privateinherited

Pointer to StoreGate (event store by default)

Definition at line 390 of file AthCommonDataStore.h.

◆ m_extendedExtraObjects

DataObjIDColl AthCommonReentrantAlgorithm< Gaudi::Algorithm >::m_extendedExtraObjects
privateinherited

Extra output dependency collection, extended by AthAlgorithmDHUpdate to add symlinks.

Empty if no symlinks were found.

Definition at line 114 of file AthCommonReentrantAlgorithm.h.

◆ m_inputTrackParticleContainerKey

SG::ReadHandleKey<xAOD::TrackParticleContainer> EMVertexBuilder::m_inputTrackParticleContainerKey
private
Initial value:
{this,
"InputTrackParticleContainerName", "GSFTrackParticles", "Input TrackParticles"}

TrackParticle container input name.

Definition at line 70 of file EMVertexBuilder.h.

70 {this,
71 "InputTrackParticleContainerName", "GSFTrackParticles", "Input TrackParticles"};

◆ m_maxRadius

Gaudi::Property<float> EMVertexBuilder::m_maxRadius
private
Initial value:
{this, "MaxRadius", 800.,
"Maximum radius accepted for conversion vertices"}

Maximum radius accepted for conversion vertices.

Definition at line 57 of file EMVertexBuilder.h.

57 {this, "MaxRadius", 800.,
58 "Maximum radius accepted for conversion vertices"};

◆ m_minPtCut_DoubleTrack

Gaudi::Property<float> EMVertexBuilder::m_minPtCut_DoubleTrack
private
Initial value:
{this,
"minPCutDoubleTrackConversion", 2000,
"Minimum Pt, less than that TRT tracks pileup for double-track conversion"}

Minimum Pt, less than that TRT track are pileup for double/single track conversion.

Definition at line 61 of file EMVertexBuilder.h.

61 {this,
62 "minPCutDoubleTrackConversion", 2000,
63 "Minimum Pt, less than that TRT tracks pileup for double-track conversion"};

◆ m_minPtCut_SingleTrack

Gaudi::Property<float> EMVertexBuilder::m_minPtCut_SingleTrack
private
Initial value:
{this,
"minPCutSingleTrackConversion", 2000,
"Minimum Pt, less than that TRT track pileup for single-track conversion"}

Definition at line 65 of file EMVertexBuilder.h.

65 {this,
66 "minPCutSingleTrackConversion", 2000,
67 "Minimum Pt, less than that TRT track pileup for single-track conversion"};

◆ m_outputConversionContainerKey

SG::WriteHandleKey<xAOD::VertexContainer> EMVertexBuilder::m_outputConversionContainerKey
private
Initial value:
{this,
"OutputConversionContainerName", "GSFConversionVertices",
"Output conversion vertices"}

conversion container output name

Definition at line 74 of file EMVertexBuilder.h.

74 {this,
75 "OutputConversionContainerName", "GSFConversionVertices",
76 "Output conversion vertices"};

◆ m_varHandleArraysDeclared

bool AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_varHandleArraysDeclared
privateinherited

Definition at line 399 of file AthCommonDataStore.h.

◆ m_vertexFinderTool

ToolHandle<InDet::IVertexFinder> EMVertexBuilder::m_vertexFinderTool
private
Initial value:
{this,
"VertexFinderTool", "InDetConversionFinderTools",
"The tool that does the converions finding"}

Tool to find vertices (creates double-track conversions)

Definition at line 79 of file EMVertexBuilder.h.

79 {this,
80 "VertexFinderTool", "InDetConversionFinderTools",
81 "The tool that does the converions finding"};

◆ m_vhka

std::vector<SG::VarHandleKeyArray*> AthCommonDataStore< AthCommonMsg< Gaudi::Algorithm > >::m_vhka
privateinherited

Definition at line 398 of file AthCommonDataStore.h.


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