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

Class definition for the ZDC decoder class for Run 3 This class is responsible for taking the ZdcLucrodData and rendering them as ZdcModules for subsequent steps, and for defining the two output ZdcModuleContainers. More...

#include <ZdcRecRun3Decode.h>

Inheritance diagram for ZdcRecRun3Decode:
Collaboration diagram for ZdcRecRun3Decode:

Public Member Functions

 ZdcRecRun3Decode (const std::string &name, ISvcLocator *pSvcLocator)
 ~ZdcRecRun3Decode ()
StatusCode initialize () override
StatusCode execute () override
StatusCode finalize () override
virtual StatusCode sysInitialize () override
 Override sysInitialize.
virtual const DataObjIDColl & extraOutputDeps () const override
 Return the list of extra output dependencies.
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

int m_ownPolicy
Gaudi::Property< unsigned int > m_nFragments {this,"NFragments",6,"Number of expected LUCROD fragments"}
SG::ReadHandleKey< xAOD::EventInfom_eventInfoKey {this,"EventInfoKey","EventInfo"}
SG::WriteDecorHandleKey< xAOD::EventInfom_eventInfoDecorKey {this, "eventInfoDecorKey", m_eventInfoKey, "forwardDetFlags", "Key for EventInfo decoration object"}
SG::ReadHandleKey< ZdcLucrodDataContainerm_zldContainerName { this, "ZdcLucrodDataContainerKey", "ZdcLucrodDataContainer", "" }
SG::WriteHandleKey< xAOD::ZdcModuleContainerm_zdcModuleContainerName { this, "ZdcModuleContainerName", "ZdcModules", "" }
SG::WriteHandleKey< xAOD::ZdcModuleContainerm_zdcSumContainerName { this, "ZdcSumContainerName", "ZdcSums", "" }
ToolHandle< ZdcRecChannelToolLucrodm_ChannelTool { this, "ChannelTool", "ZdcRecChannelToolLucrod", "" }
DataObjIDColl m_extendedExtraObjects
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

Class definition for the ZDC decoder class for Run 3 This class is responsible for taking the ZdcLucrodData and rendering them as ZdcModules for subsequent steps, and for defining the two output ZdcModuleContainers.

Author
Brian Cole and Peter Steinberg, bcole.nosp@m.@cer.nosp@m.n.ch, stein.nosp@m.berg.nosp@m.@bnl..nosp@m.gov

Definition at line 42 of file ZdcRecRun3Decode.h.

Member Typedef Documentation

◆ StoreGateSvc_t

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

Definition at line 388 of file AthCommonDataStore.h.

Constructor & Destructor Documentation

◆ ZdcRecRun3Decode()

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

Definition at line 30 of file ZdcRecRun3Decode.cxx.

30 :
31
32 AthAlgorithm(name, pSvcLocator),
33 m_ownPolicy(static_cast<int> (SG::OWN_ELEMENTS))
34{
35 declareProperty("OwnPolicy",m_ownPolicy) ;
36}
AthAlgorithm()
Default constructor:
Gaudi::Details::PropertyBase & declareProperty(Gaudi::Property< T, V, H > &t)
@ OWN_ELEMENTS
this data object owns its elements

◆ ~ZdcRecRun3Decode()

ZdcRecRun3Decode::~ZdcRecRun3Decode ( )

Definition at line 41 of file ZdcRecRun3Decode.cxx.

41{}

Member Function Documentation

◆ declareGaudiProperty()

Gaudi::Details::PropertyBase & AthCommonDataStore< AthCommonMsg< 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 }

◆ declareProperty()

Gaudi::Details::PropertyBase & AthCommonDataStore< AthCommonMsg< 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< 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< 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 ZdcRecRun3Decode::execute ( )
override

Definition at line 73 of file ZdcRecRun3Decode.cxx.

