SparkseeNet 6.1.0
com.sparsity.sparksee.gdb.Graph Class Reference

Graph class. More...

Public Member Functions

long FindOrCreateEdge (int etype, long tail, long head)
 Gets any of the edges of the specified type between two given nodes (tail and head).
 
com.sparsity.sparksee.gdb.TypeList FindEdgeTypes ()
 Gets all existing Sparksee edge type identifiers.
 
long GetAttributeIntervalCount (int attr, com.sparsity.sparksee.gdb.Value lower, bool includeLower, com.sparsity.sparksee.gdb.Value higher, bool includeHigher)
 Gets how many objects have a value into the given range for the given attribute.
 
com.sparsity.sparksee.gdb.Objects Neighbors (com.sparsity.sparksee.gdb.Objects objs, int etype, com.sparsity.sparksee.gdb.EdgesDirection dir)
 Selects all neighbor nodes from or to each of the node OID in the given collection and for the given edge type.
 
void Backup (System.String file) throws System.ApplicationException, System.IO.IOException
 Dumps all the data to a backup file.
 
void RemoveAttribute (int attr)
 Removes the given attribute.
 
void RemoveType (int type)
 Removes the given type.
 
long Degree (long oid, int etype, com.sparsity.sparksee.gdb.EdgesDirection dir)
 Gets the number of edges from or to the given node OID and for the given edge type.
 
com.sparsity.sparksee.gdb.TypeList FindTypes ()
 Gets all existing Sparksee node and edge type identifiers.
 
int NewArrayAttribute (int type, System.String name, com.sparsity.sparksee.gdb.DataType dt, int size)
 Creates a new array attribute.
 
int FindType (System.String name)
 Gets the Sparksee type identifier for the given type name.
 
com.sparsity.sparksee.gdb.KeyValues TopK (int attribute, com.sparsity.sparksee.gdb.Condition operation, com.sparsity.sparksee.gdb.Value lower, com.sparsity.sparksee.gdb.Order order, int k)
 Gets a KeyValues iterator as a result of the TopK operation.
 
long GetEdgePeer (long edge, long node)
 Gets the other end for the given edge.
 
void SetAttributeText (long oid, int attr, com.sparsity.sparksee.gdb.TextStream tstream)
 Sets the writable TextStream for the given text attribute and OID.
 
void SetAttribute (int attr, com.sparsity.sparksee.gdb.Value value)
 Sets the value of the given attribute for all the objects of the types the attribute applies to.
 
void IndexNeighbors (int edgeType, bool neighbors)
 Creates or destroys the neighbors index of an edge type.
 
int GetObjectType (long oid)
 Gets the Sparksee node or edge type identifier for the given OID.
 
void IndexAttribute (int attr, com.sparsity.sparksee.gdb.AttributeKind kind)
 Updates the index of the given attribute.
 
void SetArrayAttribute (int attr, com.sparsity.sparksee.gdb.Value value)
 Sets all the values of the array of the given array attribute for all the objects of the types the attribute applies to.
 
com.sparsity.sparksee.gdb.KeyValues TopK (int attribute, com.sparsity.sparksee.gdb.Order order, int k)
 Gets a KeyValues iterator as a result of the TopK operation.
 
void GetAttribute (long oid, int attr, com.sparsity.sparksee.gdb.Value value)
 Gets the Value for the given attribute and OID.
 
com.sparsity.sparksee.gdb.AttributeStatistics GetAttributeStatistics (int attr, bool basic)
 Gets statistics from the given attribute.
 
com.sparsity.sparksee.gdb.Objects Select (int attr, com.sparsity.sparksee.gdb.Condition cond, com.sparsity.sparksee.gdb.Value lower, com.sparsity.sparksee.gdb.Value higher, com.sparsity.sparksee.gdb.Objects restriction)
 Selects all OIDs satisfying the given condition for the given attribute.
 
long CountNodes ()
 Gets the number of nodes.
 
com.sparsity.sparksee.gdb.KeyValues TopK (int attribute, com.sparsity.sparksee.gdb.Condition operation, com.sparsity.sparksee.gdb.Value lower, com.sparsity.sparksee.gdb.Order order, int k, com.sparsity.sparksee.gdb.Objects restriction)
 Gets a KeyValues iterator as a result of the TopK operation.
 
void SetAttributeDefaultValue (int attr, com.sparsity.sparksee.gdb.Value value)
 Sets a default value for an attribute.
 
long FindObject (int attr, com.sparsity.sparksee.gdb.Value value)
 Finds one object having the given Value for the given attribute.
 
com.sparsity.sparksee.gdb.Objects Neighbors (long oid, int etype, com.sparsity.sparksee.gdb.EdgesDirection dir)
 Selects all neighbor nodes from or to the given node OID and for the given edge type.
 
int NewSessionAttribute (int type, com.sparsity.sparksee.gdb.DataType dt, com.sparsity.sparksee.gdb.AttributeKind kind)
 Creates a new Session attribute.
 
void EncryptedBackup (System.String file, System.String keyInHex, System.String ivInHex) throws System.ApplicationException, System.IO.IOException
 Dumps all the data to a backup file.
 
void Drop (long oid)
 Drops the given OID.
 
void SetArrayAttributeVoid (long oid, int attr, com.sparsity.sparksee.gdb.Value value)
 Sets all the elements of the ValueArray for the given array attribute and OID.
 
com.sparsity.sparksee.gdb.Objects Edges (int etype, long tail, long head)
 Gets all the edges of the given type between two given nodes (tail and head).
 
void SetAttribute (long oid, int attr, com.sparsity.sparksee.gdb.Value value)
 Sets the Value for the given attribute and OID.
 
