ATLAS Offline Software
Classes | Public Types | Public Member Functions | Static Public Attributes | Protected Types | Protected Member Functions | Protected Attributes | Private Member Functions | Private Attributes | Friends | List of all members
xAOD::Event Class Referenceabstract

Base class for the event (xAOD::TEvent and xAOD::REvent) classes. More...

#include <Event.h>

Inheritance diagram for xAOD::Event:
Collaboration diagram for xAOD::Event:

Classes

struct  BranchInfo
 Helper struct used by the IProxyDict code. More...
 

Public Types

using sgkey_t = SG::sgkey_t
 

Public Member Functions

 Event (std::string_view name)
 Constructor with a name. More...
 
virtual ~Event ()
 Virtual destructor. More...
 
template<typename T >
bool retrieve (const T *&obj, sgkey_t key=DEFAULT_KEY, bool silent=false)
 Function retrieving an object from the event (constant version) More...
 
template<typename T >
bool retrieve (const T *&obj, const std::string &key, bool silent=false)
 Function retrieving an object from the event (constant version) More...
 
void setLevel (MSG::Level lvl)
 Change the current logging level. More...
 

Static Public Attributes

static constexpr sgkey_t DEFAULT_KEY = ~static_cast<sgkey_t>(0)
 Key for retrieving the "default" object of a given type. More...
 
static constexpr sgkey_t KEY_MASK = DEFAULT_KEY >> 2
 Mask for the keys, used mostly internally. More...
 

Protected Types

using Object_t = std::unordered_map< std::string, std::unique_ptr< TVirtualManager > >
 Definition of the internal data structure type. More...
 

Protected Member Functions

StatusCode recordTypeless (void *obj, const std::string &typeName, const std::string &key, bool overwrite=false, bool metadata=true, bool isOwner=true)
 Internal function for recording an object into the output. More...
 
void * getOutputObject (const std::string &key, const std::type_info &ti, bool metadata) const
 Function for retrieving an output object in a non-template way. More...
 
const void * getInputObject (const std::string &key, const std::type_info &ti, bool silent, bool metadata)
 Function for retrieving an input object in a non-template way. More...
 
bool contains (const std::string &key, const std::type_info &ti, bool metadata)
 Internal function checking if an object is in the input. More...
 
bool transientContains (const std::string &key, const std::type_info &ti, bool metadata) const
 Internal function checking if an object is already in memory. More...
 
Functions to be implemented by the derived types
virtual bool hasInput () const =0
 Check if an input file is connected to the object. More...
 
virtual bool hasOutput () const =0
 Check if an output file is connected to the object. More...
 
virtual StatusCode getNames (const std::string &targetClassName, std::vector< std::string > &vkeys, bool metadata=false) const =0
 Function determining the list keys associated with a type name. More...
 
virtual StatusCode connectObject (const std::string &key, bool silent)=0
 Function setting up access to a particular object. More...
 
virtual StatusCode connectMetaObject (const std::string &key, bool silent)=0
 Function setting up access to a particular metadata object. More...
 
virtual StatusCode connectAux (const std::string &prefix, bool standalone)=0
 Function setting up access to a set of auxiliary branches. More...
 
virtual StatusCode connectMetaAux (const std::string &prefix, bool standalone)=0
 Function setting up access to a set of auxiliary branches for a metadata object. More...
 
virtual StatusCode setAuxStore (const std::string &key, Details::IObjectManager &mgr, bool metadata)=0
 Function connecting a DV object to its auxiliary store. More...
 
virtual StatusCode record (void *obj, const std::string &typeName, const std::string &key, bool overwrite, bool metadata, bool isOwner)=0
 Record an object into a connected output file. More...
 
virtual StatusCode recordAux (TVirtualManager &mgr, const std::string &key, bool metadata)=0
 Record an auxiliary store into a connected output file. More...
 

Protected Attributes

Object_t m_inputObjects
 Collection of all the managed input objects. More...
 
std::set< std::string > m_inputMissingObjects
 Objects that have been asked for, but were found to be missing in the current input. More...
 
Object_t m_outputObjects
 Collection of all the managed output object. More...
 
Object_t m_inputMetaObjects
 Collection of all the managed input meta-objects. More...
 
Object_t m_outputMetaObjects
 Collection of all the managed output meta-objects. More...
 
EventFormat m_inputEventFormat
 Format of the current input file. More...
 
EventFormatm_outputEventFormat = nullptr
 Format of the current output file. More...
 
std::unordered_map< std::string, std::set< std::string > > m_auxItemList
 Rules for selecting which auxiliary branches to write. More...
 
std::set< TVirtualIncidentListener * > m_listeners
 Listeners who should be notified when certain incidents happen. More...
 
std::unordered_map< std::string, std::string > m_nameRemapping
 Container name re-mapping rules. More...
 
bool m_printEventProxyWarnings = false
 Option to silence common warnings that seem to be harmless. More...
 

Private Member Functions

void initMessaging () const
 Initialize our message level and MessageSvc. More...
 

Private Attributes

std::string m_nm
 Message source name. More...
 
boost::thread_specific_ptr< MsgStream > m_msg_tls
 MsgStream instance (a std::cout like with print-out levels) More...
 
std::atomic< IMessageSvc * > m_imsg { nullptr }
 MessageSvc pointer. More...
 
std::atomic< MSG::Level > m_lvl { MSG::NIL }
 Current logging level. More...
 

Friends

class xAODPrivate::HolderBucket
 
class xAODPrivate::Loader
 

Functions implementing the @c xAOD::TVirtualEvent interface

SG::sgkey_t getHash (const std::string &key) const override
 Function returning the hash describing an object name. More...
 
SG::sgkey_t getKey (const void *obj) const override
 Function returning the hash describing a known object. More...
 
const std::string & getName (const void *obj) const override
 Function returning the key describing a known object. More...
 
const std::string & getName (SG::sgkey_t hash) const override
 Function returning the key describing a known object. More...
 
void * getOutputObject (SG::sgkey_t key, const std::type_info &ti) override
 Function for retrieving an output object in a non-template way. More...
 
const void * getInputObject (SG::sgkey_t key, const std::type_info &ti, bool silent) override
 Function for retrieving an input object in a non-template way. More...
 

Variable(s) used in the @c IProxyDict implementation

using upgrade_mutex_t = AthContainers_detail::upgrade_mutex
 Mutex type for multithread synchronization. More...
 
using upgrading_lock_t = AthContainers_detail::upgrading_lock< upgrade_mutex_t >
 Lock type for multithread synchronization. More...
 
upgrade_mutex_t m_branchesMutex
 Mutex for multithread synchronization. More...
 
SG::SGKeyMap< BranchInfo > m_branches ATLAS_THREAD_SAFE
 Map from hashed sgkey to BranchInfo. More...
 

Detailed Description

Base class for the event (xAOD::TEvent and xAOD::REvent) classes.

It implements all the common functionality used by the different storage technologies. Leaving just the technology specific parts to the derived classes.

Definition at line 57 of file Event.h.

Member Typedef Documentation

◆ Object_t

using xAOD::Event::Object_t = std::unordered_map<std::string, std::unique_ptr<TVirtualManager> >
protected

Definition of the internal data structure type.

Definition at line 304 of file Event.h.

◆ sgkey_t

Definition at line 29 of file TVirtualEvent.h.

◆ upgrade_mutex_t

using xAOD::Event::upgrade_mutex_t = AthContainers_detail::upgrade_mutex
protected

Mutex type for multithread synchronization.

Definition at line 349 of file Event.h.

◆ upgrading_lock_t

Lock type for multithread synchronization.

Definition at line 351 of file Event.h.

Constructor & Destructor Documentation

◆ Event()

Event::Event ( std::string_view  name)

Constructor with a name.

Parameters
nameName to use in printed messages

Definition at line 27 of file EventCore.cxx.

28  : TVirtualEvent(),
30  asg::AsgMessaging(std::string{name}) {
31 
32  // Make sure that the I/O monitoring is active.
34 
35  // Make this the active event.
36  setActive();
37 }

◆ ~Event()

Event::~Event ( )
virtual

Virtual destructor.

Definition at line 39 of file EventCore.cxx.

39  {
40 
41  // If this is set up as the active event at the moment, notify
42  // the active event object that this object will no longer be
43  // available.
44  if (TActiveEvent::event() == this) {
45  TActiveEvent::setEvent(nullptr);
46  }
47 #ifndef XAOD_STANDALONE
48  if (SG::CurrentEventStore::store() == this) {
50  }
51 #endif // not XAOD_STANDALONE
52 }

Member Function Documentation

◆ addListener()

StatusCode Event::addListener ( TVirtualIncidentListener listener)

Register an incident listener object.

This function works pretty much like IIncidentSvc::addListener does in Athena.

It tells the TEvent object that when certain "interesting incidents" happen, a given object should be notified about it.