74{
75
76 ATH_MSG_DEBUG("In ZdRecRun3");
77
78 const EventContext& ctx = Gaudi::Hive::currentContext();
79
80 ATH_MSG_DEBUG ("--> ZDC: ZdcRecRun3Decode execute starting on "
81 << ctx.evt()
82 << "th event");
83
84 //Look for the container presence
85 if (m_zldContainerName.empty()) {
86 return StatusCode::SUCCESS;
87 }
88
89 ATH_MSG_DEBUG("Trying to get LUCROD DATA!");
90 SG::ReadHandle<ZdcLucrodDataContainer> zldContainer (m_zldContainerName, ctx);
91 ATH_MSG_DEBUG("Did I get LUCROD DATA?");
92
93 if (zldContainer->size() < m_nFragments)
94 {
95 int zdcLucrod = 0;
96 int rpdLucrod = 0;
97 for (auto zld : *zldContainer)
98 {
99 uint32_t lucrod_id = zld->GetLucrodID();
100 if (lucrod_id == ZdcEventInfo::LucrodLowGain || lucrod_id == ZdcEventInfo::LucrodHighGain) // ZDC LUCRODs
101 {
102 zdcLucrod++;
103 }
104 else if (lucrod_id == ZdcEventInfo::LucrodRPD1A
105 || lucrod_id == ZdcEventInfo::LucrodRPD1C
106 || lucrod_id == ZdcEventInfo::LucrodRPD2A
107 || lucrod_id == ZdcEventInfo::LucrodRPD2C)
108 {
109 rpdLucrod++;
110 }
111 else
112 {
113 ATH_MSG_WARNING("Unidentified LUCROD ID = " << lucrod_id);
114 }
115 }
116 SG::ReadHandle<xAOD::EventInfo> eventInfo (m_eventInfoKey);
117 if (!eventInfo->updateErrorState(xAOD::EventInfo::ForwardDet,xAOD::EventInfo::Error))
118 {
119 ATH_MSG_WARNING( " cannot set EventInfo error state for ForwardDet " );
120 }
121 if (!eventInfo->updateEventFlagBit(xAOD::EventInfo::ForwardDet,ZdcEventInfo::DECODINGERROR))
122 {
123 ATH_MSG_WARNING( " cannot set flag bit for ForwardDet " );
124 }
125 if (rpdLucrod < ZdcEventInfo::nTotalRpdLucrod)
126 {
127 if (!eventInfo->updateEventFlagBit(xAOD::EventInfo::ForwardDet,ZdcEventInfo::RPDDECODINGERROR))
128 {
129 ATH_MSG_WARNING( " cannot set RPDDECODINGERROR flag bit for ForwardDet " );
130 }
131 }
132 if (zdcLucrod < ZdcEventInfo::nTotalZdcLucrod)
133 {
134 if (!eventInfo->updateEventFlagBit(xAOD::EventInfo::ForwardDet,ZdcEventInfo::ZDCDECODINGERROR))
135 {
136 ATH_MSG_WARNING( " cannot set ZDCDECODINGERROR flag bit for ForwardDet " );
137 }
138 }
139 }
140
141 //Create the containers to hold the reconstructed information (you just pass the pointer and the converter does the work)
142 std::unique_ptr<xAOD::ZdcModuleContainer> moduleContainer( new xAOD::ZdcModuleContainer());
143 std::unique_ptr<xAOD::ZdcModuleAuxContainer> moduleAuxContainer( new xAOD::ZdcModuleAuxContainer() );
144 moduleContainer->setStore( moduleAuxContainer.get() );
145
146 //Create the containers to hold the reconstructed information (you just pass the pointer and the converter does the work)
147 std::unique_ptr<xAOD::ZdcModuleContainer> moduleSumContainer( new xAOD::ZdcModuleContainer());
148 std::unique_ptr<xAOD::ZdcModuleAuxContainer> moduleSumAuxContainer( new xAOD::ZdcModuleAuxContainer() );
149 moduleSumContainer->setStore( moduleSumAuxContainer.get() );
150
151 ATH_MSG_DEBUG("Trying to convert!");
152
153 // rearrange ZDC channels and perform fast reco on all channels (including non-big tubes)
154 int ncha = m_ChannelTool->convertLucrod2ZM(zldContainer.get(), moduleContainer.get(), moduleSumContainer.get() );
155 ATH_MSG_DEBUG("m_ChannelTool->convertLucrod2ZM returned " << ncha << " channels");
156
157 ATH_MSG_DEBUG("Dumping modules");
158 ATH_MSG_DEBUG( ZdcModuleToString(*moduleContainer) );
159 ATH_MSG_DEBUG("Dumping module sums");
160 ATH_MSG_DEBUG( ZdcModuleToString(*moduleSumContainer) );
161
162 // eventually reconstruct RPD, using ML libraries
163 // ATH_CHECK( m_rpdTool...)
164
165 SG::WriteHandle<xAOD::ZdcModuleContainer> moduleContainerH (m_zdcModuleContainerName, ctx);
166 ATH_CHECK( moduleContainerH.record (std::move(moduleContainer),
167 std::move(moduleAuxContainer)) );
168
169 SG::WriteHandle<xAOD::ZdcModuleContainer> moduleSumContainerH (m_zdcSumContainerName, ctx);
170 ATH_CHECK( moduleSumContainerH.record (std::move(moduleSumContainer),
171 std::move(moduleSumAuxContainer)) );
172
173 return StatusCode::SUCCESS;
174
175}
#define ATH_CHECK
Evaluate an expression and check for errors.
#define ATH_MSG_WARNING(x)
#define ATH_MSG_DEBUG(x)
std::string ZdcModuleToString(const xAOD::ZdcModule &zm)
SG::ReadHandleKey< xAOD::EventInfo > m_eventInfoKey
SG::ReadHandleKey< ZdcLucrodDataContainer > m_zldContainerName
SG::WriteHandleKey< xAOD::ZdcModuleContainer > m_zdcSumContainerName
Gaudi::Property< unsigned int > m_nFragments
ToolHandle< ZdcRecChannelToolLucrod > m_ChannelTool
SG::WriteHandleKey< xAOD::ZdcModuleContainer > m_zdcModuleContainerName
@ ForwardDet
The forward detectors.
@ Error
The sub-detector issued an error.
ZdcModuleContainer_v1 ZdcModuleContainer
setEventNumber uint32_t
ZdcModuleAuxContainer_v2 ZdcModuleAuxContainer