long FindEdge (int etype, long tail, long head)
 Gets any of the edges of the given type between two given nodes (tail and head).
 
com.sparsity.sparksee.gdb.Objects Tails (com.sparsity.sparksee.gdb.Objects edges)
 Gets all the tails from the given edges collection.
 
com.sparsity.sparksee.gdb.Objects Select (int attr, com.sparsity.sparksee.gdb.Condition cond, com.sparsity.sparksee.gdb.Value lower, com.sparsity.sparksee.gdb.Value higher)
 Selects all OIDs satisfying the given condition for the given attribute.
 
com.sparsity.sparksee.gdb.Values GetValues (int attr)
 Gets the Value collection for the given attribute.
 
void Export (System.String file, com.sparsity.sparksee.gdb.ExportType type, com.sparsity.sparksee.gdb.ExportManager em) throws System.IO.IOException
 Exports the Graph.
 
int NewRestrictedEdgeType (System.String name, int tail, int head, bool neighbors)
 Creates a new restricted edge type.
 
com.sparsity.sparksee.gdb.TextStream GetAttributeText (long oid, int attr)
 Gets the read-only TextStream for the given text attribute and OID.
 
com.sparsity.sparksee.gdb.Objects Explode (com.sparsity.sparksee.gdb.Objects objs, int etype, com.sparsity.sparksee.gdb.EdgesDirection dir)
 Selects all edges from or to each of the node OID in the given collection and for the given edge type.
 
int NewEdgeType (System.String name, bool directed, bool neighbors)
 Creates a new edge type.
 
com.sparsity.sparksee.gdb.KeyValues TopK (int attribute, com.sparsity.sparksee.gdb.Condition operation, com.sparsity.sparksee.gdb.Value lower, com.sparsity.sparksee.gdb.Value higher, com.sparsity.sparksee.gdb.Order order, int k)
 Gets a KeyValues iterator as a result of the TopK operation.
 
com.sparsity.sparksee.gdb.KeyValues TopK (int attribute, com.sparsity.sparksee.gdb.Order order, int k, com.sparsity.sparksee.gdb.Objects restriction)
 Gets a KeyValues iterator as a result of the TopK operation.
 
void DumpData (System.String file) throws System.ApplicationException, System.IO.IOException
 Dumps logical data to a file.
 
com.sparsity.sparksee.gdb.ValueArray SetArrayAttribute (long oid, int attr, com.sparsity.sparksee.gdb.Value value)
 Sets all the elements of the ValueArray for the given array attribute and OID and returns it.
 
com.sparsity.sparksee.gdb.KeyValues TopK (int attribute, com.sparsity.sparksee.gdb.Condition operation, com.sparsity.sparksee.gdb.Value lower, com.sparsity.sparksee.gdb.Value higher, com.sparsity.sparksee.gdb.Order order, int k, com.sparsity.sparksee.gdb.Objects restriction)
 Gets a KeyValues iterator as a result of the TopK operation.
 
int FindAttribute (int type, System.String name)
 Gets the Sparksee attribute identifier for the given type identifier and attribute name.
 
long NewNode (int type)
 Creates a new node instance.
 
com.sparsity.sparksee.gdb.TypeList FindNodeTypes ()
 Gets all existing Sparksee node type identifiers.
 
int NewAttribute (int type, System.String name, com.sparsity.sparksee.gdb.DataType dt, com.sparsity.sparksee.gdb.AttributeKind kind)
 Creates a new attribute.
 
int NewSessionArrayAttribute (int type, com.sparsity.sparksee.gdb.DataType dt, int size)
 Creates a new Session array attribute.
 
com.sparsity.sparksee.gdb.AttributeList GetAttributes (long oid, bool withValues, bool withNames)
 Gets all Sparksee attribute identifiers with a non-NULL value for the given Sparksee OID.
 
long NewEdge (int type, int tailAttr, com.sparsity.sparksee.gdb.Value tailV, int headAttr, com.sparsity.sparksee.gdb.Value headV)
 Creates a new edge instance.
 
com.sparsity.sparksee.gdb.Attribute GetAttribute (int attr)
 Gets information about the given attribute.
 
com.sparsity.sparksee.gdb.Session GetSession ()
 Gets the Session this Graph belongs to.
 
int NewNodeType (System.String name)
 Creates a new node type.
 
void DumpStorage (System.String file) throws System.ApplicationException, System.IO.IOException
 Dumps internal storage data to a file.
 
com.sparsity.sparksee.gdb.Objects Select (int type)
 Selects all OIDs belonging to the given type.
 
com.sparsity.sparksee.gdb.Objects Select (int attr, com.sparsity.sparksee.gdb.Condition cond, com.sparsity.sparksee.gdb.Value value, com.sparsity.sparksee.gdb.Objects restriction)
 Selects all OIDs satisfying the given condition for the given attribute.
 
com.sparsity.sparksee.gdb.Objects Select (int attr, com.sparsity.sparksee.gdb.Condition cond, com.sparsity.sparksee.gdb.Value value)
 Selects all OIDs satisfying the given condition for the given attribute.
 
void RenameAttribute (int attr, System.String newName)
 Renames an attribute.
 
long CountEdges ()
 Gets the number of edges.
 
void RenameType (int type, System.String newName)
 Renames a type.
 
void TailsAndHeads (com.sparsity.sparksee.gdb.Objects edges, com.sparsity.sparksee.gdb.Objects tails, com.sparsity.sparksee.gdb.Objects heads)
 Gets all the tails and heads from the given edges collection.
 
int NewSessionAttribute (int type, com.sparsity.sparksee.gdb.DataType dt, com.sparsity.sparksee.gdb.AttributeKind kind, com.sparsity.sparksee.gdb.Value defaultValue)
 Creates a new Session attribute with a default value.
 