Parameters
listenerPointer to the object that should be notified
Returns
The usual StatusCode types

Definition at line 97 of file EventCore.cxx.

97  {
98 
99  // Check that we received a valid pointer:
100  if (listener == nullptr) {
101  ATH_MSG_ERROR("Received a null pointer for the listener");
102  return StatusCode::FAILURE;
103  }
104 
105  // Add the listener.
106  if (m_listeners.insert(listener).second == false) {
107  ATH_MSG_WARNING("Listener " << static_cast<void*>(listener)
108  << " was added previously already");
109  }
110 
111  // Return gracefully:
112  return StatusCode::SUCCESS;
113 }

◆ addNameRemap()

StatusCode Event::addNameRemap ( const std::string &  onfile,
const std::string &  newName 
)

Add a name re-mapping rule.

The names of containers can change during the lifetime of the experiment.

One such change happened after the DC14 exercise, when many containers got a new name. (Like "ElectronCollection" became simply "Electrons".)

This function allows us to create aliases with which certain containers should be accessible. So that the analyser would be able to access older files, while using the latest container name(s).

Parameters
onfileThe name of the container as it was saved into the input file
newNameThe alias with which the object/container should be accessible
Returns
The usual StatusCode types

Save the new name association:

Definition at line 155 of file EventCore.cxx.

156  {
157 
158  // Check if this name is known on the input or output already. As that's
159  // not good.
161  ATH_MSG_ERROR("Can't use \"" << newName << "\" as the target name in the \""
162  << onfile << "\" -> \"" << newName
163  << "\" remapping");
164  return StatusCode::FAILURE;
165  }
166 
167  // Check if this name was remapped to something already.
168  auto itr = m_nameRemapping.find(newName);
169  if (itr != m_nameRemapping.end()) {
170  ATH_MSG_WARNING("Overriding existing name remapping \""
171  << itr->second << "\" -> \"" << itr->first << "\" with: \""
172  << onfile << "\" -> \"" << newName << "\"");
173  }
174 
176  m_nameRemapping[newName] = onfile;
177 
178  // Return gracefully:
179  return StatusCode::SUCCESS;
180 }

◆ addToStore()

StatusCode Event::addToStore ( CLID  clid,
SG::DataProxy proxy 
)
overrideprotected

Add a new proxy to the store.

Smart pointers to objects that don't exist in the input event, can end up calling this function.

In this case warn the user that something fishy is happening, and take posession of the received proxy.

Parameters
clidThe CLID of the type. Not taken into account.
proxyThe proxy to take posession of. Not used for anything useful.

Definition at line 249 of file EventIProxyDict.cxx.

249  {
250 
252 
253  // Warn the user that the function got called:
254  static std::atomic_flag warningPrinted ATLAS_THREAD_SAFE = ATOMIC_FLAG_INIT;
255  if (!warningPrinted.test_and_set() && m_printEventProxyWarnings) {
257  "Function should only be called through an invalid ElementLink");
258  }
259 
260  // Hold on to the proxy with some non-existent, hopefully unique key:
261  const ::TString uniqueKey =
262  ::TString::Format("NonExistentKey_%lu", m_branches.size());
263  BranchInfo bi;
264  bi.m_proxy.reset(proxy);
265  lock.upgrade();
266  m_branches.insert(
267  std::make_pair(stringToKey(uniqueKey.Data(), clid), std::move(bi)));
268 
269  // Return gracefully:
270  return StatusCode::SUCCESS;
271 }

◆ clearListeners()

void Event::clearListeners ( )

Remove all listeners from the object.

This function can be used to remove all the listeners from the internal list.

Should not be necessary under regular circumstances.

Definition at line 136 of file EventCore.cxx.

136  {
137 
138  m_listeners.clear();
139 }

◆ clearNameRemap()

void Event::clearNameRemap ( )

Clear the current name re-mapping.

This function simply clears out any existing name remapping declarations.

In case the remapping rules need to be changed in the code in some complicated way.

Definition at line 186 of file EventCore.cxx.

186  {
187 
188  m_nameRemapping.clear();
189 }

◆ connectAux()

virtual StatusCode xAOD::Event::connectAux ( const std::string &  prefix,
bool  standalone 
)
protectedpure virtual

Function setting up access to a set of auxiliary branches.

Implemented in xAOD::Experimental::REvent.

◆ connectMetaAux()

virtual StatusCode xAOD::Event::connectMetaAux ( const std::string &  prefix,
bool  standalone 
)
protectedpure virtual

Function setting up access to a set of auxiliary branches for a metadata object.

Implemented in xAOD::Experimental::REvent.

◆ connectMetaObject()

virtual StatusCode xAOD::Event::connectMetaObject ( const std::string &  key,
bool  silent 
)
protectedpure virtual

Function setting up access to a particular metadata object.

Implemented in xAOD::Experimental::REvent.

◆ connectObject()

virtual StatusCode xAOD::Event::connectObject ( const std::string &  key,
bool  silent 
)
protectedpure virtual

Function setting up access to a particular object.

Implemented in xAOD::Experimental::REvent.

◆ contains() [1/2]

template<typename T >
bool xAOD::Event::contains ( const std::string &  key)

Function checking if an object is available from the store.

◆ contains() [2/2]

bool xAOD::Event::contains ( const std::string &  key,
const std::type_info &  ti,
bool  metadata 
)
protected

Internal function checking if an object is in the input.

◆ containsMeta()

template<typename T >
bool xAOD::Event::containsMeta ( const std::string &  key)

Function checking if a meta-object is available from the store.

◆ copy()

StatusCode Event::copy ( const std::string &  pattern = ".*")

Copy an object directly from the input to the output.

This function can be used to easily copy a given (set of) object/container(s) to the output, without modifying the contents of it/them.

It only needs to be called on the interface object/container(s), the copying of the auxiliary data is done automatically, and is steered by the xAOD::Event::setAuxItemList function.

Parameters
patternRegular expression for the key(s)/name(s) of the object(s)/container(s) to copy

Definition at line 28 of file EventIO.cxx.

28  {
29 
30  // Tell the user what's happening.
31  ATH_MSG_DEBUG("Copying objects matching pattern \"" << pattern
32  << "\" to the output");
33 
34  // Collect a list of keys to copy.
35  std::set<std::string> keys;
36 
37  // The regular expression to use.
39 
40  // Loop over the known input containers.
41  for (const auto& [key, efe] : m_inputEventFormat) {
42 
43  // Tell the user what's happening.
44  ATH_MSG_VERBOSE("Considering input object with key \"" << key << "\"");
45 
46  // Check if the class in question matches the requested pattern.
47  if (std::regex_match(key, re) == false) {
48  continue;
49  }
50  // Ignore objects that don't exist on the input.
51  static const bool SILENT = true;
52  if (connectObject(key, SILENT).isSuccess() == false) {
53  continue;
54  }
55  // Skip all branches ending in "Aux.":
56  if (key.ends_with("Aux.")) {
57  continue;
58  }
59  // Also skip dynamic branches:
60  if (efe.parentName() != "") {
61  continue;
62  }
63  // Add the key to the list.
64  ATH_MSG_VERBOSE("Matched key \"" << key << "\"");
65  keys.insert(key);
66  }
67 
68  // Check if the pattern matches any of the name remapping rules.
69  for (const auto& [newname, onfile] : m_nameRemapping) {
70 
71  // Tell the user what's happening.
72  ATH_MSG_VERBOSE("Considering remapped key \"" << newname << "\"");
73 
74  // Check if the remapped name matches the pattern.
75  if (std::regex_match(newname, re) == false) {
76  continue;
77  }
78  // Ignore objects that don't exist on the input.
79  static const bool SILENT = true;
80  if (connectObject(onfile, SILENT).isSuccess() == false) {
81  continue;
82  }
83  // Add the remapped name to the list.
84  ATH_MSG_VERBOSE("Matched remapped key \"" << newname << "\"");
85  keys.insert(newname);
86  }
87 
88  // Now loop over all of the found keys.
89  for (const std::string& key : keys) {
90 
91  // Check if a name re-mapping should be applied or not.
92  std::string keyToUse = key;
93  auto remap_itr = m_nameRemapping.find(key);
94  if ((remap_itr != m_nameRemapping.end()) &&
96  m_inputEventFormat.exists(remap_itr->second)) {
97  keyToUse = remap_itr->second;
98  }
99 
100  // Make sure that the input object got connected to.
101  static const bool SILENT = false;
102  ATH_CHECK(connectObject(keyToUse, SILENT));
103 
104  // Make sure that the input object is properly updated.
105  Object_t::const_iterator vobjMgr = m_inputObjects.find(keyToUse);
106  if (vobjMgr == m_inputObjects.end()) {
107  ATH_MSG_FATAL("Internal logic error detected");
108  return StatusCode::FAILURE;
109  }
110  Details::IObjectManager* objMgr =
111  dynamic_cast<Details::IObjectManager*>(vobjMgr->second.get());
112  if (objMgr == nullptr) {
113  ATH_MSG_FATAL("Internal logic error detected");
114  return StatusCode::FAILURE;
115  }
116  static const bool METADATA = false;
117  if (getInputObject(keyToUse, *(objMgr->holder()->getClass()->GetTypeInfo()),
118  SILENT, METADATA) == nullptr) {
119  ATH_MSG_FATAL("Internal logic error detected");
120  return StatusCode::FAILURE;
121  }
122 
123  // Put the interface object into the output.
124  static const bool OVERWRITE = true;
125  static const bool IS_OWNER = true;
126  ATH_CHECK(record(objMgr->object(), objMgr->holder()->getClass()->GetName(),
127  key, OVERWRITE, METADATA, IS_OWNER));
128 
129  // If there is also an auxiliary store for this object/container, copy that
130  // as well.
131  const std::string auxKey = keyToUse + "Aux.";
132  if (m_inputObjects.contains(auxKey)) {
133  ATH_CHECK(
134  recordAux(*(m_inputObjects.at(auxKey)), key + "Aux.", METADATA));
135  }
136  }
137 
138  // Return gracefully:
139  return StatusCode::SUCCESS;
140 }