◆ extraDeps_update_handler()

void AthCommonDataStore< AthCommonMsg< 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 & AthAlgorithm::extraOutputDeps ( ) const
overridevirtualinherited

Return the list of extra output dependencies.

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

Definition at line 50 of file AthAlgorithm.cxx.

51{
52 // If we didn't find any symlinks to add, just return the collection
53 // from the base class. Otherwise, return the extended collection.
54 if (!m_extendedExtraObjects.empty()) {
56 }
57 return Algorithm::extraOutputDeps();
58}
DataObjIDColl m_extendedExtraObjects

◆ finalize()

StatusCode ZdcRecRun3Decode::finalize ( )
override

Definition at line 179 of file ZdcRecRun3Decode.cxx.

180{
181
182 ATH_MSG_DEBUG( "--> ZDC: ZdcRecRun3Decode finalize complete" );
183
184 return StatusCode::SUCCESS;
185
186}

◆ initialize()

StatusCode ZdcRecRun3Decode::initialize ( )
override

Definition at line 45 of file ZdcRecRun3Decode.cxx.

46{
47 MsgStream mLog(msgSvc(), name());
48
49 // Reconstruction Tool
50 ATH_CHECK( m_ChannelTool.retrieve() );
51
52 // Reconstruction Tool
53
54 ATH_CHECK( m_zdcModuleContainerName.initialize() );
55 ATH_CHECK( m_zdcSumContainerName.initialize() );
57 ATH_CHECK( m_eventInfoKey.initialize() );
58 ATH_CHECK( m_eventInfoDecorKey.initialize() );
59
61 mLog << MSG::DEBUG << "...will OWN its cells." << endmsg;
62 else
63 mLog << MSG::DEBUG << "...will VIEW its cells." << endmsg;
64
65
66 mLog << MSG::DEBUG << "--> ZDC: ZdcRecRun3Decode initialization complete" << endmsg;
67
68 return StatusCode::SUCCESS;
69}
#define endmsg
SG::WriteDecorHandleKey< xAOD::EventInfo > m_eventInfoDecorKey
msgSvc
Provide convenience handles for various services.
Definition StdJOSetup.py:36

◆ inputHandles()

virtual std::vector< Gaudi::DataHandle * > AthCommonDataStore< AthCommonMsg< 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.

◆ msg()

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

Definition at line 24 of file AthCommonMsg.h.

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

◆ msgLvl()

bool AthCommonMsg< 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< 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< 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< Algorithm > >::renounceArray ( SG::VarHandleKeyArray & handlesArray)
inlineprotectedinherited

remove all handles from I/O resolution

Definition at line 364 of file AthCommonDataStore.h.

364 {
366 }

◆ sysInitialize()

StatusCode AthAlgorithm::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< Algorithm > >.

Reimplemented in AthAnalysisAlgorithm, AthFilterAlgorithm, AthHistogramAlgorithm, and PyAthena::Alg.

Definition at line 66 of file AthAlgorithm.cxx.