com.sparsity.sparksee.gdb.Objects Heads (com.sparsity.sparksee.gdb.Objects edges)
 Gets all the heads from the given edges collection.
 
int NewAttribute (int type, System.String name, com.sparsity.sparksee.gdb.DataType dt, com.sparsity.sparksee.gdb.AttributeKind kind, com.sparsity.sparksee.gdb.Value defaultValue)
 Creates a new attribute with a default value.
 
void RenameType (System.String oldName, System.String newName)
 Renames a type.
 
com.sparsity.sparksee.gdb.Objects Explode (long oid, int etype, com.sparsity.sparksee.gdb.EdgesDirection dir)
 Selects all edges from or to the given node OID and for the given edge type.
 
com.sparsity.sparksee.gdb.AttributeList GetAttributes (long oid)
 Gets all Sparksee attribute identifiers with a non-NULL value for the given Sparksee OID.
 
com.sparsity.sparksee.gdb.AttributeList FindAttributes (int type)
 Gets all existing Sparksee attribute identifiers for the given type identifier.
 
com.sparsity.sparksee.gdb.ValueArray GetArrayAttribute (long oid, int attr)
 Gets the ValueArray for the given array attribute and OID or NULL if it does not exist.
 
com.sparsity.sparksee.gdb.Value GetAttribute (long oid, int attr)
 Gets the Value for the given attribute and OID.
 
long FindOrCreateObject (int attr, com.sparsity.sparksee.gdb.Value value)
 Finds one object having the given Value for the attribute or it creates one does not exist any.
 
com.sparsity.sparksee.gdb.EdgeData GetEdgeData (long edge)
 Gets information about an edge.
 
void Drop (com.sparsity.sparksee.gdb.Objects objs)
 Drops all the OIDs from the given collection.
 
long NewEdge (int type, long tail, long head)
 Creates a new edge instance.
 
com.sparsity.sparksee.gdb.Type GetType (int type)
 Gets information about the given type.
 

Detailed Description

Graph class.

Each Database has a Graph associated, which is the persistent graph which contains all data stored into the graph database and is retrieved from a Session.

Check out the 'API' and the 'SPARKSEE graph database' sections in the SPARKSEE User Manual for more details on the use of this class.

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

Member Function Documentation

◆ Backup()

void com.sparsity.sparksee.gdb.Graph.Backup ( System.String file) throws System.ApplicationException, System.IO.IOException

Dumps all the data to a backup file.

See the Sparksee class Restore methods. Errorfor other issues.

Parameters
file[in] Output backup file path.
Exceptions
System.ApplicationExceptionnull
System.IO.IOExceptionIf the given file cannot be created.

◆ CountEdges()

long com.sparsity.sparksee.gdb.Graph.CountEdges ( )

Gets the number of edges.

Returns
The number of edges.

◆ CountNodes()

long com.sparsity.sparksee.gdb.Graph.CountNodes ( )

Gets the number of nodes.

Returns
The number of nodes.

◆ Degree()

long com.sparsity.sparksee.gdb.Graph.Degree ( long oid,
int etype,
com.sparsity.sparksee.gdb.EdgesDirection dir )

Gets the number of edges from or to the given node OID and for the given edge type.

Parameters
oid[in] Sparksee node OID.
etype[in] Sparksee edge type identifier.
dir[in] Direction.
Returns
The number of edges.

◆ Drop() [1/2]

void com.sparsity.sparksee.gdb.Graph.Drop ( com.sparsity.sparksee.gdb.Objects objs)

Drops all the OIDs from the given collection.

See Drop method with the single OID parameter. This performs the same operation for each object in the given set.

Parameters
objs[in] Objects collection with the OIDs to be removed.

◆ Drop() [2/2]

void com.sparsity.sparksee.gdb.Graph.Drop ( long oid)

Drops the given OID.

It also removes its egdges as well as its attribute values.

Parameters
oid[in] Sparksee OID to be removed.

◆ DumpData()

void com.sparsity.sparksee.gdb.Graph.DumpData ( System.String file) throws System.ApplicationException, System.IO.IOException

Dumps logical data to a file.

Errorfor other issues.

Parameters
file[in] Output file path.
Exceptions
System.ApplicationExceptionnull
System.IO.IOExceptionIf the given file cannot be created.

◆ DumpStorage()

void com.sparsity.sparksee.gdb.Graph.DumpStorage ( System.String file) throws System.ApplicationException, System.IO.IOException

Dumps internal storage data to a file.

Errorfor other issues.

Parameters
file[in] Output file path.
Exceptions
System.ApplicationExceptionnull
System.IO.IOExceptionIf the given file cannot be created.

◆ Edges()

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Edges ( int etype,
long tail,
long head )

Gets all the edges of the given type between two given nodes (tail and head).

Parameters
etype[in] Sparksee edge type identifier.
tail[in] Tail node identifier.
head[in] Head node identifier.
Returns
Objects instance.

◆ EncryptedBackup()

void com.sparsity.sparksee.gdb.Graph.EncryptedBackup ( System.String file,
System.String keyInHex,
System.String ivInHex ) throws System.ApplicationException, System.IO.IOException

Dumps all the data to a backup file.

See the Sparksee class RestoreEncryptedBackup methods. Errorfor other issues.

Parameters
file[in] Output backup file path.
keyInHex[In] The AES encryption Key as an hexadecimal string (8, 16 or 32 bytes).
ivInHex[In] The AES Initialization Vector as an hexadecimal string (16 bytes).
Exceptions
System.ApplicationExceptionnull
System.IO.IOExceptionIf the given file cannot be created.

◆ Explode() [1/2]

Selects all edges from or to each of the node OID in the given collection and for the given edge type.

