Implements most parts of a globally addressable object (via unique ID). More...

#include <world_object.h>

Inheritance diagram for madness::WorldObject< Derived >:

[legend]

Collaboration diagram for madness::WorldObject< Derived >:

[legend]

Public Types
typedef WorldObject< Derived >	objT

Public Member Functions
	WorldObject (const WorldObject &other)
	WorldObject (World &world)
	Constructor that associates an object (via the derived class) with a globally unique ID.
virtual	~WorldObject ()
WorldObject &	operator= (const WorldObject &)=delete
template<typename memfnT>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn) const
template<typename memfnT, typename a1T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1) const
template<typename memfnT, typename a1T, typename a2T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2) const
template<typename memfnT, typename a1T, typename a2T, typename a3T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3) const
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4) const
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5) const
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6) const
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7) const
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7, const a8T &a8) const
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>
detail::task_result_type< memfnT >::futureT	send (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7, const a8T &a8, const a9T &a9) const
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7, const a8T &a8, const a9T &a9, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6,a7,a8,a9).
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7, const a8T &a8, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6,a7,a8).
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6,a7).
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6).
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5).
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4).
template<typename memfnT, typename a1T, typename a2T, typename a3T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2,a3).
template<typename memfnT, typename a1T, typename a2T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1,a2).
template<typename memfnT, typename a1T>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const a1T &a1, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)(a1).
template<typename memfnT>
detail::task_result_type< memfnT >::futureT	task (ProcessID dest, memfnT memfn, const TaskAttributes &attr=TaskAttributes()) const
	Sends task to derived class method returnT (this->*memfn)().
Public Member Functions inherited from madness::WorldObjectBase
virtual	~WorldObjectBase ()
World &	get_world () const
World &	get_world_noexcept () const noexcept
	Get the world to which this object belongs, without risking a throw.
const uniqueidT &	id () const
	Returns the globally unique object ID.
bool	world_is_alive () const noexcept
	Reports whether the world to which this object belongs still exists.

Protected Member Functions
void	process_pending ()
	To be called from derived constructor to process pending messages.
Protected Member Functions inherited from madness::WorldObjectBase
	WorldObjectBase (const WorldObjectBase &other)
	Copy constructor; produces an unregistered object.
	WorldObjectBase (World &w)
	Construct a new WorldObjectBase.
World &	get_world_unchecked () const noexcept
	Unchecked access to the memoized world reference.
template<typename DerivedT>
void	register_self (DerivedT *this_ptr)
	Registers this object with its world, making it globally addressable.

Private Types
typedef std::list< detail::PendingMsg >	pendingT
typedef detail::voidT	voidT

Private Member Functions
template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>
detail::task_result_type< memfnT >::futureT	send_am (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7, const a8T &a8, const a9T &a9) const
template<typename taskT, typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>
taskT::futureT	send_task (ProcessID dest, memfnT memfn, const a1T &a1, const a2T &a2, const a3T &a3, const a4T &a4, const a5T &a5, const a6T &a6, const a7T &a7, const a8T &a8, const a9T &a9, const TaskAttributes &attr) const

Static Private Member Functions
template<typename T>
static const T &	am_arg (const Future< T > &f)
template<typename T>
static const T &	am_arg (const T &t)
template<typename memfnT, typename arg1T, typename arg2T, typename arg3T, typename arg4T, typename arg5T, typename arg6T, typename arg7T, typename arg8T, typename arg9T>
static void	handler (const AmArg &arg)
	Handler for an incoming AM.
static bool	is_ready (const uniqueidT &id, objT *&obj, const AmArg &arg, am_handlerT ptr)
template<typename taskT>
static void	spawn_remote_task_handler (const AmArg &arg)
	Handler for remote arguments.

Private Attributes
ProcessID	me
	Rank of self.
volatile bool	ready
	True if ready to rock 'n roll.

Static Private Attributes
static volatile pendingT	pending
	Buffer for pending messages.
static Spinlock	pending_mutex

Detailed Description

template<class Derived>
class madness::WorldObject< Derived >

Implements most parts of a globally addressable object (via unique ID).