◆ dump()

std::string Event::dump ( )

Function creating a user-readable dump of the current input.

This function behaves exactly like StoreGateSvc::dump().

It doesn't actually print anything to the screen, it just returns a user readable dump of the contents of the current input file/chain.

It is a pretty dumb implementation for the moment. Should be made nicer later on.

Returns
The user-readable contents of the current input file/chain

Definition at line 243 of file EventCore.cxx.

243  {
244 
245  // The internal stream object.
246  std::ostringstream ost;
247  ost << "<<<<<<<<<<<<<<<<<<<< xAOD::TEvent Dump >>>>>>>>>>>>>>>>>>>>\n";
248 
249  // Loop over the input EventFormat object.
250  for (const auto& [key, element] : m_inputEventFormat) {
251 
252  // Get the type.
253  ::TClass* cl = ::TClass::GetClass(element.className().c_str());
254  const std::type_info* ti = (cl ? cl->GetTypeInfo() : nullptr);
255  if ((cl == nullptr) || (cl->IsLoaded() == false) || (ti == nullptr)) {
256  ATH_MSG_WARNING("Unknown type (" << element.className()
257  << ") found in the event format");
258  continue;
259  }
260 
261  // Skip containers that are not available anyway.
262  static const bool METADATA = false;
263  if (!contains(element.branchName(), *ti, METADATA)) {
264  continue;
265  }
266 
267  // Do the printout.
268  ost << " Hash: 0x" << std::setw(8) << std::setfill('0') << std::hex
269  << element.hash() << " Key: \"" << element.branchName() << "\"\n";
270 
271  ost << " type: " << element.className() << "\n";
272  const bool isNonConst =
273  transientContains(element.branchName(), *ti, METADATA);
274  ost << " isConst: " << (isNonConst ? "No" : "Yes") << "\n";
275  static const bool SILENT = false;
276  ost << " Data: "
277  << (isNonConst
278  ? getOutputObject(element.branchName(), *ti, METADATA)
279  : getInputObject(element.branchName(), *ti, SILENT, METADATA))
280  << "\n";
281  }
282 
283  // Finish with the construction:
284  ost << "<<<<<<<<<<<<<<<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>";
285  return ost.str();
286 }

◆ getBranchInfo()

const Event::BranchInfo * Event::getBranchInfo ( SG::sgkey_t  sgkey) const
protected

Get the object describing one object/branch.

Definition at line 345 of file EventIProxyDict.cxx.

345  {
346 
347  {
348  // We can only hold the lock (even though it's a shared lock) for
349  // this limited scope because the call to getInputObject below
350  // leads to a recursion and dead-lock if not released immediately.
352 
353  // If the object already exists, return it:
354  auto it = m_branches.find(sgkey);
355  if (it != m_branches.end()) {
356  return &(it->second);
357  }
358  }
359 
360  // If not, construct it now:
361  BranchInfo bi;
363  if (!efe) {
364  // Apparently this key is not known:
365  return nullptr;
366  }
367 
368  // Helper variable(s).
369  static const bool SILENT = true;
370  static const bool METADATA = false;
371 
372  // The name of the requested object.
373  const std::string& name = getName(sgkey);
374  // This is a bit perverse... In order to let the "base class" figure
375  // out the exact type of this object, we ask for it with an "Event
376  // pointer". I use that type because I need something that has a
377  // dictionary, and which should always be available when this code
378  // runs. In the end it doesn't matter that the object can't be
379  // retrieved as that type (of course...), it only matters that it gets
380  // "set up" following these calls.
381  Event* nc_this = const_cast<Event*>(this);
382  static const std::type_info& dummy = typeid(Event);
383  nc_this->getInputObject(name, dummy, SILENT, METADATA);
384  auto itr = m_outputObjects.find(name);
385  if (itr == m_outputObjects.end()) {
386  itr = m_inputObjects.find(name);
387  if (itr == m_inputObjects.end()) {
388  // We didn't find this object in the store...
389  return nullptr;
390  }
391  }
392  const Details::IObjectManager* mgr =
393  dynamic_cast<const Details::IObjectManager*>(itr->second.get());
394  if (!mgr) {
395  ATH_MSG_ERROR("Internal logic error found");
396  return nullptr;
397  }
398  bi.m_class = mgr->holder()->getClass();
399  // There's no need to check whether this is a "proper" dictionary
400  // at this point, since if TEvent is holding on to it, the type
401  // must have a proper compiled dictionary.
402 
403 #ifndef XAOD_STANDALONE
404  // Create a proper proxy for the input branch:
406  CLID_NULL, efe->branchName(), new GenericAddress());
407  taddr->setSGKey(sgkey);
409  *nc_this, getName(sgkey), *bi.m_class->GetTypeInfo());
410  bi.m_proxy.reset(new SG::DataProxy(taddr, loader));
411  loader->setProxy(*bi.m_proxy.get());
412 #endif // not XAOD_STANDALONE
413 
414  // Add the branch info to our list:
416  lock.upgrade();
417  auto ret = m_branches.insert(std::make_pair(sgkey, std::move(bi)));
418 
419  // Return a pointer to the branch info:
420  return &(ret.first->second);
421 }

◆ getEventFormatElement()

const xAOD::EventFormatElement * Event::getEventFormatElement ( SG::sgkey_t  sgkey) const
protected

Get the metadata object for a given "SG key".

Definition at line 319 of file EventIProxyDict.cxx.

320  {
321 
322  const xAOD::EventFormatElement* efe = nullptr;
323  static const bool QUIET = true;
324  if (m_outputEventFormat) {
325  efe = m_outputEventFormat->get(sgkey, QUIET);
326  }
327  if (!efe) {
328  efe = m_inputEventFormat.get(sgkey, QUIET);
329  }
330  if (!efe) {
331  static SG::SGKeySet missingSGKeys ATLAS_THREAD_SAFE;
332  static mutex_t mutex;
333  guard_t lock(mutex);
334  if (missingSGKeys.emplace(sgkey).second) {
337  "Can't find EventFormatElement for hashed SG key: " << sgkey);
338  }
339  return 0;
340  }
341  }
342  return efe;
343 }

◆ getHash()

SG::sgkey_t Event::getHash ( const std::string &  key) const
overridevirtual

Function returning the hash describing an object name.

This helper function is mostly needed by the smart pointers of the xAOD EDM.

Right now it very simply just calculates the hash just based on the key given to the function. But later on it might be good to do some tests here, checking if the event format knows about the specified key or not. This is why it's not made to be a static function

Parameters
keyString key to turn into a hash
Returns
A hash corresponding to the specified string key

Implements xAOD::TVirtualEvent.

Definition at line 27 of file EventTVirtualEvent.cxx.

27  {
28 
29  // For empty keys let's finish quickly.
30  if (key == "") {
31  return 0;
32  }
33 
34  // If the key is used in the input file, let's use the same hash for
35  // the output file as well.
37  return m_inputEventFormat.get(key)->hash();
38  }
39 
40  // If it's a new key, make a new hash for it from scratch:
41  return Utils::hash(key);
42 }

◆ getInputObject() [1/2]

const void * Event::getInputObject ( const std::string &  key,
const std::type_info &  ti,
bool  silent,
bool  metadata 
)
protected

Function for retrieving an input object in a non-template way.

This is the function doing the heavy lifting to retrieve objects from the input file.

Parameters
keyThe key (branch name) of the object to retrieve
tiThe type as which the object is to be retrieved
silentSet to kTRUE to make the code fail silently in case the object can't be retrieved
metadataFlag deciding whether we're looking for a metadata or event data object
Returns
A pointer to the input object if successful, or a null pointer if not