Parameters
objs[in] Sparksee node OID collection.
etype[in] Sparksee edge type identifier.
dir[in] Direction.
Returns
Objects instance.

◆ Explode() [2/2]

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Explode ( long oid,
int etype,
com.sparsity.sparksee.gdb.EdgesDirection dir )

Selects all edges from or to the given node OID and for the given edge type.

Parameters
oid[in] Sparksee node OID.
etype[in] Sparksee edge type identifier.
dir[in] Direction.
Returns
Objects instance.

◆ Export()

void com.sparsity.sparksee.gdb.Graph.Export ( System.String file,
com.sparsity.sparksee.gdb.ExportType type,
com.sparsity.sparksee.gdb.ExportManager em ) throws System.IO.IOException

Exports the Graph.

Parameters
file[in] Output file.
type[in] Export type.
em[in] Defines how to do the export for each graph object.
Exceptions
System.IO.IOExceptionfor errors writing to the file.

◆ FindAttribute()

int com.sparsity.sparksee.gdb.Graph.FindAttribute ( int type,
System.String name )

Gets the Sparksee attribute identifier for the given type identifier and attribute name.

Parameters
type[in] Sparksee type identifier.
name[in] Unique attribute name.
Returns
The Sparksee attribute identifier for the given type and attribute name or InvalidAttribute if there is no attribute with the given name for the given type.

◆ FindAttributes()

com.sparsity.sparksee.gdb.AttributeList com.sparsity.sparksee.gdb.Graph.FindAttributes ( int type)

Gets all existing Sparksee attribute identifiers for the given type identifier.

Parameters
type[in] Sparksee type identifier.
Returns
Sparksee attribute identifier list.

◆ FindEdge()

long com.sparsity.sparksee.gdb.Graph.FindEdge ( int etype,
long tail,
long head )

Gets any of the edges of the given type between two given nodes (tail and head).

If there are more than one, then any of them will be returned. And in case there are no edge between the given tail and head, the Objects InvalidOID will be returned.

Parameters
etype[in] Sparksee edge type identifier.
tail[in] Tail node identifier.
head[in] Head node identifier.
Returns
Any of the edges or the Objects InvalidOID.

◆ FindEdgeTypes()

com.sparsity.sparksee.gdb.TypeList com.sparsity.sparksee.gdb.Graph.FindEdgeTypes ( )

Gets all existing Sparksee edge type identifiers.

Returns
Sparksee edge type identifier list.

◆ FindNodeTypes()

com.sparsity.sparksee.gdb.TypeList com.sparsity.sparksee.gdb.Graph.FindNodeTypes ( )

Gets all existing Sparksee node type identifiers.

Returns
Sparksee node type identifier list.

◆ FindObject()

long com.sparsity.sparksee.gdb.Graph.FindObject ( int attr,
com.sparsity.sparksee.gdb.Value value )

Finds one object having the given Value for the given attribute.

If there are more than one, then any of them will be returned. And in case there are no object having this Value, the Objects InvalidOID will be returned.

Parameters
attr[in] Sparksee attribute identifier.
value[in] Value.
Returns
Sparksee OID or the Objects InvalidOID.

◆ FindOrCreateEdge()

long com.sparsity.sparksee.gdb.Graph.FindOrCreateEdge ( int etype,
long tail,
long head )

Gets any of the edges of the specified type between two given nodes (tail and head).

If it can not find any edge of this type between them it tries to create a new one.

Parameters
etype[in] Sparksee edge type identifier.
tail[in] Tail node identifier.
head[in] Head node identifier.
Returns
Any of the edges or the Objects InvalidOID.

◆ FindOrCreateObject()

long com.sparsity.sparksee.gdb.Graph.FindOrCreateObject ( int attr,
com.sparsity.sparksee.gdb.Value value )

Finds one object having the given Value for the attribute or it creates one does not exist any.

If the attribute is a node or edge attribute and at least one node/edge with that value is found, it returns one of them. But if it does not exist, then: If it's a node attribute it will create it and set the attribute. If it's an edge attribute it will return the InvalidOID.

Using this method with a global attribute will return the InvalidOID.

Parameters
attr[in] Sparksee attribute identifier.
value[in] Value.
Returns
Sparksee OID or the Objects InvalidOID.

◆ FindType()

int com.sparsity.sparksee.gdb.Graph.FindType ( System.String name)

Gets the Sparksee type identifier for the given type name.

Parameters
name[in] Unique type name.
Returns
The Sparksee type identifier for the given type name or the Type InvalidType if there is no type with the given name.

◆ FindTypes()

com.sparsity.sparksee.gdb.TypeList com.sparsity.sparksee.gdb.Graph.FindTypes ( )

Gets all existing Sparksee node and edge type identifiers.

Returns
Sparksee node and edge type identifier list.

◆ GetArrayAttribute()

com.sparsity.sparksee.gdb.ValueArray com.sparsity.sparksee.gdb.Graph.GetArrayAttribute ( long oid,
int attr )

Gets the ValueArray for the given array attribute and OID or NULL if it does not exist.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee array attribute identifier.
Returns
A ValueArray. This returns a ValueArray, a NULL or throws an exception.

◆ GetAttribute() [1/3]

com.sparsity.sparksee.gdb.Attribute com.sparsity.sparksee.gdb.Graph.GetAttribute ( int attr)

Gets information about the given attribute.

Parameters
attr[in] Sparksee attribute identifier.
Returns
The Attribute for the given Sparksee attribute identifier.

◆ GetAttribute() [2/3]

com.sparsity.sparksee.gdb.Value com.sparsity.sparksee.gdb.Graph.GetAttribute ( long oid,
int attr )

