helper for the vtkGraph class that allows the graph to be distributed across multiple memory spaces. More...

#include <vtkDistributedGraphHelper.h>

Inheritance diagram for vtkDistributedGraphHelper:

Collaboration diagram for vtkDistributedGraphHelper:

Public Types
typedef vtkObject	Superclass

Public Types inherited from vtkObject
typedef vtkObjectBase	Superclass

Public Member Functions
virtual int	IsA (const char *type)

vtkDistributedGraphHelper *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent)

vtkIdType	GetVertexOwner (vtkIdType v) const

vtkIdType	GetVertexIndex (vtkIdType v) const

vtkIdType	GetEdgeOwner (vtkIdType e_id) const

vtkIdType	GetEdgeIndex (vtkIdType e_id) const

vtkIdType	MakeDistributedId (int owner, vtkIdType local)

vtkIdType	GetVertexOwnerByPedigreeId (const vtkVariant &pedigreeId)

virtual void	Synchronize ()=0

virtual vtkDistributedGraphHelper *	Clone ()=0


void	SetVertexPedigreeIdDistribution (vtkVertexPedigreeIdDistribution Func, void *userData)

Public Member Functions inherited from vtkObject
vtkObject *	NewInstance () const

virtual void	DebugOn ()

virtual void	DebugOff ()

bool	GetDebug ()

void	SetDebug (bool debugFlag)

virtual void	Modified ()

virtual unsigned long	GetMTime ()

unsigned long	AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)

unsigned long	AddObserver (const char event, vtkCommand , float priority=0.0f)

vtkCommand *	GetCommand (unsigned long tag)

void	RemoveObserver (vtkCommand *)

void	RemoveObservers (unsigned long event, vtkCommand *)

void	RemoveObservers (const char event, vtkCommand )

int	HasObserver (unsigned long event, vtkCommand *)

int	HasObserver (const char event, vtkCommand )

void	RemoveObserver (unsigned long tag)

void	RemoveObservers (unsigned long event)

void	RemoveObservers (const char *event)

void	RemoveAllObservers ()

int	HasObserver (unsigned long event)

int	HasObserver (const char *event)

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, void(T::callback)(vtkObject , unsigned long, void *), float priority=0.0f)

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, bool(T::callback)(vtkObject , unsigned long, void *), float priority=0.0f)

int	InvokeEvent (unsigned long event, void *callData)

int	InvokeEvent (const char event, void callData)

int	InvokeEvent (unsigned long event)

int	InvokeEvent (const char *event)

Public Member Functions inherited from vtkObjectBase
const char *	GetClassName () const

virtual void	Delete ()

virtual void	FastDelete ()

void	Print (ostream &os)

virtual void	Register (vtkObjectBase *o)

virtual void	UnRegister (vtkObjectBase *o)

void	SetReferenceCount (int)

void	PrintRevisions (ostream &)

virtual void	PrintHeader (ostream &os, vtkIndent indent)

virtual void	PrintTrailer (ostream &os, vtkIndent indent)

int	GetReferenceCount ()

Static Public Member Functions
static int	IsTypeOf (const char *type)

static vtkDistributedGraphHelper *	SafeDownCast (vtkObjectBase *o)


static vtkInformationIntegerKey *	DISTRIBUTEDVERTEXIDS ()

static vtkInformationIntegerKey *	DISTRIBUTEDEDGEIDS ()

Static Public Member Functions inherited from vtkObject
static int	IsTypeOf (const char *type)

static vtkObject *	SafeDownCast (vtkObjectBase *o)

static vtkObject *	New ()

static void	BreakOnError ()

static void	SetGlobalWarningDisplay (int val)

static void	GlobalWarningDisplayOn ()

static void	GlobalWarningDisplayOff ()

static int	GetGlobalWarningDisplay ()

Static Public Member Functions inherited from vtkObjectBase
static int	IsTypeOf (const char *name)

