Test code: associate from an Obj1 to a set of Obj2. More...

#include <ToObj2MultiAssociationTool.h>

Inheritance diagram for D3PDTest::ToObj2MultiAssociationTool:

Collaboration diagram for D3PDTest::ToObj2MultiAssociationTool:

Public Types
typedef D3PD::MultiAssociationTool< D3PD::Types< Obj1, Obj2 >, Obj2 >	Base

Public Member Functions
	ToObj2MultiAssociationTool (const std::string &type, const std::string &name, const IInterface *parent)
	Standard Gaudi tool constructor. More...

virtual StatusCode	reset (const Obj1 &p)
	Start the iteration for a new association. More...

virtual StatusCode	reset (const Obj2 &p)
	Start the iteration for a new association. More...

virtual const Obj2 *	next ()
	Return a pointer to the next element in the association. More...

virtual const std::type_info &	fromTypeinfo () const
	Return the `std::type_info` for the source of the association. More...

virtual const std::type_info &	fromTypeinfo () const =0
	Return the `std::type_info` for the source of the association. More...

virtual StatusCode	resetUntyped (const void *p)
	Start the iteration for a new association. More...

virtual StatusCode	reset (const D3PD::Types< Obj1, Obj2 > &p)=0
	Start the iteration for a new association. More...

virtual const std::type_info &	elementTypeinfo () const
	Return the element type for the target of the association. More...

virtual const void *	nextUntyped ()
	Return a pointer to the next element in the association. More...

virtual void	releaseElementUntyped (const void *p)
	Release an object retrieved from the association. More...

virtual void	releaseElement (const Obj2 *p)
	Release an object retrieved from the association. More...

	MultiAssociationToolImpl (const std::string &type, const std::string &name, const IInterface *parent)
	Standard Gaudi tool constructor. More...

virtual StatusCode	configureD3PD (IAddVariable *tree, const std::type_info &ti)
	Configure during initialization: type-check. More...

StatusCode	configureD3PD (IAddVariable *tree)
	Configure the parent tree. More...

virtual StatusCode	book ()
	Create any needed tuple variables. More...

virtual StatusCode	addVariable (const std::string &name, const std::type_info &ti, void &ptr, const std::string &docstring="", const void defval=0)
	Add a variable to the tuple. More...

template<class T >
StatusCode	addVariable (const std::string &name, T *&ptr, const std::string &docstring="")
	Make the template implementation from `IAddVariable` visible. More...

template<class T , class U >
StatusCode	addVariable (const std::string &name, T *&ptr, const std::string &docstring, const U &defval)
	Make the template implementation from `IAddVariable` visible. More...

virtual StatusCode	addVariable (const std::string &name, const std::type_info &ti, void &ptr, const std::string &docstring="", const void defval=0)=0
	Make the template implementation from `IAddVariable` visible. More...

template<class T >
StatusCode	addVariable (const std::string &name, T *&ptr, const std::string &docstring="")
	Add a variable to the tuple. More...

template<class T , class U >
StatusCode	addVariable (const std::string &name, T *&ptr, const std::string &docstring, const U &defval)
	Add a variable to the tuple. More...

virtual StatusCode	addDimensionedVariable (const std::string &name, const std::type_info &ti, void &ptr, const std::string &dim, const std::string &docstring="", const void defval=0)
	Add a variable to the tuple. More...

template<class T >
StatusCode	addDimensionedVariable (const std::string &name, T *&ptr, const std::string &dim, const std::string &docstring="")
	Add a variable to the tuple. More...

template<class T , class U >
StatusCode	addDimensionedVariable (const std::string &name, T *&ptr, const std::string &dim, const std::string &docstring, const U &defval)
	Add a variable to the tuple. More...

virtual StatusCode	addDimensionedVariable (const std::string &name, const std::type_info &ti, void &ptr, const std::string &dim, const std::string &docstring="", const void defval=0)=0
	Add a variable to the tuple. More...