Gets the Value for the given attribute and OID.

The other version of this call, where the Value is an output parameter instead of the return, is better because it allows the user to reuse an existing Value instance, whereas this call always creates a new Value instance to be returned.

It never returns NULL. Thus, in case the OID has a NULL value for the attribute it returns a NULL Value instance.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee attribute identifier.
Returns
A new Value instance having the attribute value for the given OID.

◆ GetAttribute() [3/3]

void com.sparsity.sparksee.gdb.Graph.GetAttribute ( long oid,
int attr,
com.sparsity.sparksee.gdb.Value value )

Gets the Value for the given attribute and OID.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee attribute identifier.
value[in|out] Value for the given attribute and for the given OID.

◆ GetAttributeIntervalCount()

long com.sparsity.sparksee.gdb.Graph.GetAttributeIntervalCount ( int attr,
com.sparsity.sparksee.gdb.Value lower,
bool includeLower,
com.sparsity.sparksee.gdb.Value higher,
bool includeHigher )

Gets how many objects have a value into the given range for the given attribute.

This only works for the attributes with the AttributeKind Indexed or Unique.

Given values must belong to the same DataType than the attribute.

Parameters
attr[in] Sparksee attribute identifier.
lower[in] Lower bound Value of the range.
includeLower[in] If TRUE, include lower bound Value of the range.
higher[in] Higher bound Value of the range.
includeHigher[in] If TRUE, include higher bound Value of the range.
Returns
Number of objects having a value into the given range.

◆ GetAttributes() [1/2]

com.sparsity.sparksee.gdb.AttributeList com.sparsity.sparksee.gdb.Graph.GetAttributes ( long oid)

Gets all Sparksee attribute identifiers with a non-NULL value for the given Sparksee OID.

Parameters
oid[in] Sparksee OID.
Returns
Sparksee attribute identifier list.

◆ GetAttributes() [2/2]

com.sparsity.sparksee.gdb.AttributeList com.sparsity.sparksee.gdb.Graph.GetAttributes ( long oid,
bool withValues,
bool withNames )

Gets all Sparksee attribute identifiers with a non-NULL value for the given Sparksee OID.

Additional options can be set to also get it's Values and the names of the attributes. The Text and Array attributes will have the Value set to Null because they can't be represented as a simple Value object.

Parameters
oid[in] Sparksee OID.
withValues[in] True to also get the Values of each attribute.
withNames[in] True to also get the Names of each attribute.
Returns
Sparksee attribute identifier list.

◆ GetAttributeStatistics()

com.sparsity.sparksee.gdb.AttributeStatistics com.sparsity.sparksee.gdb.Graph.GetAttributeStatistics ( int attr,
bool basic )

Gets statistics from the given attribute.

The statistics can only be obtained from Indexed or Unique attributes.

Parameters
attr[in] Sparksee attribute identifier.
basic[in] If FALSE all statistics are computed, if TRUE just those statistics marked as basic will be computed (see description of the AttributeStatistics class). Of course, computing just basic statistics will be faster than computing all of them.
Returns
An AttributeStatistics instace.

◆ GetAttributeText()

com.sparsity.sparksee.gdb.TextStream com.sparsity.sparksee.gdb.Graph.GetAttributeText ( long oid,
int attr )

Gets the read-only TextStream for the given text attribute and OID.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee attribute identifier.
Returns
A TextStream. This returns a TextStream to read.

◆ GetEdgeData()

com.sparsity.sparksee.gdb.EdgeData com.sparsity.sparksee.gdb.Graph.GetEdgeData ( long edge)

Gets information about an edge.

Parameters
edge[in] Sparksee edge identifier.
Returns
An EdgeData instance.

◆ GetEdgePeer()

long com.sparsity.sparksee.gdb.Graph.GetEdgePeer ( long edge,
long node )

Gets the other end for the given edge.

Parameters
edge[in] Sparksee edge identifier.
node[in] Sparksee node identifier. It must be one of the ends of the edge.
Returns
The other end of the edge.

◆ GetObjectType()

int com.sparsity.sparksee.gdb.Graph.GetObjectType ( long oid)

Gets the Sparksee node or edge type identifier for the given OID.

Parameters
oid[in] Sparksee OID.
Returns
Sparksee node or edge type identifier.

◆ GetSession()

com.sparsity.sparksee.gdb.Session com.sparsity.sparksee.gdb.Graph.GetSession ( )

Gets the Session this Graph belongs to.

Returns
The owning Session instance.

◆ GetType()

com.sparsity.sparksee.gdb.Type com.sparsity.sparksee.gdb.Graph.GetType ( int type)

Gets information about the given type.

Parameters
type[in] Sparksee type identifier.
Returns
The Type for the given Sparksee type identifier.

◆ GetValues()

com.sparsity.sparksee.gdb.Values com.sparsity.sparksee.gdb.Graph.GetValues ( int attr)

Gets the Value collection for the given attribute.

Parameters
attr[in] Sparksee attribute identifier.
Returns
Returns a Values object.

◆ Heads()

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Heads ( com.sparsity.sparksee.gdb.Objects edges)

Gets all the heads from the given edges collection.

Parameters
edges[in] Sparksee edge identifier collection.
Returns
The heads collection.

◆ IndexAttribute()

void com.sparsity.sparksee.gdb.Graph.IndexAttribute ( int attr,
com.sparsity.sparksee.gdb.AttributeKind kind )

Updates the index of the given attribute.

This just works if the current index of the attribute corresponds to the AttributeKind Basic and the new one is Indexed or Unique.

Parameters
attr[in] Sparksee attribute identifier.
kind[in] Attribute kind.

◆ IndexNeighbors()