static vtkObjectBase *	New ()

Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const

	vtkDistributedGraphHelper ()

virtual	~vtkDistributedGraphHelper ()

virtual void	AddVertexInternal (const vtkVariant &pedigreeId, vtkIdType *vertex)=0

virtual vtkIdType	FindVertex (const vtkVariant &pedigreeId)=0

virtual void	AttachToGraph (vtkGraph *graph)


virtual void	AddVertexInternal (vtkVariantArray propertyArr, vtkIdType vertex)=0


virtual void	AddEdgeInternal (vtkIdType u, vtkIdType v, bool directed, vtkVariantArray propertyArr, vtkEdgeType edge)=0


virtual void	AddEdgeInternal (const vtkVariant &uPedigreeId, vtkIdType v, bool directed, vtkVariantArray propertyArr, vtkEdgeType edge)=0


virtual void	AddEdgeInternal (vtkIdType u, const vtkVariant &vPedigreeId, bool directed, vtkVariantArray propertyArr, vtkEdgeType edge)=0


virtual void	AddEdgeInternal (const vtkVariant &uPedigreeId, const vtkVariant &vPedigreeId, bool directed, vtkVariantArray propertyArr, vtkEdgeType edge)=0


virtual void	FindEdgeSourceAndTarget (vtkIdType id, vtkIdType source, vtkIdType target)=0

Protected Member Functions inherited from vtkObject
	vtkObject ()

virtual	~vtkObject ()

virtual void	RegisterInternal (vtkObjectBase *, int check)

virtual void	UnRegisterInternal (vtkObjectBase *, int check)

void	InternalGrabFocus (vtkCommand mouseEvents, vtkCommand keypressEvents=NULL)

void	InternalReleaseFocus ()

Protected Member Functions inherited from vtkObjectBase
	vtkObjectBase ()

virtual	~vtkObjectBase ()

virtual void	CollectRevisions (ostream &)

virtual void	ReportReferences (vtkGarbageCollector *)

	vtkObjectBase (const vtkObjectBase &)

void	operator= (const vtkObjectBase &)

Protected Attributes
vtkGraph *	Graph

vtkVertexPedigreeIdDistribution	VertexDistribution

void *	VertexDistributionUserData

vtkIdType	signBitMask

vtkIdType	highBitShiftMask

int	procBits


int	indexBits

Protected Attributes inherited from vtkObject
bool	Debug

vtkTimeStamp	MTime

vtkSubjectHelper *	SubjectHelper

Protected Attributes inherited from vtkObjectBase
vtkAtomicInt32	ReferenceCount

vtkWeakPointerBase **	WeakPointers

Friends
class	vtkGraph

Detailed Description

helper for the vtkGraph class that allows the graph to be distributed across multiple memory spaces.

A distributed graph helper can be attached to an empty vtkGraph object to turn the vtkGraph into a distributed graph, whose vertices and edges are distributed across several different processors. vtkDistributedGraphHelper is an abstract class. Use a subclass of vtkDistributedGraphHelper, such as vtkPBGLDistributedGraphHelper, to build distributed graphs.

The distributed graph helper provides facilities used by vtkGraph to communicate with other processors that store other parts of the same distributed graph. The only user-level functionality provided by vtkDistributedGraphHelper involves this communication among processors and the ability to map between "distributed" vertex and edge IDs and their component parts (processor and local index). For example, the Synchronize() method provides a barrier that allows all processors to catch up to the same point in the code before any processor can leave that Synchronize() call. For example, one would call Synchronize() after adding many edges to a distributed graph, so that all processors can handle the addition of inter-processor edges and continue, after the Synchronize() call, with a consistent view of the distributed graph. For more information about manipulating (distributed) graphs, see the vtkGraph documentation.

See also: vtkGraph

Tests:: vtkDistributedGraphHelper (Tests)

Definition at line 79 of file vtkDistributedGraphHelper.h.