template<class T >
StatusCode	addDimensionedVariable (const std::string &name, T *&ptr, const std::string &dim, const std::string &docstring="")
	Add a variable to the tuple. More...

template<class T , class U >
StatusCode	addDimensionedVariable (const std::string &name, T *&ptr, const std::string &dim, const std::string &docstring, const U &defval)
	Add a variable to the tuple. More...

Protected Member Functions
const void *	doConversion (const void *p)
	Helper to convert pointers to source objects. More...

StatusCode	configureMulti (D3PD::IAddVariable tree, const std::type_info &ti, const std::vector< const std::type_info > &tis, size_t &which)
	Configure during initialization: type-check. More...

Protected Attributes
ObjectMetadata	m_metadata
	Metadata about the variables created by this object. More...

Private Attributes
int	m_which

std::vector< Obj2 >::const_iterator	m_it

std::vector< Obj2 >::const_iterator	m_end

std::vector< Obj2 >	m_tmpvec

std::string	m_prefix
	Parameter: source object prefix. More...

std::string	m_blockName
	Property: the name of this block. More...

TypeConverter	m_inputConverter
	Helper to convert source object pointers. More...

const std::string &	m_suffix
	Reference to the variable suffix. More...

IAddVariable *	m_tree
	Reference to the block name. More...

Static Private Attributes
static const std::string	s_emptyString
	Used to provide a default value for blockName. More...

Detailed Description

Test code: associate from an Obj1 to a set of Obj2.

Definition at line 34 of file ToObj2MultiAssociationTool.h.

Member Typedef Documentation

◆ Base

typedef D3PD::MultiAssociationTool<D3PD::Types<Obj1, Obj2>, Obj2> D3PDTest::ToObj2MultiAssociationTool::Base

Definition at line 38 of file ToObj2MultiAssociationTool.h.

Constructor & Destructor Documentation

◆ ToObj2MultiAssociationTool()

D3PDTest::ToObj2MultiAssociationTool::ToObj2MultiAssociationTool	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent
	)

Standard Gaudi tool constructor.

Parameters

type	The name of the tool type.
name	The tool name.
parent	The tool's Gaudi parent.

Definition at line 26 of file ToObj2MultiAssociationTool.cxx.

   : Base (type, name, parent)
 {
   declareProperty ("Which", m_which = 0);
 }

Member Function Documentation

◆ addDimensionedVariable() [1/6]

StatusCode D3PD::AddVariable::addDimensionedVariable	(	const std::string &	name,
		const std::type_info &	ti,
		void *&	ptr,
		const std::string &	dim,
		const std::string &	docstring = `""`,
		const void *	defval = `0`
	)

virtualinherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
type	The type of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
dim	Dimension for the variable. (Presently unimplemented!)
docstring	Documentation string for this variable.
defval	Pointer to the default value to use for this variable. Null for no default (generally means to fill with zeros). Of the type given by `ti`. Only works for basic types.

If called from the constructor, the only effect is to clear ptr.

Implements D3PD::IAddVariable.

Definition at line 123 of file AddVariable.cxx.

 {
   if (!m_tree) {
     // Called from constructor --- just initialize pointer.
     ptr = 0;
     return StatusCode::SUCCESS;
   }
  
   CHECK( m_metadata.addDimensionedVariable( m_prefix + name + m_suffix,
                                             ti, ptr, dim,
                                             docstring, defval ) );
   return m_tree->addDimensionedVariable (m_prefix + name + m_suffix,
                                          ti, ptr, dim,
                                          docstring, defval);
 }

◆ addDimensionedVariable() [2/6]

virtual StatusCode D3PD::IAddVariable::addDimensionedVariable

inherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
type	The type of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
dim	Dimension for the variable. (Presently unimplemented!)
docstring	Documentation string for this variable.
defval	Pointer to the default value to use for this variable. Null for no default (generally means to fill with zeros). Of the type given by `ti`. Only works for basic types.

