ATLAS Offline Software
Classes | Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | Private Member Functions | Private Attributes | List of all members
RNTupleContainer Class Reference

#include <src/RNTupleContainer.h>

Inheritance diagram for RNTupleContainer:
Collaboration diagram for RNTupleContainer:

Classes

struct  FieldDesc
 Definition of a field info structure. More...
 

Public Member Functions

 RNTupleContainer (const std::string &name)
 
virtual ~RNTupleContainer ()
 
virtual pool::DbStatus close () override final
 Close the container and deallocate resources. More...
 
virtual pool::DbStatus open (pool::DbDatabase &dbH, const std::string &nam, const pool::DbTypeInfo *info, pool::DbAccessMode mod) override final
 Open the container for object access. More...
 
virtual pool::DbStatus checkAccess (pool::DbDatabase &dbH, const std::string &nam) const override final
 Check if we can access the container for reading with the given type. More...
 
virtual pool::DbStatus getOption (pool::DbOption &opt) override final
 Access options. More...
 
virtual pool::DbStatus setOption (const pool::DbOption &opt) override final
 Set options. More...
 
virtual uint64_t size () override final
 Number of entries within the container. More...
 
const std::string & getName () const
 Return the name of the container. More...
 
bool isDirty () const
 Return true if this branch container was updated and it's TTree needs to be Filled. More...
 
void clearDirty ()
 Clear the dirty status (used after containing TTree was Filled) More...
 
virtual pool::DbStatus loadObject (void **ptr, pool::ShapeH shape, Token::OID_t &oid) override final
 Find object by object identifier and load it into memory. More...
 
virtual pool::DbStatus writeObject (ActionList::value_type &) override final
 Commit single entry to container. More...
 
virtual uint64_t nextRecordId () override final
 Number of next record in the container (=size if no delete is allowed) More...
 
virtual void useNextRecordId (uint64_t nextID) override final
 Suggest next Record ID for tbe next object written - used only with synced indexes. More...
 
virtual pool::DbStatus select (pool::DbSelect &sel) override final
 Define selection. More...
 
virtual pool::DbStatus fetch (pool::DbSelect &sel) override final
 Fetch next object address of the selection to set token. More...
 
virtual pool::DbStatus transAct (pool::Transaction::Action action) override final
 Execute transaction action. More...
 
virtual pool::DbStatus store (const void *object, pool::DbContainer &cntH, pool::ShapeH shape) override final
 Store object in location. More...
 
virtual void release () override
 Release instance (Abstract interfaces do not expose destructor!) More...
 
virtual std::string name () const override
 Get container name. More...
 
virtual DbStatus allocate (DbContainer &cntH, const void *object, ShapeH shape, Token::OID_t &oid) override
 In place allocation of object location. More...
 
virtual DbStatus fetch (const Token::OID_t &linkH, Token::OID_t &stmt)
 Fetch refined object address. Default implementation returns identity. More...
 
virtual DbStatus load (void **ptr, ShapeH shape, const Token::OID_t &lnkH, Token::OID_t &oid, bool any_next) override
 Find object within the container and load it into memory. More...
 
virtual DbStatus clearStack ()
 Clear Transaction stack containing transaction requests. More...
 
bool msgLvl (const MSG::Level lvl) const
 Test the output level. More...
 
MsgStream & msg () const
 The standard message stream. More...
 
MsgStream & msg (const MSG::Level lvl) const
 The standard message stream. More...
 
void setLevel (MSG::Level lvl)
 Change the current logging level. More...
 

Protected Types

typedef std::vector< DbActionActionList
 

Protected Member Functions

int stackType () const
 Access accumulated stack entry types. More...
 
size_t stackSize () const
 Access stack size. More...
 
ActionList::value_type * stackEntry (size_t which)
 Internal: get access to stack entry. More...
 
virtual DbStatus commitTransaction ()
 Execute object modification requests during a transaction. More...
 

Protected Attributes

std::string m_name
 Container name. More...
 
bool m_canUpdate
 Flag to indicate if object updates are supported. More...
 
bool m_canDestroy
 Flag to indicate if object removals are supported. More...
 

Private Member Functions

pool::DbStatus initObjectFieldDesc (FieldDesc &dsc)
 Init a field description for an object (i.e. find TClass etc.) More...
 
void initMessaging () const
 Initialize our message level and MessageSvc. More...
 