void com.sparsity.sparksee.gdb.Graph.IndexNeighbors ( int edgeType,
bool neighbors )

Creates or destroys the neighbors index of an edge type.

Parameters
edgeType[in] Sparksee Edge type identifier.
neighbors[in] If TRUE, it indexes the neighbor nodes, otherwise it removes the index.

◆ Neighbors() [1/2]

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Neighbors ( com.sparsity.sparksee.gdb.Objects objs,
int etype,
com.sparsity.sparksee.gdb.EdgesDirection dir )

Selects all neighbor nodes from or to each of the node OID in the given collection and for the given edge type.

Parameters
objs[in] Sparksee node OID collection.
etype[in] Sparksee edge type identifier.
dir[in] Direction.
Returns
Objects instance.

◆ Neighbors() [2/2]

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Neighbors ( long oid,
int etype,
com.sparsity.sparksee.gdb.EdgesDirection dir )

Selects all neighbor nodes from or to the given node OID and for the given edge type.

Parameters
oid[in] Sparksee node OID.
etype[in] Sparksee edge type identifier.
dir[in] Direction.
Returns
Objects instance.

◆ NewArrayAttribute()

int com.sparsity.sparksee.gdb.Graph.NewArrayAttribute ( int type,
System.String name,
com.sparsity.sparksee.gdb.DataType dt,
int size )

Creates a new array attribute.

Parameters
type[in] Sparksee node or edge type identifier.
name[in] Unique name for the new attribute.
dt[in] Base Data type for the new array attribute elements.
size[in] The array size.
Returns
Unique Sparksee attribute identifier.

◆ NewAttribute() [1/2]

int com.sparsity.sparksee.gdb.Graph.NewAttribute ( int type,
System.String name,
com.sparsity.sparksee.gdb.DataType dt,
com.sparsity.sparksee.gdb.AttributeKind kind )

Creates a new attribute.

Parameters
type[in] Sparksee node or edge type identifier.
name[in] Unique name for the new attribute.
dt[in] Data type for the new attribute.
kind[in] Attribute kind.
Returns
Unique Sparksee attribute identifier.

◆ NewAttribute() [2/2]

int com.sparsity.sparksee.gdb.Graph.NewAttribute ( int type,
System.String name,
com.sparsity.sparksee.gdb.DataType dt,
com.sparsity.sparksee.gdb.AttributeKind kind,
com.sparsity.sparksee.gdb.Value defaultValue )

Creates a new attribute with a default value.

Parameters
type[in] Sparksee node or edge type identifier.
name[in] Unique name for the new attribute.
dt[in] Data type for the new attribute.
kind[in] Attribute kind.
defaultValue[in] The default value to use in each new node/edge.
Returns
Unique Sparksee attribute identifier.

◆ NewEdge() [1/2]

long com.sparsity.sparksee.gdb.Graph.NewEdge ( int type,
int tailAttr,
com.sparsity.sparksee.gdb.Value tailV,
int headAttr,
com.sparsity.sparksee.gdb.Value headV )

Creates a new edge instance.

The tail of the edge will be any node having the given tailV Value for the given tailAttr attribute identifier, and the head of the edge will be any node having the given headV Value for the given headAttr attribute identifier.

Parameters
type[in] Sparksee type identifier.
tailAttr[in] Sparksee attribute identifier.
tailV[in] Value.
headAttr[in] Sparksee attribute identifier.
headV[in] Value.
Returns
Unique OID of the new edge instance.

◆ NewEdge() [2/2]

long com.sparsity.sparksee.gdb.Graph.NewEdge ( int type,
long tail,
long head )

Creates a new edge instance.

Parameters
type[in] Sparksee type identifier.
tail[in] Source Sparksee OID.
head[in] Target Sparksee OID.
Returns
Unique OID of the new edge instance.

◆ NewEdgeType()

int com.sparsity.sparksee.gdb.Graph.NewEdgeType ( System.String name,
bool directed,
bool neighbors )

Creates a new edge type.

Parameters
name[in] Unique name for the new edge type.
directed[in] If TRUE, this creates a directed edge type, otherwise this creates a undirected edge type.
neighbors[in] If TRUE, this indexes neighbor nodes, otherwise not.
Returns
Unique Sparksee type identifier.

◆ NewNode()

long com.sparsity.sparksee.gdb.Graph.NewNode ( int type)

Creates a new node instance.

Parameters
type[in] Sparksee type identifier.
Returns
Unique OID of the new node instance.

◆ NewNodeType()

int com.sparsity.sparksee.gdb.Graph.NewNodeType ( System.String name)

Creates a new node type.

Parameters
name[in] Unique name for the new node type.
Returns
Unique Sparksee type identifier.

◆ NewRestrictedEdgeType()

int com.sparsity.sparksee.gdb.Graph.NewRestrictedEdgeType ( System.String name,
int tail,
int head,
bool neighbors )

Creates a new restricted edge type.

Parameters
name[in] Unique name for the new edge type.
tail[in] Tail Sparksee node type identifier.
head[in] Head Sparksee node type identifier.
neighbors[in] If TRUE, this indexes neighbor nodes, otherwise not.
Returns
Unique Sparksee type identifier.

◆ NewSessionArrayAttribute()

int com.sparsity.sparksee.gdb.Graph.NewSessionArrayAttribute ( int type,
com.sparsity.sparksee.gdb.DataType dt,
int size )

Creates a new Session array attribute.

Session attributes are exclusive for the Session (just its Session can use the attribute) and are automatically removed when the Session is closed (thus, attribute data is not persistent into the database).

Since they are not persistent, they cannot be retrieved from the database, so they do not have an identifier name.

Parameters
type[in] Sparksee node or edge type identifier.
dt[in] Base Data type for the new array attribute elements.
size[in] The array size.
Returns
Unique Sparksee attribute identifier.