If called from the constructor, the only effect is to clear ptr.

◆ addDimensionedVariable() [3/6]

template<class T , class U >

StatusCode D3PD::IAddVariable::addDimensionedVariable	(	class T	,
		class U
	)

inherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
dim	Dimension for the variable. (Presently unimplemented!)
docstring	Documentation string for this variable.
defval	Pointer to the default value to use for this variable. Only works for basic types.

If called from the constructor, the only effect is to clear ptr.

◆ addDimensionedVariable() [4/6]

template<class T , class U >

StatusCode D3PD::IAddVariable::addDimensionedVariable	(	const std::string &	name,
		T *&	ptr,
		const std::string &	dim,
		const std::string &	docstring,
		const U &	defval
	)

inherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
dim	Dimension for the variable. (Presently unimplemented!)
docstring	Documentation string for this variable.
defval	Pointer to the default value to use for this variable. Only works for basic types.

If called from the constructor, the only effect is to clear ptr.

◆ addDimensionedVariable() [5/6]

template<class T >

StatusCode D3PD::IAddVariable::addDimensionedVariable ( class T )

inherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
dim	Dimension for the variable. (Presently unimplemented!)
docstring	Documentation string for this variable.

If called from the constructor, the only effect is to clear ptr.

◆ addDimensionedVariable() [6/6]

template<class T >

StatusCode D3PD::IAddVariable::addDimensionedVariable	(	const std::string &	name,
		T *&	ptr,
		const std::string &	dim,
		const std::string &	docstring = `""`
	)

inherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
dim	Dimension for the variable. (Presently unimplemented!)
docstring	Documentation string for this variable.

If called from the constructor, the only effect is to clear ptr.

◆ addVariable() [1/6]

StatusCode D3PD::AddVariable::addVariable	(	const std::string &	name,
		const std::type_info &	ti,
		void *&	ptr,
		const std::string &	docstring = `""`,
		const void *	defval = `0`
	)

virtualinherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
type	The type of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
docstring	Documentation string for this variable.
defval	Pointer to the default value to use for this variable. Null for no default (generally means to fill with zeros). Of the type given by `ti`. Only works for basic types.

If called from the constructor, the only effect is to clear ptr.

Implements D3PD::IAddVariable.

Definition at line 85 of file AddVariable.cxx.

 {
   if (!m_tree) {
     // Called from constructor --- just initialize pointer.
     ptr = 0;
     return StatusCode::SUCCESS;
   }
  
   CHECK( m_metadata.addVariable( m_prefix + name + m_suffix,
                                  ti, ptr, docstring, defval ) );
   return m_tree->addVariable (m_prefix + name + m_suffix,
                               ti, ptr, docstring, defval);
 }

◆ addVariable() [2/6]

virtual StatusCode D3PD::IAddVariable::addVariable

inherited

Make the template implementation from IAddVariable visible.

◆ addVariable() [3/6]

template<class T , class U >

StatusCode D3PD::IAddVariable::addVariable	(	class T	,
		class U
	)

inherited

Make the template implementation from IAddVariable visible.

◆ addVariable() [4/6]

template<class T , class U >

StatusCode D3PD::IAddVariable::addVariable	(	const std::string &	name,
		T *&	ptr,
		const std::string &	docstring,
		const U &	defval
	)

inherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
docstring	Documentation string for this variable.
defval	Pointer to the default value to use for this variable. Only works for basic types.

If called from the constructor, the only effect is to clear ptr.

◆ addVariable() [5/6]

template<class T >

StatusCode D3PD::IAddVariable::addVariable ( class T )

inherited

Make the template implementation from IAddVariable visible.

◆ addVariable() [6/6]

template<class T >

StatusCode D3PD::IAddVariable::addVariable	(	const std::string &	name,
		T *&	ptr,
		const std::string &	docstring = `""`
	)

inherited

Add a variable to the tuple.

Parameters