Definition at line 218 of file EventIO.cxx.

220  {
221 
222  // Check if a name remapping should be applied or not:
223  std::string keyToUse = key;
224  auto remap_itr = m_nameRemapping.find(key);
225  if ((remap_itr != m_nameRemapping.end()) &&
227  m_inputEventFormat.exists(remap_itr->second)) {
228  keyToUse = remap_itr->second;
229  }
230 
231  // The following catches the cases when we ask for a transient
232  // ConstDataVector object to be returned as "const DataVector".
233  TStore* store = TActiveStore::store();
234  if (store && store->contains(keyToUse, ti) && store->isConst(keyToUse, ti)) {
235  const void* result = store->getConstObject(keyToUse, ti);
236  return result;
237  }
238 
239  // A sanity check before checking for an object from the input file.
240  if (hasInput() == false) {
241  if (silent == false) {
242  ATH_MSG_WARNING("No input file connected to the Event object");
243  }
244  return nullptr;
245  }
246 
247  // Make sure that the requested input is connected to.
248  const StatusCode sc = (metadata ? connectMetaObject(keyToUse, silent)
249  : connectObject(keyToUse, silent));
250  if (sc.isSuccess() == false) {
251  return nullptr;
252  }
253 
254  // Select which object container to use:
256 
257  // Access the object's manager:
258  auto itr = objects.find(keyToUse);
259  if (itr == objects.end()) {
260  ATH_MSG_FATAL("There is an internal logic error in the code...");
261  return nullptr;
262  }
263 
264  // This has to be an ObjectManager object:
265  Details::IObjectManager* mgr =
266  dynamic_cast<Details::IObjectManager*>(itr->second.get());
267  if (mgr == nullptr) {
268  if (key == keyToUse) {
269  ATH_MSG_ERROR("Object of wrong type found for key \"" << key << "\"");
270  } else {
271  ATH_MSG_ERROR("Object of wrong type found for key \""
272  << key << "\"/\"" << keyToUse << "\"");
273  }
274  return nullptr;
275  }
276 
277  // Make sure that the current entry is loaded for event data objects.
278  if (metadata == false) {
279  const Int_t readBytes = mgr->getEntry();
280  if (readBytes > 0) {
281  // Connect the auxiliary store to objects needing it. This call also
282  // takes care of updating the dynamic store of auxiliary containers,
283  // when they are getting accessed directly.
284  static const bool IS_METADATA = false;
285  if (setAuxStore(key, *mgr, IS_METADATA).isSuccess() == false) {
286  ATH_MSG_ERROR("Failed to set the auxiliary store for "
287  << mgr->holder()->getClass()->GetName() << "/"
288  << keyToUse);
289  return nullptr;
290  }
291  } else if (readBytes < 0) {
292  ATH_MSG_ERROR("Failed to load current entry for object "
293  << mgr->holder()->getClass()->GetName() << "/" << keyToUse);
294  return nullptr;
295  }
296  }
297 
298  // Ask the holder object for the object of this type:
299  const void* result = mgr->holder()->getAsConst(ti, silent);
300  if (result == nullptr) {
301  if (!silent) {
302  ATH_MSG_WARNING("Could not retrieve object with key \""
303  << keyToUse << "\" as \""
304  << SG::normalizedTypeinfoName(ti) << "\"");
305  }
306  return nullptr;
307  }
308 
309  // We succeeded:
310  return result;
311 }

◆ getInputObject() [2/2]

const void * Event::getInputObject ( SG::sgkey_t  key,
const std::type_info &  ti,
bool  silent 
)
overrideprotectedvirtual

Function for retrieving an input object in a non-template way.

This function is used by the TVirtualEvent interface to access an input object with a given hashed key.

The function looks up the string key belonging to the hash, and then calls the other GetInputObject(...) function in the class with that parameter.

Parameters
keyThe hashed key of the input object
tiThe type description of the object requested
silentSwitch for being silent about failures or not
Returns
A pointer to the requested object, or a null pointer in case of failure

Implements xAOD::TVirtualEvent.

Definition at line 162 of file EventTVirtualEvent.cxx.

163  {
164 
165  // Get a string name for this key:
166  const std::string& name = getName(key);
167  if (name.empty() && (silent == false)) {
168  ATH_MSG_WARNING("Key 0x" << std::hex << key << " unknown");
169  return nullptr;
170  }
171 
172  // Forward the call to the function using an std::string key:
173  static const bool METADATA = false;
174  return getInputObject(name, ti, silent, METADATA);
175 }

◆ getKey()

SG::sgkey_t Event::getKey ( const void *  obj) const
overridevirtual

Function returning the hash describing a known object.

This function is used by the smart pointer code to find the identifier of an object that's already in the event in some way.

Parameters
objPointer to the object that we want to look up
Returns
The hashed identifier of the object, or 0 if the object was not found in the event

Implements xAOD::TVirtualEvent.

Definition at line 51 of file EventTVirtualEvent.cxx.

51  {
52 
53  // Make use of the getName function.
54  return getHash(getName(obj));
55 }

◆ getName() [1/2]

const std::string & Event::getName ( const void *  obj) const
overridevirtual

Function returning the key describing a known object.

This function is used by the smart pointer code to find the identifier of an object that's already in the event in some way.

Parameters
objPointer to the object that we want to look up
Returns
The name of the object, or an empty string if the object was not found in the event

Implements xAOD::TVirtualEvent.

Definition at line 64 of file EventTVirtualEvent.cxx.

64  {
65 
66  // First look among the output objects.
67  for (const auto& [key, manager] : m_outputObjects) {
68  // Check if this is our object.
69  if (manager->object() == obj) {
70  // If it is, let's return right away.
71  return key;
72  }
73  }
74 
75  // Now look among the input objects.
76  for (const auto& [key, manager] : m_inputObjects) {
77  // Check if this is our object.
78  if (manager->object() == obj) {
79  // If it is, let's return.
80  return key;
81  }
82  }
83 
84  // If it's not there either, check if it's in an active TStore object:
85  const TStore* store = TActiveStore::store();
86  if (store && store->contains(obj)) {
87  // Get the name from the store then:
88  return store->getName(obj);
89  }
90 
91  // We didn't find the object in the event...
92  ATH_MSG_WARNING("Didn't find object with pointer \"" << obj
93  << "\" in the event");
94  static const std::string dummy;
95  return dummy;
96 }

◆ getName() [2/2]

const std::string & Event::getName ( SG::sgkey_t  hash) const
overridevirtual

Function returning the key describing a known object.

This function is used primarily when getting the string key of a smart pointer that we read in from a file, or access it in memory.

Parameters
hashThe hashed key for the container/object
Returns
The name of the object, or an empty string if the object was not found in the event

Implements xAOD::TVirtualEvent.

Definition at line 105 of file EventTVirtualEvent.cxx.

105  {
106 
107  // If the branch is known from the input:
110  }
111 
112  // If the branch is known on the output:
115  }
116 
117  // If this is an object in the active store:
118  const TStore* store = TActiveStore::store();
119  if (store && store->contains(hash)) {
120  return store->getName(hash);
121  }
122 
123  // If it is unknown:
124  static const std::string dummy;
125  return dummy;
126 }

◆ getNames()

virtual StatusCode xAOD::Event::getNames ( const std::string &  targetClassName,
std::vector< std::string > &  vkeys,
bool  metadata = false 
) const
protectedpure virtual

Function determining the list keys associated with a type name.

Implemented in xAOD::Experimental::REvent.

◆ getOutputObject() [1/2]

void * Event::getOutputObject ( const std::string &  key,
const std::type_info &  ti,
bool  metadata 
) const
protected

Function for retrieving an output object in a non-template way.

This function does the heavy lifting of retrieving object from the list of output objects.

While it returns a typeless pointer, that pointer can be cast directly to the type described by the second parameter in the caller code.

Parameters
keyThe key (branch name) of the object to retrieve
tiThe type as which the object is to be retrieved
metadataFlag deciding whether we're looking for a metadata or event data object
Returns
A pointer to the output object if successful, or a null pointer if not

Definition at line 154 of file EventIO.cxx.

