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

Applies GNN-based (Triton-served) energy calibration to calorimeter clusters and stores the result as a decoration [MeV]. More...

#include <CaloClusterTritonAlg.h>

Inheritance diagram for CaloClusterTritonAlg:
Collaboration diagram for CaloClusterTritonAlg:

Public Member Functions

 CaloClusterTritonAlg (const std::string &name, ISvcLocator *pSvcLocator)
 ~CaloClusterTritonAlg () override=default
StatusCode initialize () override
StatusCode execute (const EventContext &ctx) const override
StatusCode finalize () override
virtual StatusCode sysInitialize () override
 Override sysInitialize.
virtual bool isClonable () const override
 Specify if the algorithm is clonable.
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
 Get filter decision:
virtual void setFilterPassed (bool state, const EventContext &ctx) const
 Set filter decision:
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< StoreGateSvc > StoreGateSvc_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

ToolHandle< ICaloClusterTritonTool > m_calibTool
SG::ReadHandleKey< xAOD::CaloClusterContainer > m_clusterContainerKey
SG::ReadHandleKey< CaloCellContainer > m_cellContainerKey
SG::WriteDecorHandleKey< xAOD::CaloClusterContainer > m_clusterGNNCalibEnergyDecorKey
Gaudi::Property< std::vector< float > > m_rapidityRange
Gaudi::Property< double > m_minClusterEnergy
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

Applies GNN-based (Triton-served) energy calibration to calorimeter clusters and stores the result as a decoration [MeV].

Clusters outside the rapidity range or below the minimum raw energy are decorated with their raw (EM-scale) energy.

Definition at line 26 of file CaloClusterTritonAlg.h.

Member Typedef Documentation

◆ StoreGateSvc_t

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

Definition at line 376 of file AthCommonDataStore.h.

Constructor & Destructor Documentation

◆ CaloClusterTritonAlg()

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

Definition at line 10 of file CaloClusterTritonAlg.cxx.

11 : AthReentrantAlgorithm(name, pSvcLocator)
12{
13}

◆ ~CaloClusterTritonAlg()

CaloClusterTritonAlg::~CaloClusterTritonAlg ( )
overridedefault

Member Function Documentation

◆ 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 CaloClusterTritonAlg::execute ( const EventContext & ctx) const
override

Definition at line 39 of file CaloClusterTritonAlg.cxx.