This class is deliberately not default constructible and does not support assignment or copying. This ensures that each instance is unique. Have a look at madness::WorldContainer for an example of wrapping this using the PIMPL idiom and a shared pointer.

When deriving classes:

Derived class has WorldObject<Derived> as a public base class.
Derived constructor:
1. invokes WorldObject<Derived>(world) constructor.
2. invokes process_pending().
Derived destructor must either be deferred or preceeded by gop.fence().
Derived class must have at least one virtual function for serialization of derived class pointers to be cast to the appropriate type.

The World is accessed through WorldObjectBase::get_world(), which validates that it is still alive; derived classes that have already established that can use WorldObjectBase::get_world_unchecked().

Note: This class used to expose the World as a public data member named world. That member is gone; replace obj.world with obj.get_world() and, within a derived class, world with this->get_world().

Template Parameters

Derived The derived class. WorldObject is a curiously recurring template pattern.

Member Typedef Documentation

◆ objT

template<class Derived>

typedef WorldObject<Derived> madness::WorldObject< Derived >::objT

Todo: Description needed.

◆ pendingT

template<class Derived>

typedef std::list<detail::PendingMsg> madness::WorldObject< Derived >::pendingT

private

Todo: Description needed.

◆ voidT

template<class Derived>

typedef detail::voidT madness::WorldObject< Derived >::voidT

private

Todo: Description needed.

Constructor & Destructor Documentation

◆ WorldObject() [1/2]

template<class Derived>

madness::WorldObject< Derived >::WorldObject ( const WorldObject< Derived > & other )

inline

Referenced by madness::SeparatedConvolution< double, 3 >::SeparatedConvolution(), madness::SeparatedConvolution< double, 3 >::SeparatedConvolution(), and madness::SeparatedConvolution< double, 3 >::SeparatedConvolution().

◆ WorldObject() [2/2]

template<class Derived>

madness::WorldObject< Derived >::WorldObject ( World & world )

inline

Constructor that associates an object (via the derived class) with a globally unique ID.

Attention

The derived class MUST call process_pending from its constructor to both

process any messages that arrived prior to construction.
to enable processing of future messages.

Parameters

[in,out] world The World encapsulating the "global" domain.

◆ ~WorldObject()

template<class Derived>

virtual madness::WorldObject< Derived >::~WorldObject ( )

inlinevirtual

Member Function Documentation

◆ am_arg() [1/2]

template<class Derived>

template<typename T>

const T & madness::WorldObject< Derived >::am_arg ( const Future< T > & f )

inlinestaticprivate

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

T	Description needed.

Parameters

[in] f Description needed.

Returns: Description needed.

◆ am_arg() [2/2]

template<class Derived>

template<typename T>

const T & madness::WorldObject< Derived >::am_arg ( const T & t )

inlinestaticprivate

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

T	Description needed.

Parameters

[in] t Description needed.

Returns: Description needed.

◆ handler()

template<class Derived>

template<typename memfnT, typename arg1T, typename arg2T, typename arg3T, typename arg4T, typename arg5T, typename arg6T, typename arg7T, typename arg8T, typename arg9T>

void madness::WorldObject< Derived >::handler ( const AmArg & arg )

inlinestaticprivate

Handler for an incoming AM.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
arg1T	Type of argument 1.
arg2T	Type of argument 2.
arg3T	Type of argument 3.
arg4T	Type of argument 4.
arg5T	Type of argument 5.
arg6T	Type of argument 6.
arg7T	Type of argument 7.
arg8T	Type of argument 8.
arg9T	Type of argument 9.

Parameters

[in] arg Description needed.

◆ is_ready()

template<class Derived>

bool madness::WorldObject< Derived >::is_ready	(	const uniqueidT &	id,
		objT *&	obj,
		const AmArg &	arg,
		am_handlerT	ptr )

inlinestaticprivate

Todo: Complete: Determine if [unknown] is ready (for ...).

The slightly convoluted logic is to ensure ordering when processing pending messages. If a new message arrives while processing incoming messages it must be queued.