name	The name of the variable.
ptr	Pointer to the type of the variable. The pointer need not be initialized; the D3PD software will set the pointer prior to calling `fill()`.
docstring	Documentation string for this variable.

If called from the constructor, the only effect is to clear ptr.

◆ book()

StatusCode D3PD::MultiAssociationToolImpl::book ( )

virtualinherited

Create any needed tuple variables.

This is called at the start of the first event. The default implementation is a no-op.

Reimplemented in D3PD::ElectronJetDRAssociator, and D3PD::VertexTrackParticleAssociationTool.

Definition at line 92 of file MultiAssociationToolImpl.cxx.

 {
   return StatusCode::SUCCESS;
 }

◆ configureD3PD() [1/2]

StatusCode D3PD::AddVariable::configureD3PD ( IAddVariable * tree )

inherited

Configure the parent tree.

Parameters

tree	The parent `IAddVariable` instance.

Definition at line 61 of file AddVariable.cxx.

 {
   m_tree = tree;
   m_metadata.clear();
   return StatusCode::SUCCESS;
 }

◆ configureD3PD() [2/2]

StatusCode D3PD::MultiAssociationToolImpl::configureD3PD	(	IAddVariable *	tree,
		const std::type_info &	ti
	)

virtualinherited

Configure during initialization: type-check.

Parameters

tree	Our parent for tuple making.
ti	Gives the type of the object being passed to `resetUntyped`.

configureD3PD should check that the type of the object coming as input (to getUntyped) is compatible with what it expects, and raise an error otherwise.

Reimplemented in D3PD::ElectronJetDRAssociator, and D3PD::MultiAssociationTool< Types< T0 >, TO_T >.

Definition at line 51 of file MultiAssociationToolImpl.cxx.

 {
   CHECK( AddVariable::configureD3PD (tree) );
   CHECK( m_inputConverter.init (ti, fromTypeinfo()) );
   return StatusCode::SUCCESS;
 }

◆ configureMulti()

StatusCode D3PD::MultiAssociationToolImpl::configureMulti	(	D3PD::IAddVariable *	tree,
		const std::type_info &	ti,
		const std::vector< const std::type_info * > &	tis,
		size_t &	which
	)

protectedinherited

Configure during initialization: type-check.

Alternate implementation for the case where we have to choose among multiple possible input types.

Parameters

	tree	Our parent for tuple making.
	ti	Gives the type of the object being passed to `getUntyped`.
	tis	List of possible input types that we can accept.
[out]	which	Index of the accepted type.

configureMulti should check that the type of the object coming as input (to getUntyped) is compatible with what it expects, and raise an error otherwise.

Definition at line 74 of file MultiAssociationToolImpl.cxx.

 {
   CHECK( AddVariable::configureD3PD (tree) );
   CHECK( m_inputConverter.init (ti, tis, which) );
   return StatusCode::SUCCESS;
 }

◆ doConversion()

const void * D3PD::MultiAssociationToolImpl::doConversion ( const void * p )

protectedinherited

Helper to convert pointers to source objects.

Parameters

p	Source object, as a pointer to the type passed to `configureD3PD`. return Source object, as a pointer to the type given by `fromTypeinfo`.

Definition at line 104 of file MultiAssociationToolImpl.cxx.

 {
   if (!p) return 0;
   const void* pp = m_inputConverter.convertUntyped (p);
   if (!pp) {
     REPORT_MESSAGE (MSG::WARNING)
       << "Pointer conversion from " << m_inputConverter.srcName() << " to "
       << m_inputConverter.dstName() << "failed.";
     return 0;
   }
   return pp;
 }

◆ elementTypeinfo()

virtual const std::type_info& D3PD::MultiAssociationToolTo< Obj2 >::elementTypeinfo ( ) const

virtualinherited

Return the element type for the target of the association.

I.e., nextUntyped returns a pointer to this type.

◆ fromTypeinfo() [1/2]