Private Attributes

const pool::DbTypeInfom_type {}
 reference to exact type description More...
 
std::vector< FieldDescm_fieldDescs
 List of field descriptors. More...
 
pool::DbDatabase m_dbH
 Parent Database handle. More...
 
pool::RootDatabasem_rootDb
 Root database file reference. More...
 
int m_ioBytes
 Number of bytes written/read during last operation. Set to -1 if it failed. More...
 
bool m_isDirty
 flag set on writing to prevent double writes in the same commit More...
 
uint64_t m_index
 
uint64_t m_indexSize
 
int64_t m_indexBump
 
const uint32_t m_indexMulti
 
RootStorageSvc::RNTupleWriterHelperm_ntupleWriter = nullptr
 Internal cache of the RNTupleWriterHelper. More...
 
ROOT::RNTupleReader * m_ntupleReader {}
 Internal cache of the native RNTupleReader. More...
 
std::unique_ptr< RootAuxDynIO::IFactoryToolm_auxDynTool
 Factory object from AuxDynIO plugin that creates AuxDyn readers and writers. More...
 
ActionList m_stack
 Transaction fifo storage for writing. More...
 
size_t m_size
 Current size of the transaction stack. More...
 
size_t m_writeSize
 Number of objects to be written out during open transaction. More...
 
int m_stackType
 Accumulated stack entry types. More...
 
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...
 
std::atomic_flag m_initialized ATLAS_THREAD_SAFE = ATOMIC_FLAG_INIT
 Messaging initialized (initMessaging) More...
 

Detailed Description

Description: RNTUPLE specific implementation of Database Container.

Definition at line 43 of file RNTupleContainer.h.

Member Typedef Documentation

◆ ActionList

typedef std::vector< DbAction > pool::DbContainerImp::ActionList
protectedinherited

Definition at line 64 of file DbContainerImp.h.

Constructor & Destructor Documentation

◆ RNTupleContainer()

RNTupleContainer::RNTupleContainer ( const std::string &  name)
explicit

◆ ~RNTupleContainer()

virtual RNTupleContainer::~RNTupleContainer ( )
virtual

Member Function Documentation

◆ allocate()

virtual DbStatus pool::DbContainerImp::allocate ( DbContainer cntH,
const void *  object,
ShapeH  shape,
Token::OID_t oid 
)
overridevirtualinherited

In place allocation of object location.

Implements pool::IDbContainer.

◆ checkAccess()

virtual pool::DbStatus RNTupleContainer::checkAccess ( pool::DbDatabase dbH,
const std::string &  nam 
) const
finaloverridevirtual

Check if we can access the container for reading with the given type.

Implements pool::IDbContainer.

◆ clearDirty()

void RNTupleContainer::clearDirty ( )
inline

Clear the dirty status (used after containing TTree was Filled)

Definition at line 147 of file RNTupleContainer.h.

147 { m_isDirty = false; }

◆ clearStack()

virtual DbStatus pool::DbContainerImp::clearStack ( )
virtualinherited

Clear Transaction stack containing transaction requests.

◆ close()

virtual pool::DbStatus RNTupleContainer::close ( )
finaloverridevirtual

Close the container and deallocate resources.

Reimplemented from pool::DbContainerImp.

◆ commitTransaction()

virtual DbStatus pool::DbContainerImp::commitTransaction ( )
protectedvirtualinherited

Execute object modification requests during a transaction.

◆ fetch() [1/2]

virtual DbStatus pool::DbContainerImp::fetch ( const Token::OID_t linkH,
Token::OID_t stmt 
)
virtualinherited

Fetch refined object address. Default implementation returns identity.

Reimplemented in pool::RootTreeContainer, and pool::RootKeyContainer.

◆ fetch() [2/2]

virtual pool::DbStatus RNTupleContainer::fetch ( pool::DbSelect sel)
finaloverridevirtual

Fetch next object address of the selection to set token.

Reimplemented from pool::DbContainerImp.

◆ getName()

const std::string& RNTupleContainer::getName ( ) const
inline

Return the name of the container.

Definition at line 140 of file RNTupleContainer.h.

140 { return m_name; }

◆ getOption()

virtual pool::DbStatus RNTupleContainer::getOption ( pool::DbOption opt)
finaloverridevirtual

Access options.