◆ NewSessionAttribute() [1/2]

int com.sparsity.sparksee.gdb.Graph.NewSessionAttribute ( int type,
com.sparsity.sparksee.gdb.DataType dt,
com.sparsity.sparksee.gdb.AttributeKind kind )

Creates a new Session attribute.

Session attributes are exclusive for the Session (just its Session can use the attribute) and are automatically removed when the Session is closed (thus, attribute data is not persistent into the database).

Since they are not persistent, they cannot be retrieved from the database, so they do not have an identifier name.

Parameters
type[in] Sparksee node or edge type identifier.
dt[in] Data type for the new attribute.
kind[in] Attribute kind.
Returns
Unique Sparksee attribute identifier.

◆ NewSessionAttribute() [2/2]

int com.sparsity.sparksee.gdb.Graph.NewSessionAttribute ( int type,
com.sparsity.sparksee.gdb.DataType dt,
com.sparsity.sparksee.gdb.AttributeKind kind,
com.sparsity.sparksee.gdb.Value defaultValue )

Creates a new Session attribute with a default value.

Session attributes are exclusive for the Session (just its Session can use the attribute) and are automatically removed when the Session is closed (thus, attribute data is not persistent into the database).

Since they are not persistent, they cannot be retrieved from the database, so they do not have an identifier name.

Parameters
type[in] Sparksee node or edge type identifier.
dt[in] Data type for the new attribute.
kind[in] Attribute kind.
defaultValue[in] The default value to use in each new node/edge.
Returns
Unique Sparksee attribute identifier.

◆ RemoveAttribute()

void com.sparsity.sparksee.gdb.Graph.RemoveAttribute ( int attr)

Removes the given attribute.

Parameters
attr[in] Sparksee attribute identifier.

◆ RemoveType()

void com.sparsity.sparksee.gdb.Graph.RemoveType ( int type)

Removes the given type.

This fails if there exist attributes defined for the type or if there exist restricted edges referencing this type.

Parameters
type[in] Sparksee type identifier.

◆ RenameAttribute()

void com.sparsity.sparksee.gdb.Graph.RenameAttribute ( int attr,
System.String newName )

Renames an attribute.

The new name must be available.

Parameters
attr[in] Sparksee attribute identifier.
newName[in] The new name for the attribute.

◆ RenameType() [1/2]

void com.sparsity.sparksee.gdb.Graph.RenameType ( int type,
System.String newName )

Renames a type.

The new name must be available.

Parameters
type[in] The type to be renamed.
newName[in] The new name for the type.

◆ RenameType() [2/2]

void com.sparsity.sparksee.gdb.Graph.RenameType ( System.String oldName,
System.String newName )

Renames a type.

The new name must be available.

Parameters
oldName[in] The current name of the type to be renamed.
newName[in] The new name for the type.

◆ Select() [1/5]

Selects all OIDs satisfying the given condition for the given attribute.

This allows to perform the Between operation, thus it has two Value arguments.

Parameters
attr[in] Sparksee attribute identifier.
cond[in] Condition to be satisfied. It must be the Between Condition.
lower[in] Lower-bound Value to be satisfied.
higher[in] Higher-bound Value to be satisfied.
Returns
Objects instance.

◆ Select() [2/5]

Selects all OIDs satisfying the given condition for the given attribute.

This allows to perform the Between operation, thus it has two Value arguments.

Parameters
attr[in] Sparksee attribute identifier.
cond[in] Condition to be satisfied. It must be the Between Condition.
lower[in] Lower-bound Value to be satisfied.
higher[in] Higher-bound Value to be satisfied.
restriction[in] Objects to limit the select in this set of objects.
Returns
Objects instance.

◆ Select() [3/5]

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Select ( int attr,
com.sparsity.sparksee.gdb.Condition cond,
com.sparsity.sparksee.gdb.Value value )

Selects all OIDs satisfying the given condition for the given attribute.

Parameters
attr[in] Sparksee attribute identifier.
cond[in] Condition to be satisfied.
value[in] Value to be satisfied.
Returns
Objects instance.

◆ Select() [4/5]

Selects all OIDs satisfying the given condition for the given attribute.

Parameters
attr[in] Sparksee attribute identifier.
cond[in] Condition to be satisfied.
value[in] Value to be satisfied.
restriction[in] Objects to limit the select in this set of objects.
Returns
Objects instance.

◆ Select() [5/5]

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Select ( int type)

Selects all OIDs belonging to the given type.

Parameters
type[in] Sparksee type identifier.
Returns
Objects instance.

◆ SetArrayAttribute() [1/2]

void com.sparsity.sparksee.gdb.Graph.SetArrayAttribute ( int attr,
com.sparsity.sparksee.gdb.Value value )

Sets all the values of the array of the given array attribute for all the objects of the types the attribute applies to.

Parameters
attr[in] Sparksee array attribute identifier.
value[in] Value for all the array elements of the arrays.

◆ SetArrayAttribute() [2/2]

com.sparsity.sparksee.gdb.ValueArray com.sparsity.sparksee.gdb.Graph.SetArrayAttribute ( long oid,
int attr,
com.sparsity.sparksee.gdb.Value value )

Sets all the elements of the ValueArray for the given array attribute and OID and returns it.

Initializing the array with one of these SetArrayAttribute methods is the only way to create the array. But once created it can be updated using the ValueArray. And you can get it again with the GetArrayAttribute operation.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee array attribute identifier.
value[in] Value for all the array elements of the given attribute and OID.
Returns
A ValueArray. This returns a ValueArray, a NULL or throws an exception.

◆ SetArrayAttributeVoid()