If the object does not exist ---> not ready.
If the object exists and is ready ---> ready.
If the object exists and is not ready then
- if we are doing a queued/pending message --> ready.
- else this is a new message --> not ready.

Parameters

[in]	id	Description needed.
[in,out]	obj	Description needed.
[in]	arg	Description needed.
[in,out]	ptr	Description needed.

Returns: Description needed.

Todo: Parameter/return descriptions needed.

Referenced by madness::WorldObject< DerivativeBase< T, NDIM > >::handler(), and madness::WorldObject< DerivativeBase< T, NDIM > >::spawn_remote_task_handler().

◆ operator=()

template<class Derived>

WorldObject & madness::WorldObject< Derived >::operator= ( const WorldObject< Derived > & )

delete

◆ process_pending()

template<class Derived>

void madness::WorldObject< Derived >::process_pending ( )

inlineprotected

To be called from derived constructor to process pending messages.

Cannot call this from the WorldObject constructor since the derived class would not yet be fully constructed.

Attention: No incoming messages are processed until this routine is invoked; the derived class may rely upon a well defined state until this routine is invoked.

◆ send() [1/10]

template<class Derived>

template<typename memfnT>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT Verify: Signature of the member function in the derived class to be invoked for the task.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.

Returns: Description needed.

◆ send() [2/10]

template<class Derived>

template<typename memfnT, typename a1T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.

Returns: Description needed.