virtual const std::type_info& D3PD::MultiAssociationTool< D3PD::Types< Obj1, Obj2 > , Obj2 >::fromTypeinfo

virtualinherited

Return the std::type_info for the source of the association.

◆ fromTypeinfo() [2/2]

virtual const std::type_info& D3PD::MultiAssociationToolImpl::fromTypeinfo ( ) const

pure virtualinherited

Return the std::type_info for the source of the association.

Implemented in D3PD::MultiAssociationTool< Types< T0 >, TO_T >, and D3PD::MultiAssociationTool< FROM_T, TO_T >.

◆ MultiAssociationToolImpl()

D3PD::MultiAssociationToolImpl::MultiAssociationToolImpl

inherited

Standard Gaudi tool constructor.

Parameters

type	The name of the tool type.
name	The tool name.
parent	The tool's Gaudi parent.

Definition at line 39 of file MultiAssociationToolImpl.cxx.

   : base_class (type, name, parent),
     AddVariable (m_prefix, m_blockName)
 {
   declareProperty ("Prefix", m_prefix = "",
                    "Tuple variable prefix for this block.");
   declareProperty ("BlockName", m_blockName = this->name(),
                    "The name of this block.");
 }

◆ next()

const Obj2 * D3PDTest::ToObj2MultiAssociationTool::next ( )

virtual

Return a pointer to the next element in the association.

Return 0 when the association has been exhausted.

Implements D3PD::MultiAssociationToolTo< Obj2 >.

Definition at line 73 of file ToObj2MultiAssociationTool.cxx.

 {
   if (m_it == m_end)
     return 0;
   const Obj2* p = &*m_it;
   ++m_it;
   return p;
 }

◆ nextUntyped()

virtual const void* D3PD::MultiAssociationToolTo< Obj2 >::nextUntyped ( )

virtualinherited

Return a pointer to the next element in the association.

Return 0 when the association has been exhausted.

◆ releaseElement()

virtual void D3PD::MultiAssociationToolTo< Obj2 >::releaseElement ( const TO_T * p )

virtualinherited

Release an object retrieved from the association.

Parameters

p	The object to release.

Call this when you are done with the object returned by next(). The default implementation is a no-op, but if the association dynamically allocated the object which it returned, this gives it a chance to free it.

◆ releaseElementUntyped()

virtual void D3PD::MultiAssociationToolTo< Obj2 >::releaseElementUntyped ( const void * p )

virtualinherited

Release an object retrieved from the association.

Parameters

p	The object to release.

Call this when you are done with the object returned by nextUntyped(). The default implementation is a no-op, but if the association dynamically allocated the object which it returned, this gives it a chance to free it.

◆ reset() [1/3]

virtual StatusCode D3PD::MultiAssociationTool< D3PD::Types< Obj1, Obj2 > , Obj2 >::reset ( const D3PD::Types< Obj1, Obj2 > & p )

pure virtualinherited

Start the iteration for a new association.

Parameters

p	The object from which to associate.

◆ reset() [2/3]

StatusCode D3PDTest::ToObj2MultiAssociationTool::reset ( const Obj1 & p )

virtual

Start the iteration for a new association.

Parameters

p	The object from which to associate.

Definition at line 40 of file ToObj2MultiAssociationTool.cxx.

 {
   if (m_which == 0) {
     m_it = p.m_vo2.begin();
     m_end = p.m_vo2.end();
   }
   else {
     m_it = p.m_vo3.begin();
     m_end = p.m_vo3.end();
   }
   return StatusCode::SUCCESS;
 }

◆ reset() [3/3]

StatusCode D3PDTest::ToObj2MultiAssociationTool::reset ( const Obj2 & p )

virtual

Start the iteration for a new association.

Parameters

p	The object from which to associate.

Definition at line 58 of file ToObj2MultiAssociationTool.cxx.

 {
   m_tmpvec.clear();
   m_tmpvec.push_back (p);
   m_it = m_tmpvec.begin();
   m_end = m_tmpvec.end();
   return StatusCode::SUCCESS;
 }