40{
41 ATH_MSG_DEBUG("Executing " << name() << "...");
42
43 SG::WriteDecorHandle<xAOD::CaloClusterContainer, double> clusterGNNCalibEnergyDecor(m_clusterGNNCalibEnergyDecorKey, ctx);
44
45 SG::ReadHandle<xAOD::CaloClusterContainer> clusterReadHandle(m_clusterContainerKey, ctx);
46 if (!clusterReadHandle.isValid())
47 {
48 ATH_MSG_ERROR("cannot allocate the input cluster container with key <" << m_clusterContainerKey.key() << ">");
49 return StatusCode::FAILURE;
50 }
51
52 SG::ReadHandle<CaloCellContainer> cellReadHandle(m_cellContainerKey, ctx);
53 if (!cellReadHandle.isValid())
54 {
55 ATH_MSG_ERROR("cannot retrieve the cell container with key <" << m_cellContainerKey.key()
56 << ">; the GNN needs the cells referenced by the cluster cell links");
57 return StatusCode::FAILURE;
58 }
59
60 // only run inference for clusters passing cuts
61 ConstDataVector<xAOD::CaloClusterContainer> selectedClusters(SG::VIEW_ELEMENTS);
62 std::vector<bool> clusterMask(clusterReadHandle->size(), false);
63 for (const xAOD::CaloCluster *cluster : *clusterReadHandle) {
64 if (m_rapidityRange.size() == 2) {
65 const double eta = cluster->eta(xAOD::CaloCluster::UNCALIBRATED);
66 if (eta < m_rapidityRange[0] || eta > m_rapidityRange[1]) continue;
67 }
68 // minimum cluster energy cut; in MeV
69 if (cluster->rawE() < m_minClusterEnergy) continue;
70
71 selectedClusters.push_back(cluster);
72 clusterMask.at(cluster->index()) = true;
73 }
74
75 std::vector<double> clusterE_GNN_vec;
76 ATH_CHECK(m_calibTool->inference(*selectedClusters.asDataVector(), clusterE_GNN_vec));
77
78 if (clusterE_GNN_vec.size() != selectedClusters.size()) {
79 ATH_MSG_ERROR("Tool returned " << clusterE_GNN_vec.size() << " energies for "
80 << selectedClusters.size() << " selected clusters");
81 return StatusCode::FAILURE;
82 }
83
84 size_t i = 0;
85 for (const xAOD::CaloCluster *cluster : *clusterReadHandle)
86 {
87 if (clusterMask.at(cluster->index())) {
88 clusterGNNCalibEnergyDecor(*cluster) = clusterE_GNN_vec[i];
89 ++i;
90 } else {
91 clusterGNNCalibEnergyDecor(*cluster) = cluster->rawE();
92 }
93 }
94
95 return StatusCode::SUCCESS;
96}
Scalar eta() const
pseudorapidity method
#define ATH_CHECK
Evaluate an expression and check for errors.
#define ATH_MSG_DEBUG(x,...)
#define ATH_MSG_ERROR(x,...)
Gaudi::Property< std::vector< float > > m_rapidityRange
SG::WriteDecorHandleKey< xAOD::CaloClusterContainer > m_clusterGNNCalibEnergyDecorKey
SG::ReadHandleKey< xAOD::CaloClusterContainer > m_clusterContainerKey
SG::ReadHandleKey< CaloCellContainer > m_cellContainerKey
Gaudi::Property< double > m_minClusterEnergy
ToolHandle< ICaloClusterTritonTool > m_calibTool
@ VIEW_ELEMENTS
this data object is a view, it does not own its elmts
CaloCluster_v1 CaloCluster
Define the latest version of the calorimeter cluster 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 & AthCommonAlgorithm< 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 89 of file AthCommonAlgorithm.cxx.

54{
55 // If we didn't find any symlinks to add, just return the collection
56 // from the base class. Otherwise, return the extended collection.
57 if (!m_extendedExtraObjects.empty()) {
59 }
61}
Common base class for algorithms.

◆ filterPassed()

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

Get filter decision:

Definition at line 93 of file AthCommonAlgorithm.h.

93 {
94 return execState( ctx ).filterPassed();
95 }
virtual bool filterPassed(const EventContext &ctx) const
Get filter decision:

◆ finalize()

StatusCode CaloClusterTritonAlg::finalize ( )
override

Definition at line 33 of file CaloClusterTritonAlg.cxx.

34{
35 ATH_MSG_INFO("Finalizing " << name() << "...");
36 return StatusCode::SUCCESS;
37}
#define ATH_MSG_INFO(x,...)

◆ initialize()

StatusCode CaloClusterTritonAlg::initialize ( )
override

Definition at line 15 of file CaloClusterTritonAlg.cxx.

16{
17 ATH_MSG_INFO("Initializing " << name() << "...");
18
19 ATH_CHECK(m_calibTool.retrieve());
20 ATH_CHECK(m_clusterContainerKey.initialize());
21 ATH_CHECK(m_cellContainerKey.initialize());
23
24 if (m_rapidityRange.size() == 2) {
25 ATH_MSG_INFO("GNN calibration will be applied for clusters within ["
26 << m_rapidityRange[0] << "," << m_rapidityRange[1] << "]");
27 }
28 ATH_MSG_INFO("GNN calibration will be applied to clusters with energy >= " << m_minClusterEnergy << " MeV");
29
30 return StatusCode::SUCCESS;
31}

◆ 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()

virtual bool AthCommonAlgorithm< Gaudi::Algorithm >::isClonable ( ) const
inlineoverridevirtualinherited

Specify if the algorithm is clonable.