Parameters
opt[IN] Reference to option object.
Returns
DbStatus code indicating success or failure.

Reimplemented from pool::DbContainerImp.

◆ 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  // If user did not set an explicit level, set a default
43  if (m_lvl == MSG::NIL) {
44  m_lvl = m_imsg ?
45  static_cast<MSG::Level>( m_imsg.load()->outputLevel(m_nm) ) :
46  MSG::INFO;
47  }
48 }

◆ initObjectFieldDesc()

pool::DbStatus RNTupleContainer::initObjectFieldDesc ( FieldDesc dsc)
private

Init a field description for an object (i.e. find TClass etc.)

◆ isDirty()

bool RNTupleContainer::isDirty ( ) const
inline

Return true if this branch container was updated and it's TTree needs to be Filled.

Definition at line 144 of file RNTupleContainer.h.

144 { return m_isDirty; }

◆ load()

virtual DbStatus pool::DbContainerImp::load ( void **  ptr,
ShapeH  shape,
const Token::OID_t lnkH,
Token::OID_t oid,
bool  any_next 
)
overridevirtualinherited

Find object within the container and load it into memory.

Parameters
ptr[IN/OUT] ROOT-style address of the pointer to object
shape[IN] Object type
linkH[IN] Preferred object OID
oid[OUT] Actual object OID
any_next[IN] On selection, objects may be skipped. If objects are skipped, the actual oid will differ from the preferred oid.
Returns
Status code indicating success or failure.

Implements pool::IDbContainer.

Reimplemented in pool::RootKeyContainer.

◆ loadObject()

virtual pool::DbStatus RNTupleContainer::loadObject ( void **  ptr,
pool::ShapeH  shape,
Token::OID_t oid 
)
finaloverridevirtual

Find object by object identifier and load it into memory.

Parameters
ptr[IN/OUT] address of the pointer to object
shape[IN] Object Shape
oid[OUT] Object OID
Returns
Status code indicating success or failure.

Implements pool::DbContainerImp.

◆ msg() [1/2]

MsgStream & AthMessaging::msg ( ) const
inlineinherited

The standard message stream.

Returns a reference to the default message stream May not be invoked before sysInitialize() has been invoked.

Definition at line 163 of file AthMessaging.h.

164 {
165  MsgStream* ms = m_msg_tls.get();
166  if (!ms) {
167  if (!m_initialized.test_and_set()) initMessaging();
168  ms = new MsgStream(m_imsg,m_nm);
169  m_msg_tls.reset( ms );
170  }
171 
172  ms->setLevel (m_lvl);
173  return *ms;
174 }

◆ msg() [2/2]

MsgStream & AthMessaging::msg ( const MSG::Level  lvl) const
inlineinherited

The standard message stream.

Returns a reference to the default message stream May not be invoked before sysInitialize() has been invoked.

Definition at line 178 of file AthMessaging.h.

179 { return msg() << lvl; }

◆ msgLvl()

bool AthMessaging::msgLvl ( const MSG::Level  lvl) const
inlineinherited

Test the output level.

Parameters
lvlThe message level to test against
Returns
boolean Indicating if messages at given level will be printed
Return values
trueMessages at level "lvl" will be printed

Definition at line 151 of file AthMessaging.h.

152 {
153  if (m_lvl <= lvl) {
154  msg() << lvl;
155  return true;
156  } else {
157  return false;
158  }
159 }

◆ name()

virtual std::string pool::DbContainerImp::name ( ) const
inlineoverridevirtualinherited

Get container name.

Implements pool::IDbContainer.

Definition at line 107 of file DbContainerImp.h.

108  { return m_name; }

◆ nextRecordId()

virtual uint64_t RNTupleContainer::nextRecordId ( )
finaloverridevirtual

Number of next record in the container (=size if no delete is allowed)

Reimplemented from pool::DbContainerImp.

◆ open()

virtual pool::DbStatus RNTupleContainer::open ( pool::DbDatabase dbH,
const std::string &  nam,
const pool::DbTypeInfo info,
pool::DbAccessMode  mod 
)
finaloverridevirtual

Open the container for object access.

Implements pool::IDbContainer.

◆ release()

virtual void pool::DbContainerImp::release ( )
inlineoverridevirtualinherited

Release instance (Abstract interfaces do not expose destructor!)

Implements pool::IDbContainer.