Member Typedef Documentation

typedef vtkObject vtkDistributedGraphHelper::Superclass

Definition at line 82 of file vtkDistributedGraphHelper.h.

Constructor & Destructor Documentation

vtkDistributedGraphHelper::vtkDistributedGraphHelper ( )

protected

virtual vtkDistributedGraphHelper::~vtkDistributedGraphHelper ( )

protectedvirtual

Member Function Documentation

static int vtkDistributedGraphHelper::IsTypeOf ( const char * type )

static

virtual int vtkDistributedGraphHelper::IsA ( const char * name )

virtual

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

Reimplemented in vtkPBGLDistributedGraphHelper.

static vtkDistributedGraphHelper* vtkDistributedGraphHelper::SafeDownCast ( vtkObjectBase * o )

static

virtual vtkObjectBase* vtkDistributedGraphHelper::NewInstanceInternal ( ) const

protectedvirtual

Reimplemented from vtkObject.

Reimplemented in vtkPBGLDistributedGraphHelper.

vtkDistributedGraphHelper* vtkDistributedGraphHelper::NewInstance ( ) const

void vtkDistributedGraphHelper::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)

virtual

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkObject.

Reimplemented in vtkPBGLDistributedGraphHelper.

vtkIdType vtkDistributedGraphHelper::GetVertexOwner ( vtkIdType v ) const

Returns owner of vertex v, by extracting top ceil(log2 P) bits of v.

vtkIdType vtkDistributedGraphHelper::GetVertexIndex ( vtkIdType v ) const

Returns local index of vertex v, by masking off top ceil(log2 P) bits of v.

vtkIdType vtkDistributedGraphHelper::GetEdgeOwner ( vtkIdType e_id ) const

Returns owner of edge with ID e_id, by extracting top ceil(log2 P) bits of e_id.

vtkIdType vtkDistributedGraphHelper::GetEdgeIndex ( vtkIdType e_id ) const

Returns local index of edge with ID e_id, by masking off top ceil(log2 P) bits of e_id.

vtkIdType vtkDistributedGraphHelper::MakeDistributedId	(	int	owner,
		vtkIdType	local
	)

Builds a distributed ID consisting of the given owner and the local ID.

void vtkDistributedGraphHelper::SetVertexPedigreeIdDistribution	(	vtkVertexPedigreeIdDistribution	Func,
		void *	userData
	)

Set the pedigreeId -> processor distribution function that determines how vertices are distributed when they are associated with pedigree ID, which must be a unique label such as a URL or IP address. If a NULL function pointer is provided, the default hashed distribution will be used.

vtkIdType vtkDistributedGraphHelper::GetVertexOwnerByPedigreeId ( const vtkVariant & pedigreeId )

Determine which processor owns the vertex with the given pedigree ID.

virtual void vtkDistributedGraphHelper::Synchronize ( )

pure virtual

Synchronizes all of the processors involved in this distributed graph, so that all processors have a consistent view of the distributed graph for the computation that follows. This routine should be invoked after adding new edges into the distributed graph, so that other processors will see those edges (or their corresponding back-edges).

Implemented in vtkPBGLDistributedGraphHelper.

virtual vtkDistributedGraphHelper* vtkDistributedGraphHelper::Clone ( )

pure virtual

Clones the distributed graph helper, returning another distributed graph helper of the same kind that can be used in another vtkGraph.

Implemented in vtkPBGLDistributedGraphHelper.

static vtkInformationIntegerKey* vtkDistributedGraphHelper::DISTRIBUTEDVERTEXIDS ( )

static

Information Keys that distributed graphs can append to attribute arrays to flag them as containing distributed IDs. These can be used to let routines that migrate vertices (either repartitioning or collecting graphs to single nodes) to also modify the ids contained in the attribute arrays to maintain consistency.

static vtkInformationIntegerKey* vtkDistributedGraphHelper::DISTRIBUTEDEDGEIDS ( )