Only relevant for non-reentrant algorithms. Actual number of clones needs to be set via the "Cardinality" property.

Reimplemented in AFP_DigiTop, AlgB, AlgT, BCM_Digitization, CscDigitBuilder, CscDigitToCscRDO, G4AtlasAlg, G4RunAlg, HGTD_Digitization, HiveAlgBase, InDet::GNNSeedingTrackMaker, InDet::SCT_Clusterization, InDet::SiSPGNNTrackMaker, InDet::SiSPSeededTrackFinder, InDet::SiTrackerSpacePointFinder, ISF::SimKernelMT, ITk::StripDigitization, ITkPixelCablingAlg, ITkStripCablingAlg, LArHitEMapMaker, LArTTL1Maker, LUCID_DigiTop, LVL1::L1TopoSimulation, MergeCalibHits, MergeGenericMuonSimHitColl, MergeHijingPars, MergeMcEventCollection, MergeTrackRecordCollection, MergeTruthJets, MergeTruthParticles, MuonDigitizer, PileUpMTAlg, PixelDigitization, RoIBResultToxAOD, SCT_ByteStreamErrorsTestAlg, SCT_CablingCondAlgFromCoraCool, SCT_CablingCondAlgFromText, SCT_ConditionsParameterTestAlg, SCT_ConditionsSummaryTestAlg, SCT_ConfigurationConditionsTestAlg, SCT_Digitization, SCT_FlaggedConditionTestAlg, SCT_LinkMaskingTestAlg, SCT_MajorityConditionsTestAlg, SCT_ModuleVetoTestAlg, SCT_MonitorConditionsTestAlg, SCT_PrepDataToxAOD, SCT_RawDataToxAOD, SCT_ReadCalibChipDataTestAlg, SCT_ReadCalibDataTestAlg, SCT_RODVetoTestAlg, SCT_SensorsTestAlg, SCT_SiliconConditionsTestAlg, SCT_StripVetoTestAlg, SCT_TdaqEnabledTestAlg, SCT_TestCablingAlg, SCTEventFlagWriter, SCTRawDataProvider, SCTSiLorentzAngleTestAlg, SCTSiPropertiesTestAlg, SGInputLoader, Simulation::BeamEffectsAlg, TileHitVecToCnt, TileMuonFitter, TilePulseForTileMuonReceiver, TileRawChannelMaker, TRTDigitization, and ZDC_DigiTop.

Definition at line 68 of file AthCommonAlgorithm.h.

68 {
69 return true;
70 }

◆ 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 368 of file AthCommonDataStore.h.

369 {
370 h.renounce();
372 }
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 352 of file AthCommonDataStore.h.

352 {
354 }

◆ setFilterPassed()

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

Set filter decision:

Definition at line 99 of file AthCommonAlgorithm.h.

99 {
101 }
virtual void setFilterPassed(bool state, const EventContext &ctx) const
Set filter decision:

◆ sysExecute()

StatusCode AthCommonAlgorithm< 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.

Reimplemented in AthAnalysisAlgorithm.

Definition at line 80 of file AthCommonAlgorithm.cxx.

41{
42 return BaseAlg::sysExecute (ctx);
43}

◆ sysInitialize()

StatusCode AthCommonAlgorithm< 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 AthAnalysisAlgorithm, AthHistogramAlgorithm, HypoBase, InputMakerBase, and PyAthena::Alg.

Definition at line 60 of file AthCommonAlgorithm.cxx.

71 {
73
74 if (sc.isFailure()) {
75 return sc;
76 }
77
78 ServiceHandle<ICondSvc> cs("CondSvc",name());
79 for (auto h : outputHandles()) {
80 if (h->isCondition() && h->mode() == Gaudi::DataHandle::Writer) {
81 // do this inside the loop so we don't create the CondSvc until needed
82 if ( cs.retrieve().isFailure() ) {
83 ATH_MSG_WARNING("no CondSvc found: won't autoreg WriteCondHandles");
85 }
86 if (cs->regHandle(this,*h).isFailure()) {
88 ATH_MSG_ERROR("unable to register WriteCondHandle " << h->fullKey()
89 << " with CondSvc");
90 }
91 }
92 }
93 return sc;
94}
#define ATH_MSG_WARNING(x,...)
virtual StatusCode sysInitialize() override
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 298 of file AthCommonDataStore.h.

