Package org.aksw.deer.enrichments

Class DereferencingEnrichmentOperator

java.lang.Object

org.aksw.faraday_cage.nodes.AbstractNode<T>

org.aksw.faraday_cage.nodes.AbstractParametrizedNode<T>

org.aksw.faraday_cage.nodes.AbstractParametrizedNode.WithImplicitCloning<Model>

org.aksw.deer.enrichments.AbstractParametrizedEnrichmentOperator

org.aksw.deer.enrichments.DereferencingEnrichmentOperator

All Implemented Interfaces:

DeerPlugin, SelfConfigurator, ParametrizedDeerPlugin, Execution<Model>, Node<Model>, ParametrizedNode<Model>, Parametrized, Plugin<Model>, org.pf4j.ExtensionPoint

@Extension
public class DereferencingEnrichmentOperator
extends AbstractParametrizedEnrichmentOperator

An EnrichmentOperator for dereferencing.

Dereferencing is a method of expanding knowledge of resources that belong to an external knowledge base. We define a dereferencing operation as the following sequence of operations:

1. Query the local model for starting resources ?x that belong to an external knowledge base
2. Query the external knowledge base for triples (?x, d, ?y), where d is a defined property path in the external knowledge base.
3. Add all results to the local model in the form of (?x, i, ?y), where i is the property name under which they should be imported.

Configuration

:operations

A DictList. Each entry in the DictList corresponds to one dereferencing operation, allowing multiple dereferencing operations being carried out by a single DereferencingEnrichmentOperator. Each entry may contain the following properties:

:lookUpProperty range: resource
Determines the starting resources ?x as all objects of triples having the value of :lookUpProperty as predicate.

:lookUpPrefix [required] range: string
Determines the starting resources ?x as all objects of triples having the value of :lookUpProperty as predicate.

:dereferencingProperty [required] range: resource
Look up the values to be imported to the local model in the external knowledge base using the property defined by the value of :dereferencingProperty.

:importProperty [required] range: resource
Add looked up values to starting resources using the value of :importProperty.

Example

Nested Class Summary

Nested classes/interfaces inherited from class org.aksw.faraday_cage.nodes.AbstractParametrizedNode

AbstractParametrizedNode.WithImplicitCloning<T>

Nested classes/interfaces inherited from interface org.aksw.faraday_cage.nodes.Node

Node.DegreeBounds

Constructor Summary

Constructors

Constructor	Description
DereferencingEnrichmentOperator()

Method Summary

Modifier and Type	Method	Description
ParameterMap	createParameterMap()	Create an uninitialized ParameterMap to be filled by the ExecutionGraphGenerator.
protected List<Model>	safeApply(List<Model> models)
ParameterMap	selfConfig(Model source, Model target)	Self configuration Find source/target URI as the most redundant URIs
void	validateAndAccept(ParameterMap params)

Methods inherited from class org.aksw.faraday_cage.nodes.AbstractNode

apply, apply, gatherAnalytics, getId, getInDegree, getOutDegree, init, init, writeAnalytics

Methods inherited from class org.aksw.deer.enrichments.AbstractParametrizedEnrichmentOperator

deepCopy, getDegreeBounds, getType, writeInputAnalytics, writeOutputAnalytics

Methods inherited from class org.aksw.faraday_cage.nodes.AbstractParametrizedNode

getParameterMap, init, init, isInitialized

Methods inherited from interface org.aksw.faraday_cage.Execution

apply, apply, gatherAnalytics, getId

Methods inherited from interface org.aksw.faraday_cage.nodes.Node

getInDegree, getOutDegree, init

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.aksw.faraday_cage.Parametrized

getParameterMap, init, isInitialized

Methods inherited from interface org.aksw.faraday_cage.nodes.ParametrizedNode

init

Methods inherited from interface org.aksw.faraday_cage.Plugin

init, isInitialized

Constructor Detail

DereferencingEnrichmentOperator

public DereferencingEnrichmentOperator()

Method Detail

selfConfig

@NotNull
public ParameterMap selfConfig(Model source,
                               Model target)

Self configuration Find source/target URI as the most redundant URIs

Parameters:

source - source

target - target

Returns:

Map of (key, value) pairs of self configured parameters

createParameterMap

@NotNull
public ParameterMap createParameterMap()

Description copied from interface: Parametrized

Create an uninitialized ParameterMap to be filled by the ExecutionGraphGenerator.

Returns:

uninitialized ParameterMap containing all allowed Parameter

validateAndAccept

public void validateAndAccept(@NotNull
                              ParameterMap params)

Specified by:

validateAndAccept in class AbstractParametrizedNode<Model>

safeApply

protected List<Model> safeApply(List<Model> models)

Specified by:

safeApply in class AbstractNode<Model>