Traverse Relation
Description
Given a Predicate
, traverses the graph from a set of subjects to a set of objects (Forward
),
or from a set of objects to a set of subjects (Backward
).
The same predicate can be traversed multiple times (Minimum / Maximum number of steps
can be specified).
When multiple steps are performed, the result always includes the shortest path from the subjects in input
to those reachable within the given Minimum / Maximum number of steps
Input
SOURCE [OBJ]
: a list of objects
Output
FROMTO [OBJ,OBJ]
: a pair representing the "from" and the "to" in the process of traversing a graph relationFROM [OBJ]
: the "from" column ofFROMTO
output.FROM
objects always come fromSOURCE
.TO [OBJ]
: the "to" column ofFROMTO
output
Parameters
Predicate
: the predicate of a graph triple(subject,predicate,object)
Use sub-predicates
: when set totrue
, the values of all sub-predicates are also included. Sub-predicates can be defined in the data with therdfs:subPropertyOf
relation.Direction
: the direction to use when traversing the relation with the givenPredicate
andSOURCE
Forward
:(FROM = SOURCE, Predicate, TO = ?)
Backward
:(TO = ?, Predicate, FROM = SOURCE)
Either
: the result contains the union ofForward
andBackward
results
Minimum number of steps
: Only include results reachable in a given minimum number of steps.Maximum number of steps
: Only include results reachable in a given maximum number of steps.Step weight
: [0..1]. Weight applied at every step. When < 1, further steps are progressively penalised.Normalize over entire graph
. Usefalse
(default) when dataSOURCE
is representative enough:false
:Score normalisation
only considers the data inSOURCE
to normalize againsttrue
:Score normalisation
considers all data in the dataset containingSOURCE
to normalize against
Output scores can be aggregated and/or normalized.