298 {
299 for (auto &a : m_vhka) {
301 for (auto k : keys) {
302 k->setOwner(this);
303 }
304 }
305 }

Member Data Documentation

◆ m_calibTool

ToolHandle<ICaloClusterTritonTool> CaloClusterTritonAlg::m_calibTool
private
Initial value:
{
this, "CaloClusterTritonTool", "CaloClusterTritonTool"}

Definition at line 36 of file CaloClusterTritonAlg.h.

36 {
37 this, "CaloClusterTritonTool", "CaloClusterTritonTool"};

◆ m_cellContainerKey

SG::ReadHandleKey<CaloCellContainer> CaloClusterTritonAlg::m_cellContainerKey
private
Initial value:
{
this, "CellContainer", "AllCalo", "Cell container referenced by the cluster cell links"}

Definition at line 44 of file CaloClusterTritonAlg.h.

44 {
45 this, "CellContainer", "AllCalo", "Cell container referenced by the cluster cell links"};

◆ m_clusterContainerKey

SG::ReadHandleKey<xAOD::CaloClusterContainer> CaloClusterTritonAlg::m_clusterContainerKey
private
Initial value:
{
this, "ClusterContainer", "CaloCalTopoClusters", "Cluster container key"}

Definition at line 39 of file CaloClusterTritonAlg.h.

39 {
40 this, "ClusterContainer", "CaloCalTopoClusters", "Cluster container key"};

◆ m_clusterGNNCalibEnergyDecorKey

SG::WriteDecorHandleKey<xAOD::CaloClusterContainer> CaloClusterTritonAlg::m_clusterGNNCalibEnergyDecorKey
private
Initial value:
{
this, "ClusterGNNCalibratedEnergyKeyName", "CaloCalTopoClusters.GNNCalibratedEnergy",
"GNN calibrated cluster energy decoration"}

Definition at line 47 of file CaloClusterTritonAlg.h.

47 {
48 this, "ClusterGNNCalibratedEnergyKeyName", "CaloCalTopoClusters.GNNCalibratedEnergy",
49 "GNN calibrated cluster energy decoration"};

◆ m_detStore

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

Pointer to StoreGate (detector store by default).

Definition at line 381 of file AthCommonDataStore.h.

◆ m_evtStore

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

Pointer to StoreGate (event store by default).

Definition at line 378 of file AthCommonDataStore.h.

◆ m_extendedExtraObjects

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

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

Empty if no symlinks were found.

Definition at line 108 of file AthCommonAlgorithm.h.

◆ m_minClusterEnergy

Gaudi::Property<double> CaloClusterTritonAlg::m_minClusterEnergy
private
Initial value:
{
this, "MinClusterEnergy", 300.0, "Minimum cluster energy (MeV) to apply GNN calibration"}

Definition at line 55 of file CaloClusterTritonAlg.h.

55 {
56 this, "MinClusterEnergy", 300.0, "Minimum cluster energy (MeV) to apply GNN calibration"};

◆ m_rapidityRange

Gaudi::Property<std::vector<float> > CaloClusterTritonAlg::m_rapidityRange
private
Initial value:
{
this, "RapidityRange", {-2.5, 2.5}, "Rapidity range of validity of the GNN calibration"}

Definition at line 51 of file CaloClusterTritonAlg.h.

51 {
52 this, "RapidityRange", {-2.5, 2.5}, "Rapidity range of validity of the GNN calibration"};

◆ m_varHandleArraysDeclared

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

Definition at line 387 of file AthCommonDataStore.h.

◆ m_vhka

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

Definition at line 386 of file AthCommonDataStore.h.


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