Definition at line 103 of file DbContainerImp.h.

103 { delete this; }

◆ select()

virtual pool::DbStatus RNTupleContainer::select ( pool::DbSelect sel)
finaloverridevirtual

Define selection.

Implements pool::IDbContainer.

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

◆ setOption()

virtual pool::DbStatus RNTupleContainer::setOption ( const pool::DbOption opt)
finaloverridevirtual

Set options.

Parameters
opt[IN] Reference to option object.
Returns
DbStatus code indicating success or failure.

Reimplemented from pool::DbContainerImp.

◆ size()

virtual uint64_t RNTupleContainer::size ( )
finaloverridevirtual

Number of entries within the container.

Reimplemented from pool::DbContainerImp.

◆ stackEntry()

ActionList::value_type* pool::DbContainerImp::stackEntry ( size_t  which)
inlineprotectedinherited

Internal: get access to stack entry.

Definition at line 92 of file DbContainerImp.h.

93  { return (which <= m_size) ? &(*(m_stack.begin()+which)) : 0; }

◆ stackSize()

size_t pool::DbContainerImp::stackSize ( ) const
inlineprotectedinherited

Access stack size.

Definition at line 89 of file DbContainerImp.h.

90  { return m_size; }

◆ stackType()

int pool::DbContainerImp::stackType ( ) const
inlineprotectedinherited

Access accumulated stack entry types.

Definition at line 86 of file DbContainerImp.h.

87  { return m_stackType; }

◆ store()

virtual pool::DbStatus RNTupleContainer::store ( const void *  object,
pool::DbContainer cntH,
pool::ShapeH  shape 
)
finaloverridevirtual

Store object in location.

Reimplemented from pool::DbContainerImp.

◆ transAct()

virtual pool::DbStatus RNTupleContainer::transAct ( pool::Transaction::Action  action)
finaloverridevirtual

Execute transaction action.

Reimplemented from pool::DbContainerImp.

◆ useNextRecordId()

virtual void RNTupleContainer::useNextRecordId ( uint64_t  )
finaloverridevirtual

Suggest next Record ID for tbe next object written - used only with synced indexes.

Reimplemented from pool::DbContainerImp.

◆ writeObject()

virtual pool::DbStatus RNTupleContainer::writeObject ( ActionList::value_type &  )
finaloverridevirtual

Commit single entry to container.

Reimplemented from pool::DbContainerImp.

Member Data Documentation

◆ ATLAS_THREAD_SAFE

std::atomic_flag m_initialized AthMessaging::ATLAS_THREAD_SAFE = ATOMIC_FLAG_INIT
mutableprivateinherited

Messaging initialized (initMessaging)

Definition at line 141 of file AthMessaging.h.

◆ m_auxDynTool

std::unique_ptr<RootAuxDynIO::IFactoryTool> RNTupleContainer::m_auxDynTool
private

Factory object from AuxDynIO plugin that creates AuxDyn readers and writers.

Definition at line 104 of file RNTupleContainer.h.

◆ m_canDestroy

bool pool::DbContainerImp::m_canDestroy
protectedinherited

Flag to indicate if object removals are supported.

Definition at line 81 of file DbContainerImp.h.

◆ m_canUpdate

bool pool::DbContainerImp::m_canUpdate
protectedinherited

Flag to indicate if object updates are supported.

Definition at line 79 of file DbContainerImp.h.

◆ m_dbH

pool::DbDatabase RNTupleContainer::m_dbH
private

Parent Database handle.

Definition at line 84 of file RNTupleContainer.h.

◆ m_fieldDescs

std::vector<FieldDesc> RNTupleContainer::m_fieldDescs
private

List of field descriptors.

Definition at line 82 of file RNTupleContainer.h.

◆ m_imsg

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

MessageSvc pointer.

Definition at line 135 of file AthMessaging.h.

◆ m_index

uint64_t RNTupleContainer::m_index
private

Definition at line 92 of file RNTupleContainer.h.

◆ m_indexBump

int64_t RNTupleContainer::m_indexBump
private

Definition at line 94 of file RNTupleContainer.h.

◆ m_indexMulti

const uint32_t RNTupleContainer::m_indexMulti
private

Definition at line 95 of file RNTupleContainer.h.

◆ m_indexSize

uint64_t RNTupleContainer::m_indexSize
private

