Sparksee  6.0.2
Traversal Class Referenceabstract

Traversal class. More...

Inheritance diagram for Traversal:
Inheritance graph

Public Member Functions

virtual void AddEdgeType (sparksee::gdb::type_t type, sparksee::gdb::EdgesDirection dir)
 Allows for traversing edges of the given type. More...
 
virtual void AddAllEdgeTypes (sparksee::gdb::EdgesDirection dir)
 Allows for traversing all edge types of the graph. More...
 
virtual void AddNodeType (sparksee::gdb::type_t type)
 Allows for traversing nodes of the given type. More...
 
virtual void AddAllNodeTypes ()
 Allows for traversing 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 sparksee::gdb::oid_t Next ()=0
 Gets the next object of the traversal. More...
 
virtual sparksee::gdb::bool_t HasNext ()=0
 Gets if there are more objects to be traversed. More...
 
virtual sparksee::gdb::int32_t GetCurrentDepth () const =0
 Returns the depth of the current node. More...
 
virtual void SetMaximumHops (sparksee::gdb::int32_t maxhops)
 Sets the maximum hops restriction. More...
 
virtual ~Traversal ()
 Destructor.
 

Protected Member Functions

 Traversal (sparksee::gdb::Session &s, sparksee::gdb::oid_t node)
 Creates a new instance. More...
 
void AssertAddedEdges ()
 Check that edges had been added.
 
void AssertAddedNodes ()
 Check that nodes had been added.
 
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 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.
 

Protected Attributes

sparksee::gdb::Session * sess
 Session.
 
sparksee::gdb::Graph * graph
 Graph.
 
sparksee::gdb::oid_t src
 Source node of the traversal.
 
std::map< sparksee::gdb::type_t, sparksee::gdb::EdgesDirectionedgeTypes
 Allowed edge types.
 
std::vector< sparksee::gdb::type_tnodeTypes
 Allowed node types.
 
sparksee::gdb::int32_t maxHops
 Maximum number of hops allowed.
 
sparksee::gdb::Objects * excludedNodes
 The set of excluded nodes.
 
sparksee::gdb::Objects * excludedEdges
 The set of excluded edges.
 

Detailed Description

Traversal class.

Any class implementing this abstract class can be used to traverse a graph.

Once the instance has been created and the allowed node and edge types has been set, it can be used as an iterator, retrieving the next object identifier of the traversal until there are no more.

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

Traversal::Traversal ( sparksee::gdb::Session &  s,
sparksee::gdb::oid_t  node 
)
protected

Creates a new instance.

Parameters
s[in] Session to get the graph from and perform traversal.
node[in] Node to start traversal from.

Member Function Documentation

virtual void Traversal::AddAllEdgeTypes ( sparksee::gdb::EdgesDirection  dir)
virtual

Allows for traversing all edge types of the graph.

Parameters
dir[in] Edge direction.

Reimplemented in RandomWalk.

virtual void Traversal::AddEdgeType ( sparksee::gdb::type_t  type,
sparksee::gdb::EdgesDirection  dir 
)
virtual

Allows for traversing edges of the given type.

Parameters
type[in] Edge type.
dir[in] Edge direction.

Reimplemented in RandomWalk.

virtual void Traversal::AddNodeType ( sparksee::gdb::type_t  type)
virtual

Allows for traversing nodes of the given type.

Parameters
typeThe node type to add

Reimplemented in RandomWalk.

virtual void Traversal::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.

Reimplemented in RandomWalk.

virtual void Traversal::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.

Reimplemented in RandomWalk.

virtual sparksee::gdb::int32_t Traversal::GetCurrentDepth ( ) const
pure virtual

Returns the depth of the current node.

That is, it returns the depth of the node returned in the last call to Next().

Returns
The depth of the current node.

Implemented in RandomWalk, TraversalBFS, and TraversalDFS.

virtual sparksee::gdb::bool_t Traversal::HasNext ( )
pure virtual

Gets if there are more objects to be traversed.

Returns
TRUE if there are more objects, FALSE otherwise.

Implemented in RandomWalk, TraversalBFS, and TraversalDFS.

virtual sparksee::gdb::oid_t Traversal::Next ( )
pure virtual

Gets the next object of the traversal.

Returns
A node or edge identifier.

Implemented in RandomWalk, TraversalBFS, and TraversalDFS.

virtual void Traversal::SetMaximumHops ( sparksee::gdb::int32_t  maxhops)
virtual

Sets the maximum hops restriction.

All paths longer than the maximum hops restriction will be ignored.

Parameters
maxhops[in] The maximum hops restriction. It must be positive or zero. Zero, the default value, means unlimited.

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