void com.sparsity.sparksee.gdb.Graph.SetArrayAttributeVoid ( long oid,
int attr,
com.sparsity.sparksee.gdb.Value value )

Sets all the elements of the ValueArray for the given array attribute and OID.

Initializing the array with one of these SetArrayAttribute methods is the only way to create the array. But once created it can be updated using the ValueArray which can be obtained using the GetArrayAttribute operation.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee array attribute identifier.
value[in] Value for all the array elements of the given attribute and OID.

◆ SetAttribute() [1/2]

void com.sparsity.sparksee.gdb.Graph.SetAttribute ( int attr,
com.sparsity.sparksee.gdb.Value value )

Sets the value of the given attribute for all the objects of the types the attribute applies to.

Does not work for TEXT attribute types

txThe Transaction this operation belongs to attributeThe attribute to initialize

Parameters
attrnull
valueThe value to initialize the attribute to

◆ SetAttribute() [2/2]

void com.sparsity.sparksee.gdb.Graph.SetAttribute ( long oid,
int attr,
com.sparsity.sparksee.gdb.Value value )

Sets the Value for the given attribute and OID.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee attribute identifier.
value[in] Value for the given attribute and for the given OID.

◆ SetAttributeDefaultValue()

void com.sparsity.sparksee.gdb.Graph.SetAttributeDefaultValue ( int attr,
com.sparsity.sparksee.gdb.Value value )

Sets a default value for an attribute.

The default value will be applied to all the new nodes or edges.

The given value must have the same DataType as the attribute or be a NULL value to remove the current default value.

Parameters
attr[in] The attribute.
value[in] The default value to use for this attribute.

◆ SetAttributeText()

void com.sparsity.sparksee.gdb.Graph.SetAttributeText ( long oid,
int attr,
com.sparsity.sparksee.gdb.TextStream tstream )

Sets the writable TextStream for the given text attribute and OID.

Parameters
oid[in] Sparksee OID.
attr[in] Sparksee attribute identifier.
tstream[in] New Text value. This corresponds to a TextStream to write.

◆ Tails()

com.sparsity.sparksee.gdb.Objects com.sparsity.sparksee.gdb.Graph.Tails ( com.sparsity.sparksee.gdb.Objects edges)

Gets all the tails from the given edges collection.

Parameters
edges[in] Sparksee edge identifier collection.
Returns
The tails collection.

◆ TailsAndHeads()

void com.sparsity.sparksee.gdb.Graph.TailsAndHeads ( com.sparsity.sparksee.gdb.Objects edges,
com.sparsity.sparksee.gdb.Objects tails,
com.sparsity.sparksee.gdb.Objects heads )

Gets all the tails and heads from the given edges collection.

Parameters
edges[in] Sparksee edge identifier collection.
tails[in|out] If not NULL, all the tails will be stored here.
heads[in|out] If not NULL, all the heads will be stored here.

◆ TopK() [1/6]

com.sparsity.sparksee.gdb.KeyValues com.sparsity.sparksee.gdb.Graph.TopK ( int attribute,
com.sparsity.sparksee.gdb.Condition operation,
com.sparsity.sparksee.gdb.Value lower,
com.sparsity.sparksee.gdb.Order order,
int k )

Gets a KeyValues iterator as a result of the TopK operation.

Parameters
attributeThe attribute to perform the TopK on
operationThe operation to perform in the top k
lowerThe lower bound Value to be satisfied
orderThe ordering semantincs of the top-k
kThe size of the TopK
Returns
A KeyValues instance

◆ TopK() [2/6]

Gets a KeyValues iterator as a result of the TopK operation.

restrictonObjects to limit the topk to this set of objects

Parameters
attributeThe attribute to perform the TopK on
operationThe operation to perform in the top k
lowerThe lower bound Value to be satisfied
orderThe ordering semantincs of the top-k
kThe size of the TopK
restrictionnull
Returns
A KeyValues instance

◆ TopK() [3/6]

Gets a KeyValues iterator as a result of the TopK operation.

Parameters
attributeThe attribute to perform the TopK on
operationThe operation to perform in the top k
lowerThe lower bound Value to be satisfied
higherThe upper bound Value to be satisfied
orderThe ordering semantincs of the top-k
kThe size of the TopK
Returns
A KeyValues instance

◆ TopK() [4/6]

Gets a KeyValues iterator as a result of the TopK operation.

restrictonObjects to limit the topk to this set of objects

Parameters
attributeThe attribute to perform the TopK on
operationThe operation to perform in the top k
lowerThe lower bound Value to be satisfied
higherThe upper bound Value to be satisfied
orderThe ordering semantincs of the top-k
kThe size of the TopK
restrictionnull
Returns
A KeyValues instance

◆ TopK() [5/6]

com.sparsity.sparksee.gdb.KeyValues com.sparsity.sparksee.gdb.Graph.TopK ( int attribute,
com.sparsity.sparksee.gdb.Order order,
int k )

Gets a KeyValues iterator as a result of the TopK operation.

Parameters
attributeThe attribute to perform the TopK on
orderThe ordering semantincs of the top-k
kThe size of the TopK
Returns
A KeyValues instance

◆ TopK() [6/6]

com.sparsity.sparksee.gdb.KeyValues com.sparsity.sparksee.gdb.Graph.TopK ( int attribute,
com.sparsity.sparksee.gdb.Order order,
int k,
com.sparsity.sparksee.gdb.Objects restriction )

Gets a KeyValues iterator as a result of the TopK operation.

restrictonObjects to limit the topk to this set of objects

Parameters
attributeThe attribute to perform the TopK on
orderThe ordering semantincs of the top-k
kThe size of the TopK
restrictionnull
Returns
A KeyValues instance