155  {
156 
157  // Select which object container to use:
159 
160  // Check if the object can be found:
161  auto itr = objects.find(key);
162  if (itr == objects.end()) {
163  // Do the following only for event data:
164  if (!metadata) {
165  // It's not in the event. Let's check if we find it in an active
166  // TStore object...
167  TStore* store = TActiveStore::store();
168  if ((!store) || (!store->contains(key, ti)) || store->isConst(key, ti)) {
169  // Nope, not there either...
170  return nullptr;
171  }
172  // Let's return the object from the TStore:
173  void* result = store->getObject(key, ti);
174  return result;
175  } else {
176  // For metadata we don't use external resources.
177  return nullptr;
178  }
179  }
180 
181  // If the object is not set in this event yet, we can't continue:
182  if (itr->second->isSet() == false) {
183  return nullptr;
184  }
185 
186  // If it does exist, check if it's the right kind of object:
187  Details::IObjectManager* mgr =
188  dynamic_cast<Details::IObjectManager*>(itr->second.get());
189  if (mgr == nullptr) {
190  ATH_MSG_ERROR("Object of wrong type found for key \"" << key << "\"");
191  return nullptr;
192  }
193 
194  // Ask the holder object for the object of this type:
195  void* result = mgr->holder()->getAs(ti);
196  if (result == nullptr) {
197  ATH_MSG_WARNING("Couldn't retrieve object as \""
198  << SG::normalizedTypeinfoName(ti) << "\"");
199  return nullptr;
200  }
201 
202  // Return the object:
203  return result;
204 }

◆ getOutputObject() [2/2]

void * Event::getOutputObject ( SG::sgkey_t  key,
const std::type_info &  ti 
)
overrideprotectedvirtual

Function for retrieving an output object in a non-template way.

This function is used by the TVirtualEvent interface to access an output object with a given hashed key.

The function looks up the string key belonging to the hash, and then calls the other GetOutputObject(...) function in the class with that parameter.

Parameters
keyThe hashed key of the output object
tiThe type description of the object requested
Returns
A pointer to the requested object, or a null pointer in case of failure

Implements xAOD::TVirtualEvent.

Definition at line 138 of file EventTVirtualEvent.cxx.

138  {
139 
140  // Get a string name for this key.
141  const std::string& name = getName(key);
142  if (name.empty()) {
143  return nullptr;
144  }
145 
146  // Forward the call to the function using an std::string key.
147  static const bool METADATA = false;
148  return getOutputObject(name, ti, METADATA);
149 }

◆ hasInput()

virtual bool xAOD::Event::hasInput ( ) const
protectedpure virtual

Check if an input file is connected to the object.

Implemented in xAOD::Experimental::REvent.

◆ hasOutput()

virtual bool xAOD::Event::hasOutput ( ) const
protectedpure virtual

Check if an output file is connected to the object.

Implemented in xAOD::Experimental::REvent.

◆ 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.

40 {
42  m_lvl = m_imsg ?
43  static_cast<MSG::Level>( m_imsg.load()->outputLevel(m_nm) ) :
44  MSG::INFO;
45 }

◆ inputEventFormat()

const EventFormat * Event::inputEventFormat ( ) const

Get information about the input objects.

Definition at line 221 of file EventCore.cxx.

221  {
222 
223  if (hasInput()) {
224  return &m_inputEventFormat;
225  }
226  return nullptr;
227 }

◆ keys()

template<typename T >
StatusCode xAOD::Event::keys ( std::vector< std::string > &  vkeys,
bool  metadata 
) const

Provide a list of all data object keys associated with a specific type.

◆ keyToString() [1/2]

const std::string * Event::keyToString ( SG::sgkey_t  key) const
overrideprotected

Find the string corresponding to a given key.

Definition at line 292 of file EventIProxyDict.cxx.

292  {
293 
294  return &(getName(key));
295 }

◆ keyToString() [2/2]

const std::string * Event::keyToString ( SG::sgkey_t  key,
CLID clid 
) const
overrideprotected

Find the string and CLID corresponding to a given key.

Definition at line 297 of file EventIProxyDict.cxx.

297  {
298 
299  return &(getName(key));
300 }

◆ metaKeys()

template<typename T >
StatusCode xAOD::Event::metaKeys ( std::vector< std::string > &  vkeys) const

Provide a list of all metadata object keys associated with a specific type.

◆ msg() [1/2]

MsgStream & asg::AsgMessaging::msg ( ) const
inherited

The standard message stream.

Returns
A reference to the default message stream of this object.

Definition at line 49 of file AsgMessaging.cxx.

49  {
50 #ifndef XAOD_STANDALONE
52 #else // not XAOD_STANDALONE
53  return m_msg;
54 #endif // not XAOD_STANDALONE
55  }

◆ msg() [2/2]

MsgStream & asg::AsgMessaging::msg ( const MSG::Level  lvl) const
inherited

The standard message stream.

Parameters
lvlThe message level to set the stream to
Returns
A reference to the default message stream, set to level "lvl"

Definition at line 57 of file AsgMessaging.cxx.

57  {
58 #ifndef XAOD_STANDALONE
60 #else // not XAOD_STANDALONE
61  m_msg << lvl;
62  return m_msg;
63 #endif // not XAOD_STANDALONE
64  }

◆ msgLvl()

bool asg::AsgMessaging::msgLvl ( const MSG::Level  lvl) const
inherited

Test the output level of the object.

Parameters
lvlThe message level to test against
Returns
boolean Indicting if messages at given level will be printed
true If messages at level "lvl" will be printed

Definition at line 41 of file AsgMessaging.cxx.

41  {
42 #ifndef XAOD_STANDALONE
43  return ::AthMessaging::msgLvl( lvl );
44 #else // not XAOD_STANDALONE
45  return m_msg.msgLevel( lvl );
46 #endif // not XAOD_STANDALONE
47  }

◆ name()

const std::string & Event::name ( ) const
overrideprotected

Get the name of the instance.

Definition at line 313 of file EventIProxyDict.cxx.

313  {
314 
315  static const std::string result{"xAOD::Event"};
316  return result;
317 }

◆ outputEventFormat()

const EventFormat * Event::outputEventFormat ( ) const

Get information about the output objects.

Definition at line 229 of file EventCore.cxx.

229  {
230 
231  return m_outputEventFormat;
232 }

◆ printIOStats()

void Event::printIOStats ( ) const

Function printing the I/O statistics of the current process.

This is a convenience function for printing basic I/O information about the current job.

It can be called at the end of a job to get an overview of what the job did exactly I/O-wise.

Definition at line 291 of file EventCore.cxx.

291  {
292 
293  // Simply do this via the xAODCore code:
294  IOStats::instance().stats().Print("Summary");
295 }

◆ printNameRemap()

void Event::printNameRemap ( ) const

Print the current name re-mapping rules.

This function can be used for debugging, to check what container/object name remapping rules are in place for the current TEvent object.

Definition at line 194 of file EventCore.cxx.

194  {
195 
196  // Print a header.
197  ATH_MSG_INFO("Name remapping rules:");
198 
199  // In case no remapping rules have been set.
200  if (m_nameRemapping.empty()) {
201  ATH_MSG_INFO(" NONE");
202  return;
203  }
204 
205  // Otherwise.
206  for (const auto& [newName, onfile] : m_nameRemapping) {
207  ATH_MSG_INFO(" \"" << newName << "\" -> \"" << onfile << "\"");
208  }
209 }

◆ printProxyWarnings()

void Event::printProxyWarnings ( bool  value = true)

Enable warnings associated with broken element links.

These appear harmless so long as you don't actually try to access the links.

Which will cause other errors anyway.

Parameters
valueThe new value for the option

Definition at line 216 of file EventCore.cxx.

216  {
217 
219 }

◆ proxies()

std::vector< const SG::DataProxy * > Event::proxies ( ) const
overrideprotected

return the list of all current proxies in store

Definition at line 273 of file EventIProxyDict.cxx.

273  {
274 
276 
277  std::vector<const SG::DataProxy*> ret;
278  for (const auto& p : m_branches) {
279  const SG::DataProxy* proxy = p.second.m_proxy.get();
280  if (proxy) {
281  ret.push_back(proxy);
282  }
283  }
284  return ret;
285 }

◆ proxy() [1/2]

SG::DataProxy * Event::proxy ( const CLID id,
const std::string &  key 
) const
overrideprotected

get proxy with given id and key. Returns 0 to flag failure

Definition at line 211 of file EventIProxyDict.cxx.

211  {
212 
213  const SG::sgkey_t sgkey = getHash(key);
214  if (!sgkey) {
215  return 0;
216  }
217  return proxy_exact(sgkey);
218 }

◆ proxy() [2/2]

SG::DataProxy * Event::proxy ( const void *const  pTransient) const
overrideprotected

get proxy for a given data object address in memory

Definition at line 183 of file EventIProxyDict.cxx.

183  {
184 
185  // Look up the name of this object
186  std::string name = getName(pTransient);
187  if (name.empty()) {
188  // Apparently the object is not known...
189  return nullptr;
190  }
191 
192  // Get the metadata object for it:
193  const xAOD::EventFormatElement* efe = 0;
194  static const bool QUIET = true;
195  if (m_outputEventFormat) {
196  efe = m_outputEventFormat->get(name, QUIET);
197  }
198  if (!efe) {
199  efe = m_inputEventFormat.get(name, QUIET);
200  }
201  if (!efe) {
202  // No metadata found...
203  return nullptr;
204  }
205 
206  // Return the proxy:
207  const BranchInfo* bi = getBranchInfo(efe->hash());
208  return bi->m_proxy.get();
209 }

