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 ofFROMTOoutput.FROMobjects always come fromSOURCE.TO [OBJ]: the "to" column ofFROMTOoutput
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:subPropertyOfrelation.Direction: the direction to use when traversing the relation with the givenPredicateandSOURCEForward:(FROM = SOURCE, Predicate, TO = ?)Backward:(TO = ?, Predicate, FROM = SOURCE)Either: the result contains the union ofForwardandBackwardresults
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 dataSOURCEis representative enough:false:Score normalisationonly considers the data inSOURCEto normalize againsttrue:Score normalisationconsiders all data in the dataset containingSOURCEto normalize against
Output scores can be aggregated and/or normalized.