Sparksee  6.0.2
CommunityDetection Class Referenceabstract

CommunityDetection class. More...

Inheritance diagram for CommunityDetection:
Inheritance graph

Public Member Functions

virtual ~CommunityDetection ()
 Destructor.
 
virtual void AddNodeType (sparksee::gdb::type_t type)
 Allows connectivity through nodes of the given type.
 
virtual void AddAllNodeTypes ()
 Allows connectivity through all node types of the graph.
 
virtual void ExcludeNodes (sparksee::gdb::Objects &nodes)
 Set which nodes can't be used. More...
 
virtual void ExcludeEdges (sparksee::gdb::Objects &edges)
 Set which edges can't be used. More...
 
virtual void IncludeNodes (sparksee::gdb::Objects &nodes)
 Set additional nodes that can be used. More...
 
virtual void IncludeEdges (sparksee::gdb::Objects &edges)
 Set additional edges that can be used. More...
 
virtual void Run ()=0
 Runs the algorithm in order to find the connected components. More...
 

Protected Types

typedef std::map< sparksee::gdb::type_t, sparksee::gdb::EdgesDirectionEdgeTypes_t
 A type definition to store allowed edge types.
 
typedef std::vector< sparksee::gdb::type_tNodeTypes_t
 A type definition to store allowed node types.
 

Protected Member Functions

 CommunityDetection (sparksee::gdb::Session &s)
 Creates a new instance of CommunityDetection. More...
 
void AddEdgeType (sparksee::gdb::type_t type, sparksee::gdb::EdgesDirection direction)
 Allows connectivity through edges of the given type. More...
 
void AddAllEdgeTypes (sparksee::gdb::EdgesDirection direction)
 Allows connectivity through all edge types of the graph. More...
 
void AssertAddedEdges ()
 Check that edges had been added.
 
void AssertAddedNodes ()
 Check that nodes had been added.
 
void AssertNotComputed ()
 Check that the connectivity had not been calculated yet.
 
void SetNodesNotVisited ()
 Set all the selected nodes in nodesNotVisited. More...
 
void AssertComputed ()
 Check that the communities had been calculated.
 
void AssertEdgeType (sparksee::gdb::type_t edgetype)
 Check that the given edge type is valid.
 
void AssertNodeType (sparksee::gdb::type_t nodetype)
 Check that the given node type is valid.
 
sparksee::gdb::bool_t IsNodeTypeAllowed (sparksee::gdb::oid_t nodeId)
 Check if the given node has an allowed type.
 
sparksee::gdb::bool_t IsEdgeTypeAllowed (sparksee::gdb::oid_t edgeId)
 Check if the given edge has an allowed type.
 
sparksee::gdb::bool_t IsNodeAllowed (sparksee::gdb::oid_t nodeId)
 Check if the given node is allowed (by type or by explicit inclusion).
 
sparksee::gdb::bool_t IsEdgeAllowed (sparksee::gdb::oid_t edgeId)
 Check if the given edge is allowed (by type or by explicit inclusion).
 
sparksee::gdb::bool_t IsNodeExcluded (sparksee::gdb::oid_t node)
 Check if the given node is forbidden.
 
sparksee::gdb::bool_t IsEdgeExcluded (sparksee::gdb::oid_t edge)
 Check if the given edge is forbidden.
 
sparksee::gdb::bool_t IsNodeIncluded (sparksee::gdb::oid_t node)
 Check if the given node is EXPLICITLY allowed using the include set.
 
sparksee::gdb::bool_t IsEdgeIncluded (sparksee::gdb::oid_t edge)
 Check if the given edge is EXPLICITLY allowed using the include set.
 

Protected Attributes

sparksee::gdb::Session * sess
 Session.
 
sparksee::gdb::Graph * graph
 Graph.
 
EdgeTypes_t edgeTypes
 Allowed edge types.
 
std::vector< sparksee::gdb::type_tnodeTypes
 Allowed node types.
 
sparksee::gdb::Objects * nodesNotVisited
 Identifiers of the nodes not visited.
 
sparksee::gdb::bool_t computed
 True if the connectivity has been calculated.
 
sparksee::gdb::Objects * excludedNodes
 The set of excluded nodes.
 
sparksee::gdb::Objects * excludedEdges
 The set of excluded edges.
 
sparksee::gdb::Objects * includedNodes
 The set of explicitly included nodes.
 
sparksee::gdb::Objects * includedEdges
 The set of explicitly included edges.
 

Detailed Description

CommunityDetection class.

Any class implementing this abstract class can be used to solve a problem related to graph connectivity as finding the strongly connected components, finding the weakly connected components.

Check out the 'Algorithms' section in the SPARKSEE User Manual for more details on this.

Author
Sparsity Technologies http://www.sparsity-technologies.com

Constructor & Destructor Documentation

CommunityDetection::CommunityDetection ( sparksee::gdb::Session &  s)
protected

Creates a new instance of CommunityDetection.

Parameters
s[in] Session to get the graph from and calculate the communities

Member Function Documentation

void CommunityDetection::AddAllEdgeTypes ( sparksee::gdb::EdgesDirection  direction)
protected

Allows connectivity through all edge types of the graph.

Parameters
d[in] Edge direction.
void CommunityDetection::AddEdgeType ( sparksee::gdb::type_t  type,
sparksee::gdb::EdgesDirection  direction 
)
protected

Allows connectivity through edges of the given type.

Parameters
t[in] Edge type.
d[in] Edge direction.
virtual void CommunityDetection::ExcludeEdges ( sparksee::gdb::Objects &  edges)
virtual

Set which edges can't be used.

This will replace any previously specified set of excluded edges. Should only be used to exclude the usage of specific edges from allowed edge types because it's less efficient than not allowing an edge type.

Parameters
edges[in] A set of edge identifiers that must be kept intact until the destruction of the class.
virtual void CommunityDetection::ExcludeNodes ( sparksee::gdb::Objects &  nodes)
virtual

Set which nodes can't be used.

This will replace any previously specified set of excluded nodes. Should only be used to exclude the usage of specific nodes from allowed node types because it's less efficient than not allowing a node type.

Parameters
nodes[in] A set of node identifiers that must be kept intact until the destruction of the class.
virtual void CommunityDetection::IncludeEdges ( sparksee::gdb::Objects &  edges)
virtual

Set additional edges that can be used.

This will replace any previously specified set of include edges. Using this optional method adds valid edges to the edges of any edge type explicitly set as a valid type. Should only be used to include specific small sets of edges because it's less efficient than just using an edge type. For any edge to be used, both nodes must be also valid.

Parameters
edges[in] A set of edge identifiers that must be kept intact until the destruction of the class.
virtual void CommunityDetection::IncludeNodes ( sparksee::gdb::Objects &  nodes)
virtual

Set additional nodes that can be used.

This will replace any previously specified set of include nodes. Using this optional method adds valid nodes to the nodes of any node type explicitly set as a valid type. Should only be used to include specific small sets of nodes because it's less efficient than just using a node type.

Parameters
nodes[in] A set of node identifiers that must be kept intact until the destruction of the class.
virtual void CommunityDetection::Run ( )
pure virtual

Runs the algorithm in order to find the connected components.

This method can be called only once.

Implemented in DisjointCommunityDetection, and CommunitiesSCD.

void CommunityDetection::SetNodesNotVisited ( )
protected

Set all the selected nodes in nodesNotVisited.

That's all the nodes of the allowed node types but not the excluded ones.


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