static

Information Keys that distributed graphs can append to attribute arrays to flag them as containing distributed IDs. These can be used to let routines that migrate vertices (either repartitioning or collecting graphs to single nodes) to also modify the ids contained in the attribute arrays to maintain consistency.

virtual void vtkDistributedGraphHelper::AddVertexInternal	(	vtkVariantArray *	propertyArr,
		vtkIdType *	vertex
	)

protectedpure virtual

Add a vertex, optionally with properties, to the distributed graph. If vertex is non-NULL, it will be set to the newly-added (or found) vertex. Note that if propertyArr is non-NULL and the vertex data contains pedigree IDs, a vertex will only be added if there is no vertex with that pedigree ID.

Implemented in vtkPBGLDistributedGraphHelper.

virtual void vtkDistributedGraphHelper::AddVertexInternal	(	const vtkVariant &	pedigreeId,
		vtkIdType *	vertex
	)

protectedpure virtual

Add a vertex with the given pedigreeId to the distributed graph. If vertex is non-NULL, it will receive the newly-created vertex.

Implemented in vtkPBGLDistributedGraphHelper.

virtual void vtkDistributedGraphHelper::AddEdgeInternal	(	vtkIdType	u,
		vtkIdType	v,
		bool	directed,
		vtkVariantArray *	propertyArr,
		vtkEdgeType *	edge
	)

protectedpure virtual

Add an edge (u, v) to the distributed graph. The edge may be directed undirected. If edge is non-null, it will receive the newly-created edge. If propertyArr is non-null, it specifies the properties that will be attached to the newly-created edge.

Implemented in vtkPBGLDistributedGraphHelper.

virtual void vtkDistributedGraphHelper::AddEdgeInternal	(	const vtkVariant &	uPedigreeId,
		vtkIdType	v,
		bool	directed,
		vtkVariantArray *	propertyArr,
		vtkEdgeType *	edge
	)

protectedpure virtual

Adds an edge (u, v) and returns the new edge. The graph edge may or may not be directed, depending on the given flag. If edge is non-null, it will receive the newly-created edge. uPedigreeId is the pedigree ID of vertex u, which will be added if no vertex by that pedigree ID exists. If propertyArr is non-null, it specifies the properties that will be attached to the newly-created edge.

Implemented in vtkPBGLDistributedGraphHelper.

virtual void vtkDistributedGraphHelper::AddEdgeInternal	(	vtkIdType	u,
		const vtkVariant &	vPedigreeId,
		bool	directed,
		vtkVariantArray *	propertyArr,
		vtkEdgeType *	edge
	)

protectedpure virtual

Adds an edge (u, v) and returns the new edge. The graph edge may or may not be directed, depending on the given flag. If edge is non-null, it will receive the newly-created edge. vPedigreeId is the pedigree ID of vertex u, which will be added if no vertex with that pedigree ID exists. If propertyArr is non-null, it specifies the properties that will be attached to the newly-created edge.

Implemented in vtkPBGLDistributedGraphHelper.

virtual void vtkDistributedGraphHelper::AddEdgeInternal	(	const vtkVariant &	uPedigreeId,
		const vtkVariant &	vPedigreeId,
		bool	directed,
		vtkVariantArray *	propertyArr,
		vtkEdgeType *	edge
	)

protectedpure virtual

Adds an edge (u, v) and returns the new edge. The graph edge may or may not be directed, depending on the given flag. If edge is non-null, it will receive the newly-created edge. uPedigreeId is the pedigree ID of vertex u and vPedigreeId is the pedigree ID of vertex u, each of which will be added if no vertex by that pedigree ID exists. If propertyArr is non-null, it specifies the properties that will be attached to the newly-created edge.

Implemented in vtkPBGLDistributedGraphHelper.

virtual vtkIdType vtkDistributedGraphHelper::FindVertex ( const vtkVariant & pedigreeId )