◆ send() [3/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.

Returns: Description needed.

◆ send() [4/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.

Returns: Description needed.

◆ send() [5/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.

Returns: Description needed.

◆ send() [6/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.

Returns: Description needed.

◆ send() [7/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.

Returns: Description needed.

◆ send() [8/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.

Returns: Description needed.

◆ send() [9/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7,
		const a8T &	a8 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.
a8T	Type of argument 8.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.
a8	Argument 8.

Returns: Description needed.

◆ send() [10/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7,
		const a8T &	a8,
		const a9T &	a9 ) const

inline

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.
a8T	Type of argument 8.
a9T	Type of argument 9.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.
a8	Argument 8.
a9	Argument 9.

Returns: Description needed.

◆ send_am()

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::send_am	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7,
		const a8T &	a8,
		const a9T &	a9 ) const

inlineprivate

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.
a8T	Type of argument 8.
a9T	Type of argument 9.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.
a8	Argument 8.
a9	Argument 9.

Returns: Description needed.

◆ send_task()

template<class Derived>

template<typename taskT, typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>

taskT::futureT madness::WorldObject< Derived >::send_task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7,
		const a8T &	a8,
		const a9T &	a9,
		const TaskAttributes &	attr ) const

inlineprivate

Todo: Brief description needed.

Todo: Descriptions needed.

Template Parameters

taskT	Description needed.
memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.
a8T	Type of argument 8.
a9T	Type of argument 9.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.
a8	Argument 8.
a9	Argument 9.
attr	Description needed.

Returns: Description needed.

◆ spawn_remote_task_handler()

template<class Derived>

template<typename taskT>

void madness::WorldObject< Derived >::spawn_remote_task_handler ( const AmArg & arg )

inlinestaticprivate

Handler for remote arguments.

Todo: Descriptions needed.

Template Parameters

taskT Description needed.

Parameters

[in] arg Description needed.

◆ task() [1/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T, typename a9T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7,
		const a8T &	a8,
		const a9T &	a9,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6,a7,a8,a9).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.
a8T	Type of argument 8.
a9T	Type of argument 9.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.
a8	Argument 8.
a9	Argument 9.
attr	Description needed.

Returns: Description needed.

Todo: Could we use variadic templates to eliminate a lot of this code duplication?

◆ task() [2/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T, typename a8T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7,
		const a8T &	a8,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6,a7,a8).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.
a8T	Type of argument 8.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.
a8	Argument 8.
attr	Description needed.

Returns: Description needed.

◆ task() [3/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T, typename a7T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const a7T &	a7,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6,a7).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.
a7T	Type of argument 7.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
a7	Argument 7.
attr	Description needed.

Returns: Description needed.

◆ task() [4/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T, typename a6T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const a6T &	a6,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5,a6).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.
a6T	Type of argument 6.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
a6	Argument 6.
attr	Description needed.

Returns: Description needed.

◆ task() [5/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T, typename a5T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const a5T &	a5,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4,a5).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.
a5T	Type of argument 5.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
a5	Argument 5.
attr	Description needed.

Returns: Description needed.

◆ task() [6/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T, typename a4T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const a4T &	a4,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2,a3,a4).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.
a4T	Type of argument 4.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
a4	Argument 4.
attr	Description needed.

Returns: Description needed.

◆ task() [7/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T, typename a3T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const a3T &	a3,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2,a3).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.
a3T	Type of argument 3.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
a3	Argument 3.
attr	Description needed.

Returns: Description needed.

◆ task() [8/10]

template<class Derived>

template<typename memfnT, typename a1T, typename a2T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const a2T &	a2,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1,a2).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.
a2T	Type of argument 2.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
a2	Argument 2.
attr	Description needed.

Returns: Description needed.

◆ task() [9/10]

template<class Derived>

template<typename memfnT, typename a1T>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const a1T &	a1,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)(a1).

Todo: Descriptions needed.

Template Parameters

memfnT	Verify: Signature of the member function in the derived class to be invoked for the task.
a1T	Type of argument 1.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
a1	Argument 1.
attr	Description needed.

Returns: Description needed.

◆ task() [10/10]

template<class Derived>

template<typename memfnT>

detail::task_result_type< memfnT >::futureT madness::WorldObject< Derived >::task	(	ProcessID	dest,
		memfnT	memfn,
		const TaskAttributes &	attr = TaskAttributes() ) const

inline

Sends task to derived class method returnT (this->*memfn)().

Todo: Descriptions needed.

Template Parameters

memfnT Verify: Signature of the member function in the derived class to be invoked for the task.

Parameters

dest	Description needed.
memfn	Verify: The member function to be invoked for the task.
attr	Description needed.

Returns: Description needed.

Referenced by madness::coalesced_gaxpy(), madness::composite_inner_apply(), madness::composite_product_apply(), madness::FunctionImpl< T, LDIM >::copy_remote_coeffs_from_pid(), madness::DerivativeBase< T, NDIM >::forward_do_diff1(), and madness::FunctionImpl< T, LDIM >::mulXXveca().

Member Data Documentation

◆ me

template<class Derived>

ProcessID madness::WorldObject< Derived >::me

private

Rank of self.

◆ pending

template<class Derived>

volatile pendingT madness::WorldObject< Derived >::pending

inlinestaticprivate

Buffer for pending messages.

◆ pending_mutex

template<class Derived>

Spinlock madness::WorldObject< Derived >::pending_mutex

inlinestaticprivate

Todo: Description needed.

◆ ready

template<class Derived>

volatile bool madness::WorldObject< Derived >::ready

private

True if ready to rock 'n roll.

Referenced by madness::WorldObject< DerivativeBase< T, NDIM > >::is_ready().

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

world_object.h

Public Types

Public Member Functions

Protected Member Functions

Private Types

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ objT

◆ pendingT

◆ voidT

Constructor & Destructor Documentation

◆ WorldObject() [1/2]

◆ WorldObject() [2/2]

◆ ~WorldObject()

Member Function Documentation

◆ am_arg() [1/2]

◆ am_arg() [2/2]

◆ handler()

◆ is_ready()

◆ operator=()

◆ process_pending()

◆ send() [1/10]

◆ send() [2/10]

◆ send() [3/10]

◆ send() [4/10]

◆ send() [5/10]

◆ send() [6/10]

◆ send() [7/10]

◆ send() [8/10]

◆ send() [9/10]

◆ send() [10/10]

◆ send_am()

◆ send_task()

◆ spawn_remote_task_handler()

◆ task() [1/10]

◆ task() [2/10]

◆ task() [3/10]

◆ task() [4/10]

◆ task() [5/10]

◆ task() [6/10]

◆ task() [7/10]

◆ task() [8/10]

◆ task() [9/10]

◆ task() [10/10]

Member Data Documentation

◆ me

◆ pending

◆ pending_mutex

◆ ready