◆ proxy_exact()

SG::DataProxy * Event::proxy_exact ( SG::sgkey_t  sgkey) const
overrideprotected

Get proxy given a hashed key+clid.

Definition at line 220 of file EventIProxyDict.cxx.

220  {
221 
222  // Get the object describing this branch/object:
223  const BranchInfo* bi = getBranchInfo(sgkey);
224  if (!bi) {
225  static SG::SGKeySet missingSGKeys ATLAS_THREAD_SAFE;
226  static mutex_t mutex;
227  guard_t lock(mutex);
228  if (missingSGKeys.emplace(sgkey).second && m_printEventProxyWarnings) {
229  ATH_MSG_WARNING("Can't find BranchInfo for: " << sgkey);
230  }
231  return 0;
232  }
233 
234  // Access its data proxy:
235  SG::DataProxy* proxy = bi->m_proxy.get();
236 
237  // Return the proxy:
238  return proxy;
239 }

◆ record() [1/3]

template<typename T >
StatusCode xAOD::Event::record ( std::unique_ptr< T >  obj,
const std::string &  key 
)

Add an output object to the event, explicitly taking ownership of it.

◆ record() [2/3]

template<typename T >
StatusCode xAOD::Event::record ( T *  obj,
const std::string &  key 
)

Add an output object to the event.

◆ record() [3/3]

virtual StatusCode xAOD::Event::record ( void *  obj,
const std::string &  typeName,
const std::string &  key,
bool  overwrite,
bool  metadata,
bool  isOwner 
)
protectedpure virtual

Record an object into a connected output file.

Implemented in xAOD::Experimental::REvent.

◆ recordAux()

virtual StatusCode xAOD::Event::recordAux ( TVirtualManager mgr,
const std::string &  key,
bool  metadata 
)
protectedpure virtual

Record an auxiliary store into a connected output file.

Implemented in xAOD::Experimental::REvent.

◆ recordMeta() [1/2]

template<typename T >
StatusCode xAOD::Event::recordMeta ( std::unique_ptr< T >  obj,
const std::string &  key 
)

Add an object to the output file's metadata, explicitly taking ownership of it.

◆ recordMeta() [2/2]

template<typename T >
StatusCode xAOD::Event::recordMeta ( T *  obj,
const std::string &  key 
)

Add an object to the output file's metadata.

◆ recordObject()

SG::DataProxy * Event::recordObject ( SG::DataObjectSharedPtr< DataObject >  obj,
const std::string &  key,
bool  allowMods,
bool  returnExisting 
)
overrideprotected

Record an object in the store.

Definition at line 307 of file EventIProxyDict.cxx.

308  {
309 
310  throw std::runtime_error("xAOD::Event::recordObject is not implemented");
311 }

◆ recordTypeless()

StatusCode xAOD::Event::recordTypeless ( void *  obj,
const std::string &  typeName,
const std::string &  key,
bool  overwrite = false,
bool  metadata = true,
bool  isOwner = true 
)
protected

Internal function for recording an object into the output.

◆ registerKey()

void Event::registerKey ( SG::sgkey_t  key,
const std::string &  str,
CLID  clid 
)
overrideprotected

Remember an additional mapping from key to string/CLID.

Definition at line 302 of file EventIProxyDict.cxx.

302  {
303 
304  return;
305 }

◆ removeListener()

StatusCode Event::removeListener ( TVirtualIncidentListener listener)

Remove an incident listener object.

This function allows us to remove a listener when for instance a metadata tool is deleted during a job.

Parameters
listenerPointer to the listener that should be removed
Returns
The usual StatusCode types

Definition at line 121 of file EventCore.cxx.

121  {
122 
123  // Remove the listener. Or at least try to...
124  if (m_listeners.erase(listener) != 1u) {
125  ATH_MSG_ERROR("Listener " << static_cast<void*>(listener) << " not known");
126  return StatusCode::FAILURE;
127  }
128 
129  // Return gracefully:
130  return StatusCode::SUCCESS;
131 }

◆ retrieve() [1/4]

template<typename T >
StatusCode xAOD::Event::retrieve ( const T *&  obj,
const std::string &  key 
)

Retrieve either an input or an output object from the event.

◆ retrieve() [2/4]

template<typename T >
bool xAOD::TVirtualEvent::retrieve ( const T *&  obj,
const std::string &  key,
bool  silent = false 
)
inherited

Function retrieving an object from the event (constant version)

◆ retrieve() [3/4]

template<typename T >
bool xAOD::TVirtualEvent::retrieve ( const T *&  obj,
sgkey_t  key = DEFAULT_KEY,
bool  silent = false 
)
inherited

Function retrieving an object from the event (constant version)

◆ retrieve() [4/4]

template<typename T >
StatusCode xAOD::Event::retrieve ( T *&  obj,
const std::string &  key 
)

Retrieve an output object from the event.

◆ retrieveMetaInput()

template<typename T >
StatusCode xAOD::Event::retrieveMetaInput ( const T *&  obj,
const std::string &  key 
)

Retrieve an input metadata object.

◆ retrieveMetaOutput() [1/2]

template<typename T >
StatusCode xAOD::Event::retrieveMetaOutput ( const T *&  obj,
const std::string &  key 
)

Retrieve an output metadata object.

◆ retrieveMetaOutput() [2/2]

template<typename T >
StatusCode xAOD::Event::retrieveMetaOutput ( T *&  obj,
const std::string &  key 
)

Retrieve an output metadata object.

◆ setActive()

void Event::setActive ( ) const

Set this event object as the currently active one.

Definition at line 54 of file EventCore.cxx.

54  {
55 
56  // The active event and current store are thread-local globals.
57  Event* nc_this ATLAS_THREAD_SAFE = const_cast<Event*>(this);
58  TActiveEvent::setEvent(static_cast<TVirtualEvent*>(nc_this));
59 #ifndef XAOD_STANDALONE
61 #endif // not XAOD_STANDALONE
62 }

◆ setAuxItemList()

void Event::setAuxItemList ( const std::string &  containerKey,
const std::string &  itemList 
)

Configure which dynamic variables to write out for a given store.

This function receives the rules for selecting which dynamic auxiliary branches should be written for a given container, in the exact same format in which we need to set it in the Athena output ItemList.

Parameters
containerKeyThe name of the auxiliary container in question
itemListThe variable list according to the formatting rules

Definition at line 71 of file EventCore.cxx.

72  {
73 
74  // Decoded attributes.
75  std::set<std::string> attributes;
76 
77  // Split up the received string using "." as the separator.
78  if (itemList.size()) {
79  std::istringstream ss(itemList);
80  std::string attr;
81  while (std::getline(ss, attr, '.')) {
82  attributes.insert(attr);
83  }
84  }
85 
86  // Remember the setting.
87  m_auxItemList[containerKey] = std::move(attributes);
88 }

◆ setAuxStore()

virtual StatusCode xAOD::Event::setAuxStore ( const std::string &  key,
Details::IObjectManager mgr,
bool  metadata 
)
protectedpure virtual

Function connecting a DV object to its auxiliary store.

Implemented in xAOD::Experimental::REvent.

◆ 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.

29 {
30  m_lvl = lvl;
31 }

◆ stringToKey()

SG::sgkey_t Event::stringToKey ( const std::string &  str,
CLID  clid 
)
overrideprotected

Find the string corresponding to a given key.

Definition at line 287 of file EventIProxyDict.cxx.

287  {
288 
289  return getHash(str);
290 }

◆ transientContains() [1/2]

template<typename T >
bool xAOD::Event::transientContains ( const std::string &  key) const

Function checking if an object is already in memory.

◆ transientContains() [2/2]

bool xAOD::Event::transientContains ( const std::string &  key,
const std::type_info &  ti,
bool  metadata 
) const
protected

Internal function checking if an object is already in memory.

◆ transientContainsMeta()

template<typename T >
bool xAOD::Event::transientContainsMeta ( const std::string &  key) const

Function checking if a meta-object is already in memory.

Friends And Related Function Documentation

◆ xAODPrivate::HolderBucket

friend class xAODPrivate::HolderBucket
friend

Definition at line 62 of file Event.h.

◆ xAODPrivate::Loader

friend class xAODPrivate::Loader
friend

Definition at line 63 of file Event.h.

Member Data Documentation

◆ ATLAS_THREAD_SAFE

SG::SGKeyMap<BranchInfo> m_branches xAOD::Event::ATLAS_THREAD_SAFE
mutableprotected

Map from hashed sgkey to BranchInfo.

Definition at line 358 of file Event.h.

◆ DEFAULT_KEY

