GraphDB-SE RDF Rank

Skip to end of metadata
Go to start of metadata
This documentation is NOT for the latest version of GraphDB.

Latest version - GraphDB 7.1

GraphDB Documentation

Next versions

GraphDB 6.4
GraphDB 6.5
GraphDB 6.6
GraphDB 7.0
GraphDB 7.1

Previous versions

GraphDB 6.2
GraphDB 6.0 & 6.1

[OWLIM 5.4]
[OWLIM 5.2]
[OWLIM 5.1]
[OWLIM 5.0]
[OWLIM 4.4]
[OWLIM 4.3]
[OWLIM 4.2]
[OWLIM 4.1]
[OWLIM 4.0]


RDF Rank is an algorithm, which identifies the more important or more popular entities in the repository by examining their interconnectedness. The popularity of entities can then be used to order query results in a similar way to the internet search engines, such as how Google orders search results using PageRank
The RDF Rank component computes a numerical weighting for all the nodes in the entire RDF graph stored in the repository, including URIs, blank nodes and literals. The weights are floating point numbers with values between 0 and 1 that can be interpreted as a measure of a node's relevance/popularity.
Since the values range from 0 to 1, the weights can be used for sorting a result set (the lexicographical order works fine even if the rank literals are interpreted as plain strings). Here is an example SPARQL query that uses RDF rank for sorting results by their popularity:

PREFIX rank: <>
PREFIX opencyc-en: <>
  ?Person a opencyc-en:Entertainer .
  ?Person rank:hasRDFRank ?rank .

As seen in the example query, RDF Rank weights are made available via a special system predicate. Triple patterns with the predicate are handled specially by GraphDB, where the object of the statement pattern is bound to a literal containing the RDF Rank of the subject.
In order to use this mechanism the RDF ranks for the whole repository must be computed in advance. This is done by committing a series of SPARQL updates that use special vocabulary to parameterise the weighting algorithm, followed by an update that triggers the computation itself.


Parameter Maximum iterations
Description Sets the maximum number of iterations of the algorithm over all entities in the repository.
Default 20
Example PREFIX rank: <>
INSERT DATA { rank:maxIterations rank:setParam "16" . }
Parameter Epsilon
Description Used to terminate the weighting algorithm early when the total change of all RDF Rank scores has fallen below this value.
Default 0.01
Example PREFIX rank: <>
INSERT DATA { rank:epsilon rank:setParam "0.05" . }

Full computation

To trigger the computation of the RDF Rank values for all resources use the following update:

PREFIX rank: <>
INSERT DATA { _:b1 rank:compute _:b2. }

Incremental updates

The full computation of RDF Rank values for all resources can be relatively expensive. When new resources have been added to the repository after a previous full computation of RDF Rank vales, then either a full re-computation can be done for all resources (see above) or only the RDF Rank values for the new resources can be computed (an incremental update). The following control update:

PREFIX rank: <>
INSERT DATA {_:b1 rank:computeIncremental "true"}

computes RDF Rank values for those resources, which do not have an associated value, i.e. those that have been added to the repository since the last full RDF Rank computation.

The incremental computation uses a different algorithm, which is lightweight (in order to be fast), but is not as accurate as the proper ranking algorithm. As a result, ranks assigned by the proper and the lightweight algorithms will diverge slightly from each other.

Exporting RDF Rank values

The computed weights can be exported to an external file using an update of this form:

PREFIX rank: <>
INSERT DATA { _:b1 rank:export "/home/user1/rdf_ranks.txt" . }

If the export fails then the update throws an exception and an error message will be recorded in the log file.

Lastly, when using RDF Priming, the RDF Rank values can be used as the initial activation values. To set this up, use the following update:

PREFIX rank: <>
INSERT DATA { _:b1 rank:ranksAsWeights _:b2 . }
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.