◆ resetUntyped()

virtual StatusCode D3PD::MultiAssociationTool< D3PD::Types< Obj1, Obj2 > , Obj2 >::resetUntyped ( const void * p )

virtualinherited

Start the iteration for a new association.

Parameters

p	The object from which to associate.

Member Data Documentation

◆ m_blockName

std::string D3PD::MultiAssociationToolImpl::m_blockName

privateinherited

Property: the name of this block.

Definition at line 122 of file MultiAssociationToolImpl.h.

◆ m_end

std::vector<Obj2>::const_iterator D3PDTest::ToObj2MultiAssociationTool::m_end

private

Definition at line 78 of file ToObj2MultiAssociationTool.h.

◆ m_inputConverter

TypeConverter D3PD::MultiAssociationToolImpl::m_inputConverter

privateinherited

Helper to convert source object pointers.

Definition at line 125 of file MultiAssociationToolImpl.h.

◆ m_it

std::vector<Obj2>::const_iterator D3PDTest::ToObj2MultiAssociationTool::m_it

private

Definition at line 77 of file ToObj2MultiAssociationTool.h.

◆ m_metadata

ObjectMetadata D3PD::AddVariable::m_metadata

protectedinherited

Metadata about the variables created by this object.

Definition at line 129 of file AddVariable.h.

◆ m_prefix

std::string D3PD::MultiAssociationToolImpl::m_prefix

privateinherited

Parameter: source object prefix.

Definition at line 119 of file MultiAssociationToolImpl.h.

◆ m_suffix

const std::string& D3PD::AddVariable::m_suffix

privateinherited

Reference to the variable suffix.

Definition at line 137 of file AddVariable.h.

◆ m_tmpvec

std::vector<Obj2> D3PDTest::ToObj2MultiAssociationTool::m_tmpvec

private

Definition at line 80 of file ToObj2MultiAssociationTool.h.

◆ m_tree

IAddVariable* D3PD::AddVariable::m_tree

privateinherited

Reference to the block name.

The parent IAddVariable instance.

Definition at line 143 of file AddVariable.h.

◆ m_which

int D3PDTest::ToObj2MultiAssociationTool::m_which

private

Definition at line 75 of file ToObj2MultiAssociationTool.h.

◆ s_emptyString

const std::string D3PD::AddVariable::s_emptyString

staticprivateinherited

Used to provide a default value for blockName.

Definition at line 41 of file AddVariable.h.

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

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ Base

Constructor & Destructor Documentation

◆ ToObj2MultiAssociationTool()

Member Function Documentation

◆ addDimensionedVariable() [1/6]

◆ addDimensionedVariable() [2/6]

◆ addDimensionedVariable() [3/6]

◆ addDimensionedVariable() [4/6]

◆ addDimensionedVariable() [5/6]

◆ addDimensionedVariable() [6/6]

◆ addVariable() [1/6]

◆ addVariable() [2/6]

◆ addVariable() [3/6]

◆ addVariable() [4/6]

◆ addVariable() [5/6]

◆ addVariable() [6/6]

◆ book()

◆ configureD3PD() [1/2]

◆ configureD3PD() [2/2]

◆ configureMulti()

◆ doConversion()

◆ elementTypeinfo()

◆ fromTypeinfo() [1/2]

◆ fromTypeinfo() [2/2]

◆ MultiAssociationToolImpl()

◆ next()

◆ nextUntyped()

◆ releaseElement()

◆ releaseElementUntyped()

◆ reset() [1/3]

◆ reset() [2/3]

◆ reset() [3/3]

◆ resetUntyped()

Member Data Documentation

◆ m_blockName

◆ m_end

◆ m_inputConverter

◆ m_it

◆ m_metadata

◆ m_prefix

◆ m_suffix

◆ m_tmpvec

◆ m_tree

◆ m_which

◆ s_emptyString