66 {
68
69 if (sc.isFailure()) {
70 return sc;
71 }
72 ServiceHandle<ICondSvc> cs("CondSvc",name());
73 for (auto h : outputHandles()) {
74 if (h->isCondition() && h->mode() == Gaudi::DataHandle::Writer) {
75 // do this inside the loop so we don't create the CondSvc until needed
76 if ( cs.retrieve().isFailure() ) {
77 ATH_MSG_WARNING("no CondSvc found: won't autoreg WriteCondHandles");
78 return StatusCode::SUCCESS;
79 }
80 if (cs->regHandle(this,*h).isFailure()) {
81 sc = StatusCode::FAILURE;
82 ATH_MSG_ERROR("unable to register WriteCondHandle " << h->fullKey()
83 << " with CondSvc");
84 }
85 }
86 }
87 return sc;
88}
#define ATH_MSG_ERROR(x)
static Double_t sc
virtual StatusCode sysInitialize() override
Override sysInitialize.
AthCommonDataStore(const std::string &name, T... args)
virtual std::vector< Gaudi::DataHandle * > outputHandles() const override
::StatusCode StatusCode
StatusCode definition for legacy code.

◆ sysStart()

virtual StatusCode AthCommonDataStore< AthCommonMsg< 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< 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 }
std::vector< SG::VarHandleKeyArray * > m_vhka

Member Data Documentation

◆ m_ChannelTool

ToolHandle<ZdcRecChannelToolLucrod> ZdcRecRun3Decode::m_ChannelTool { this, "ChannelTool", "ZdcRecChannelToolLucrod", "" }
private

Definition at line 71 of file ZdcRecRun3Decode.h.

72{ this, "ChannelTool", "ZdcRecChannelToolLucrod", "" };

◆ m_detStore

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

Pointer to StoreGate (detector store by default)

Definition at line 393 of file AthCommonDataStore.h.

◆ m_eventInfoDecorKey

SG::WriteDecorHandleKey<xAOD::EventInfo> ZdcRecRun3Decode::m_eventInfoDecorKey {this, "eventInfoDecorKey", m_eventInfoKey, "forwardDetFlags", "Key for EventInfo decoration object"}
private

Definition at line 60 of file ZdcRecRun3Decode.h.

60{this, "eventInfoDecorKey", m_eventInfoKey, "forwardDetFlags", "Key for EventInfo decoration object"};

◆ m_eventInfoKey

SG::ReadHandleKey<xAOD::EventInfo> ZdcRecRun3Decode::m_eventInfoKey {this,"EventInfoKey","EventInfo"}
private

Definition at line 59 of file ZdcRecRun3Decode.h.

59{this,"EventInfoKey","EventInfo"};

◆ m_evtStore

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

Pointer to StoreGate (event store by default)

Definition at line 390 of file AthCommonDataStore.h.

◆ m_extendedExtraObjects

DataObjIDColl AthAlgorithm::m_extendedExtraObjects
privateinherited

Definition at line 79 of file AthAlgorithm.h.

◆ m_nFragments

Gaudi::Property<unsigned int> ZdcRecRun3Decode::m_nFragments {this,"NFragments",6,"Number of expected LUCROD fragments"}
private

Definition at line 57 of file ZdcRecRun3Decode.h.

57{this,"NFragments",6,"Number of expected LUCROD fragments"};

◆ m_ownPolicy

int ZdcRecRun3Decode::m_ownPolicy
private

Definition at line 56 of file ZdcRecRun3Decode.h.

◆ m_varHandleArraysDeclared

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

Definition at line 399 of file AthCommonDataStore.h.

◆ m_vhka

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

Definition at line 398 of file AthCommonDataStore.h.

◆ m_zdcModuleContainerName

SG::WriteHandleKey<xAOD::ZdcModuleContainer> ZdcRecRun3Decode::m_zdcModuleContainerName { this, "ZdcModuleContainerName", "ZdcModules", "" }
private

Definition at line 65 of file ZdcRecRun3Decode.h.

66{ this, "ZdcModuleContainerName", "ZdcModules", "" };

◆ m_zdcSumContainerName

SG::WriteHandleKey<xAOD::ZdcModuleContainer> ZdcRecRun3Decode::m_zdcSumContainerName { this, "ZdcSumContainerName", "ZdcSums", "" }
private

Definition at line 68 of file ZdcRecRun3Decode.h.

69{ this, "ZdcSumContainerName", "ZdcSums", "" };

◆ m_zldContainerName

SG::ReadHandleKey<ZdcLucrodDataContainer> ZdcRecRun3Decode::m_zldContainerName { this, "ZdcLucrodDataContainerKey", "ZdcLucrodDataContainer", "" }
private

Definition at line 62 of file ZdcRecRun3Decode.h.

63{ this, "ZdcLucrodDataContainerKey", "ZdcLucrodDataContainer", "" };

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