constexpr sgkey_t xAOD::TVirtualEvent::DEFAULT_KEY = ~static_cast<sgkey_t>(0)
staticconstexprinherited

Key for retrieving the "default" object of a given type.

Definition at line 35 of file TVirtualEvent.h.

◆ KEY_MASK

constexpr sgkey_t xAOD::TVirtualEvent::KEY_MASK = DEFAULT_KEY >> 2
staticconstexprinherited

Mask for the keys, used mostly internally.

Definition at line 37 of file TVirtualEvent.h.

◆ m_auxItemList

std::unordered_map<std::string, std::set<std::string> > xAOD::Event::m_auxItemList
protected

Rules for selecting which auxiliary branches to write.

Definition at line 326 of file Event.h.

◆ m_branchesMutex

upgrade_mutex_t xAOD::Event::m_branchesMutex
mutableprotected

Mutex for multithread synchronization.

Definition at line 354 of file Event.h.

◆ m_imsg

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

MessageSvc pointer.

Definition at line 135 of file AthMessaging.h.

◆ m_inputEventFormat

EventFormat xAOD::Event::m_inputEventFormat
protected

Format of the current input file.

Definition at line 321 of file Event.h.

◆ m_inputMetaObjects

Object_t xAOD::Event::m_inputMetaObjects
protected

Collection of all the managed input meta-objects.

Definition at line 316 of file Event.h.

◆ m_inputMissingObjects

std::set<std::string> xAOD::Event::m_inputMissingObjects
protected

Objects that have been asked for, but were found to be missing in the current input.

Definition at line 311 of file Event.h.

◆ m_inputObjects

Object_t xAOD::Event::m_inputObjects
protected

Collection of all the managed input objects.

Definition at line 308 of file Event.h.

◆ m_listeners

std::set<TVirtualIncidentListener*> xAOD::Event::m_listeners
protected

Listeners who should be notified when certain incidents happen.

Definition at line 329 of file Event.h.

◆ m_lvl

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

Current logging level.

Definition at line 138 of file AthMessaging.h.

◆ 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_nameRemapping

std::unordered_map<std::string, std::string> xAOD::Event::m_nameRemapping
protected

Container name re-mapping rules.

Definition at line 332 of file Event.h.

◆ m_nm

std::string AthMessaging::m_nm
privateinherited

Message source name.

Definition at line 129 of file AthMessaging.h.

◆ m_outputEventFormat

EventFormat* xAOD::Event::m_outputEventFormat = nullptr
protected

Format of the current output file.

Definition at line 323 of file Event.h.

◆ m_outputMetaObjects

Object_t xAOD::Event::m_outputMetaObjects
protected

Collection of all the managed output meta-objects.

Definition at line 318 of file Event.h.

◆ m_outputObjects

Object_t xAOD::Event::m_outputObjects
protected

Collection of all the managed output object.

Definition at line 313 of file Event.h.

◆ m_printEventProxyWarnings

bool xAOD::Event::m_printEventProxyWarnings = false
protected

Option to silence common warnings that seem to be harmless.

Definition at line 335 of file Event.h.