Definition at line 93 of file RNTupleContainer.h.

◆ m_ioBytes

int RNTupleContainer::m_ioBytes
private

Number of bytes written/read during last operation. Set to -1 if it failed.

Definition at line 88 of file RNTupleContainer.h.

◆ m_isDirty

bool RNTupleContainer::m_isDirty
private

flag set on writing to prevent double writes in the same commit

Definition at line 90 of file RNTupleContainer.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_name

std::string pool::DbContainerImp::m_name
protectedinherited

Container name.

Definition at line 77 of file DbContainerImp.h.

◆ m_nm

std::string AthMessaging::m_nm
privateinherited

Message source name.

Definition at line 129 of file AthMessaging.h.

◆ m_ntupleReader

ROOT::RNTupleReader* RNTupleContainer::m_ntupleReader {}
private

Internal cache of the native RNTupleReader.

Definition at line 101 of file RNTupleContainer.h.

◆ m_ntupleWriter

RootStorageSvc::RNTupleWriterHelper* RNTupleContainer::m_ntupleWriter = nullptr
private

Internal cache of the RNTupleWriterHelper.

Definition at line 98 of file RNTupleContainer.h.

◆ m_rootDb

pool::RootDatabase* RNTupleContainer::m_rootDb
private

Root database file reference.

Definition at line 86 of file RNTupleContainer.h.

◆ m_size

size_t pool::DbContainerImp::m_size
privateinherited

Current size of the transaction stack.

Definition at line 70 of file DbContainerImp.h.

◆ m_stack

ActionList pool::DbContainerImp::m_stack
privateinherited

Transaction fifo storage for writing.

Definition at line 68 of file DbContainerImp.h.

◆ m_stackType

int pool::DbContainerImp::m_stackType
privateinherited

Accumulated stack entry types.

Definition at line 74 of file DbContainerImp.h.

◆ m_type

const pool::DbTypeInfo* RNTupleContainer::m_type {}
private

reference to exact type description

Definition at line 80 of file RNTupleContainer.h.

◆ m_writeSize

size_t pool::DbContainerImp::m_writeSize
privateinherited

Number of objects to be written out during open transaction.

Definition at line 72 of file DbContainerImp.h.


The documentation for this class was generated from the following file:
AthMessaging::m_lvl
std::atomic< MSG::Level > m_lvl
Current logging level.
Definition: AthMessaging.h:138
pool::DbContainerImp::m_size
size_t m_size
Current size of the transaction stack.
Definition: DbContainerImp.h:70
pool::DbContainerImp::m_name
std::string m_name
Container name.
Definition: DbContainerImp.h:77
AthMessaging::m_imsg
std::atomic< IMessageSvc * > m_imsg
MessageSvc pointer.
Definition: AthMessaging.h:135
Athena::getMessageSvc
IMessageSvc * getMessageSvc(bool quiet=false)
Definition: getMessageSvc.cxx:20
RNTupleContainer::m_isDirty
bool m_isDirty
flag set on writing to prevent double writes in the same commit
Definition: RNTupleContainer.h:90
TrigConf::MSGTC::Level
Level
Definition: Trigger/TrigConfiguration/TrigConfBase/TrigConfBase/MsgStream.h:21
python.Utils.unixtools.which
def which(filename, env=os.environ)
UNIX-style which ---------------------------------------------------------—.
Definition: unixtools.py:39
AthMessaging::msg
MsgStream & msg() const
The standard message stream.
Definition: AthMessaging.h:163
pool::DbContainerImp::m_stackType
int m_stackType
Accumulated stack entry types.
Definition: DbContainerImp.h:74
pool::DbContainerImp::m_stack
ActionList m_stack
Transaction fifo storage for writing.
Definition: DbContainerImp.h:68
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
TrigConf::MSGTC::NIL
@ NIL
Definition: Trigger/TrigConfiguration/TrigConfBase/TrigConfBase/MsgStream.h:22
AthMessaging::initMessaging
void initMessaging() const
Initialize our message level and MessageSvc.
Definition: AthMessaging.cxx:39
AthMessaging::m_msg_tls
boost::thread_specific_ptr< MsgStream > m_msg_tls
MsgStream instance (a std::cout like with print-out levels)
Definition: AthMessaging.h:132
python.SystemOfUnits.ms
float ms
Definition: SystemOfUnits.py:148