The documentation for this class was generated from the following files:
xAOD::Event::keys
StatusCode keys(std::vector< std::string > &vkeys, bool metadata) const
Provide a list of all data object keys associated with a specific type.
AthMessaging::m_lvl
std::atomic< MSG::Level > m_lvl
Current logging level.
Definition: AthMessaging.h:138
mergePhysValFiles.pattern
pattern
Definition: DataQuality/DataQualityUtils/scripts/mergePhysValFiles.py:25
SGTest::store
TestStore store
Definition: TestStore.cxx:23
common.sgkey
def sgkey(tool)
Definition: common.py:1027
xAOD::Event::getEventFormatElement
const xAOD::EventFormatElement * getEventFormatElement(SG::sgkey_t sgkey) const
Get the metadata object for a given "SG key".
Definition: EventIProxyDict.cxx:319
xAOD::EventFormat_v1::get
const EventFormatElement * get(const std::string &key, bool quiet=false) const
Get the description of a given branch.
Definition: EventFormat_v1.cxx:91
ATH_MSG_FATAL
#define ATH_MSG_FATAL(x)
Definition: AthMsgStreamMacros.h:34
xAODPrivate::Loader
Definition: EventIProxyDict.cxx:142
xAOD::Event::ATLAS_THREAD_SAFE
SG::SGKeyMap< BranchInfo > m_branches ATLAS_THREAD_SAFE
Map from hashed sgkey to BranchInfo.
Definition: Event.h:358
python.trigbs_prescaleL1.ost
ost
Definition: trigbs_prescaleL1.py:104
get_generator_info.result
result
Definition: get_generator_info.py:21
PowhegControl_ttHplus_NLO.ss
ss
Definition: PowhegControl_ttHplus_NLO.py:83
LArConditions2Ntuple.objects
objects
Definition: LArConditions2Ntuple.py:64
xAOD::Event::setAuxStore
virtual StatusCode setAuxStore(const std::string &key, Details::IObjectManager &mgr, bool metadata)=0
Function connecting a DV object to its auxiliary store.
ATH_MSG_INFO
#define ATH_MSG_INFO(x)
Definition: AthMsgStreamMacros.h:31
xAOD::IOStats::stats
ReadStats & stats()
Access the object belonging to the current thread.
Definition: IOStats.cxx:17
xAOD::Event::name
const std::string & name() const override
Get the name of the instance.
Definition: EventIProxyDict.cxx:313
CP::OutOfValidityAction::SILENT
@ SILENT
don't print anything and return success
xAOD::TActiveEvent::setEvent
static void setEvent(TVirtualEvent *ptr)
Set the active event pointer.
Definition: TActiveEvent.cxx:21
xAOD::Event::m_inputObjects
Object_t m_inputObjects
Collection of all the managed input objects.
Definition: Event.h:308
SG::normalizedTypeinfoName
std::string normalizedTypeinfoName(const std::type_info &info)
Convert a type_info to a normalized string representation (matching the names used in the root dictio...
Definition: normalizedTypeinfoName.cxx:120
xAOD::Event::m_outputMetaObjects
Object_t m_outputMetaObjects
Collection of all the managed output meta-objects.
Definition: Event.h:318
xAOD::Event::m_inputEventFormat
EventFormat m_inputEventFormat
Format of the current input file.
Definition: Event.h:321
BeamSpot::mutex
std::mutex mutex
Definition: InDetBeamSpotVertex.cxx:18
Event
Definition: trigbs_orderedMerge.cxx:42
StateLessPT_NewConfig.Format
Format
Definition: StateLessPT_NewConfig.py:149
xAOD::Event::setActive
void setActive() const
Set this event object as the currently active one.
Definition: EventCore.cxx:54
xAODPrivate::Loader::setProxy
void setProxy(SG::DataProxy &proxy)
Definition: EventIProxyDict.cxx:151
xAOD::Event::Event
Event(std::string_view name)
Constructor with a name.
Definition: EventCore.cxx:27
xAOD::ReadStats::Print
void Print(::Option_t *option="") const
Print information about the collected statistics.
skel.it
it
Definition: skel.GENtoEVGEN.py:407
SG::TransientAddress
Definition: TransientAddress.h:32
SG::CurrentEventStore::setStore
static IProxyDict * setStore(IProxyDict *store)
Set the current store.
Definition: CurrentEventStore.cxx:36
xAOD::TActiveStore::store
static TStore * store()
Access the currently active TStore object.
Definition: TActiveStore.cxx:16
athena.value
value
Definition: athena.py:124
SG::CurrentEventStore::store
static IProxyDict * store()
Fetch the current store.
xAOD::EventFormatElement
Class describing one branch of the ROOT file.
Definition: EventFormatElement.h:39
xAOD::Event::stringToKey
SG::sgkey_t stringToKey(const std::string &str, CLID clid) override
Find the string corresponding to a given key.
Definition: EventIProxyDict.cxx:287
xAOD::Event::m_nameRemapping
std::unordered_map< std::string, std::string > m_nameRemapping
Container name re-mapping rules.
Definition: Event.h:332
python.RatesEmulationExample.lock
lock
Definition: RatesEmulationExample.py:148
ATH_MSG_VERBOSE
#define ATH_MSG_VERBOSE(x)
Definition: AthMsgStreamMacros.h:28
xAOD::EventFormatElement::branchName
const std::string & branchName() const
Get the branch/key name.
Definition: EventFormatElement.cxx:30
AthMessaging::m_imsg
std::atomic< IMessageSvc * > m_imsg
MessageSvc pointer.
Definition: AthMessaging.h:135
Trk::u
@ u
Enums for curvilinear frames.
Definition: ParamDefs.h:77
Athena::getMessageSvc
IMessageSvc * getMessageSvc(bool quiet=false)
Definition: getMessageSvc.cxx:20
xAOD::Event::Object_t
std::unordered_map< std::string, std::unique_ptr< TVirtualManager > > Object_t
Definition of the internal data structure type.
Definition: Event.h:305
xAOD::EventFormatElement::hash
sgkey_t hash() const
Get the hash belonging to this branch/key.
Definition: EventFormatElement.cxx:48
xAOD::Event::m_inputMetaObjects
Object_t m_inputMetaObjects
Collection of all the managed input meta-objects.
Definition: Event.h:316
AthenaPoolTestRead.sc
sc
Definition: AthenaPoolTestRead.py:27
xAOD::Event::getName
const std::string & getName(const void *obj) const override
Function returning the key describing a known object.
Definition: EventTVirtualEvent.cxx:64
PrepareReferenceFile.regex
regex
Definition: PrepareReferenceFile.py:43
python.checkMetadata.metadata
metadata
Definition: checkMetadata.py:175
BchCleanup.mgr
mgr
Definition: BchCleanup.py:294
xAOD::TActiveEvent::event
static TVirtualEvent * event()
Access the currently active TVirtualEvent object.
Definition: TActiveEvent.cxx:16
xAOD::Event::m_printEventProxyWarnings
bool m_printEventProxyWarnings
Option to silence common warnings that seem to be harmless.
Definition: Event.h:335
python.utils.AtlRunQueryDQUtils.p
p
Definition: AtlRunQueryDQUtils.py:209
TrigConf::MSGTC::Level
Level
Definition: Trigger/TrigConfiguration/TrigConfBase/TrigConfBase/MsgStream.h:21
ATH_MSG_ERROR
#define ATH_MSG_ERROR(x)
Definition: AthMsgStreamMacros.h:33
xAOD::Event::m_auxItemList
std::unordered_map< std::string, std::set< std::string > > m_auxItemList
Rules for selecting which auxiliary branches to write.
Definition: Event.h:326
guard_t
AthContainers_detail::lock_guard< mutex_t > guard_t
Guard type for multithreaded synchronisation.
Definition: EventIProxyDict.cxx:36
xAOD::Event::connectMetaObject
virtual StatusCode connectMetaObject(const std::string &key, bool silent)=0
Function setting up access to a particular metadata object.
EL::StatusCode
::StatusCode StatusCode
StatusCode definition for legacy code.
Definition: PhysicsAnalysis/D3PDTools/EventLoop/EventLoop/StatusCode.h:22
ATH_MSG_DEBUG
#define ATH_MSG_DEBUG(x)
Definition: AthMsgStreamMacros.h:29
vertexingJO_ITK_init.itemList
list itemList
Definition: vertexingJO_ITK_init.py:95
xAOD::Event::m_branchesMutex
upgrade_mutex_t m_branchesMutex
Mutex for multithread synchronization.
Definition: Event.h:354
xAOD::Event::getOutputObject
void * getOutputObject(SG::sgkey_t key, const std::type_info &ti) override
Function for retrieving an output object in a non-template way.
Definition: EventTVirtualEvent.cxx:138
CalibDbCompareRT.dummy
dummy
Definition: CalibDbCompareRT.py:59
xAOD::Event::recordAux
virtual StatusCode recordAux(TVirtualManager &mgr, const std::string &key, bool metadata)=0
Record an auxiliary store into a connected output file.
xAOD::Event::proxy_exact
SG::DataProxy * proxy_exact(SG::sgkey_t sgkey) const override
Get proxy given a hashed key+clid.
Definition: EventIProxyDict.cxx:220
ATH_CHECK
#define ATH_CHECK
Definition: AthCheckMacros.h:40
xAOD::IOStats::instance
static IOStats & instance()
Singleton object accessor.
Definition: IOStats.cxx:11
xAOD::Details::IProxyDictBase
implements< IProxyDict > IProxyDictBase
IProxyDict base class to use in a specific build environment
Definition: Event.h:39
xAOD::Event::getInputObject
const void * getInputObject(SG::sgkey_t key, const std::type_info &ti, bool silent) override
Function for retrieving an input object in a non-template way.
Definition: EventTVirtualEvent.cxx:162
xAOD::Event::hasInput
virtual bool hasInput() const =0
Check if an input file is connected to the object.
EL::Detail::SubmitDirMode::OVERWRITE
@ OVERWRITE
create the directory as is, removing existing directories if needed
xAOD::Event::record
StatusCode record(T *obj, const std::string &key)
Add an output object to the event.
xAOD::Event::m_outputObjects
Object_t m_outputObjects
Collection of all the managed output object.
Definition: Event.h:313
xAOD::Event::upgrading_lock_t
AthContainers_detail::upgrading_lock< upgrade_mutex_t > upgrading_lock_t
Lock type for multithread synchronization.
Definition: Event.h:352
SG::SGKeySet
std::unordered_set< sgkey_t > SGKeySet
A set of sgkey_t values.
Definition: CxxUtils/CxxUtils/sgkey_t.h:97
asg::AsgMessaging
Class mimicking the AthMessaging class from the offline software.
Definition: AsgMessaging.h:40
xAOD::Event::connectObject
virtual StatusCode connectObject(const std::string &key, bool silent)=0
Function setting up access to a particular object.
MakeNewFileFromOldAndSubstitution.newName
dictionary newName
Definition: ICHEP2016/MakeNewFileFromOldAndSubstitution.py:95
SG::sgkey_t
uint32_t sgkey_t
Type used for hashed StoreGate key+CLID pairs.
Definition: CxxUtils/CxxUtils/sgkey_t.h:32
xAOD::PerfStats::instance
static PerfStats & instance()
Function accessing the singleton instance.
xAOD::Event::m_listeners
std::set< TVirtualIncidentListener * > m_listeners
Listeners who should be notified when certain incidents happen.
Definition: Event.h:329
xAOD::Event::contains
bool contains(const std::string &key)
Function checking if an object is available from the store.
xAOD::Event::m_outputEventFormat
EventFormat * m_outputEventFormat
Format of the current output file.
Definition: Event.h:323
python.trfDecorators.silent
def silent(func)
Redirect stdout/err to /dev/null Useful wrapper to get rid of ROOT verbosity...
Definition: trfDecorators.py:24
CaloCondBlobAlgs_fillNoiseFromASCII.hash
dictionary hash
Definition: CaloCondBlobAlgs_fillNoiseFromASCII.py:108
ATH_MSG_WARNING
#define ATH_MSG_WARNING(x)
Definition: AthMsgStreamMacros.h:32
mutex_t
AthContainers_detail::mutex mutex_t
Mutex type for multithread synchronization.
Definition: EventIProxyDict.cxx:34
python.Constants.INFO
int INFO
Definition: Control/AthenaCommon/python/Constants.py:15
AthMessaging::m_nm
std::string m_nm
Message source name.
Definition: AthMessaging.h:129
re
const boost::regex re(r_e)
SG::TransientAddress::setSGKey
void setSGKey(sgkey_t sgkey)
check if it is a transient ID (primary or symLinked):
Definition: TransientAddress.h:238
createCoolChannelIdFile.newname
newname
Definition: createCoolChannelIdFile.py:105
xAOD::Event::proxy
SG::DataProxy * proxy(const void *const pTransient) const override
get proxy for a given data object address in memory
Definition: EventIProxyDict.cxx:183
xAOD::Event::getHash
SG::sgkey_t getHash(const std::string &key) const override
Function returning the hash describing an object name.
Definition: EventTVirtualEvent.cxx:27
str
Definition: BTagTrackIpAccessor.cxx:11
python.Logging.manager
manager
Definition: PhysicsAnalysis/D3PDTools/AnaAlgorithm/python/Logging.py:92
xAOD::Event::getBranchInfo
const BranchInfo * getBranchInfo(SG::sgkey_t sgkey) const
Get the object describing one object/branch.
Definition: EventIProxyDict.cxx:345
python.PyAthena.obj
obj
Definition: PyAthena.py:132
SG::DataProxy
Definition: DataProxy.h:45
xAOD::Utils::hash
SG::sgkey_t hash(const std::string &name)
This function provides a hashed version of the key (branch) names used in the xAOD file,...
Definition: Control/xAODRootAccess/Root/Utils.cxx:125
dq_make_web_display.cl
cl
print [x.__class__ for x in toList(dqregion.getSubRegions()) ]
Definition: dq_make_web_display.py:25
python.AutoConfigFlags.msg
msg
Definition: AutoConfigFlags.py:7
python.TransformConfig.attributes
def attributes(self)
Definition: TransformConfig.py:383
xAOD::Event::transientContains
bool transientContains(const std::string &key) const
Function checking if an object is already in memory.
xAOD::EventFormat_v1::exists
bool exists(const std::string &key) const
Check if a description exists about a given branch.
Definition: EventFormat_v1.cxx:65
mapkey::key
key
Definition: TElectronEfficiencyCorrectionTool.cxx:37