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, org.aksw.faraday_cage.Execution<Model>, org.aksw.faraday_cage.IdentifiableExecution<Model>, org.aksw.faraday_cage.nodes.Node<Model>, org.aksw.faraday_cage.nodes.ParametrizedNode<Model>, org.aksw.faraday_cage.Parametrized, org.aksw.faraday_cage.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:

: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.

:endpoint range: string
URL of the SPARQL endpoint to use for this dereferencing operation. If not given, this operator tries to infer the endpoint from the starting resources URIs.

Example

Nested Class Summary

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

org.aksw.faraday_cage.nodes.AbstractParametrizedNode.WithImplicitCloning<T extends Object>

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

org.aksw.faraday_cage.nodes.Node.DegreeBounds

Constructor Summary

Constructors

Constructor	Description
DereferencingEnrichmentOperator()

Method Summary

Modifier and Type	Method	Description
org.aksw.faraday_cage.parameter.ParameterMap	createParameterMap()
protected List<Model>	safeApply(List<Model> models)
org.aksw.faraday_cage.parameter.ParameterMap	selfConfig(Model source, Model target)	Self configuration Find source/target URI as the most redundant URIs
void	validateAndAccept(org.aksw.faraday_cage.parameter.ParameterMap params)

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

apply, apply, getId, getInDegree, getOutDegree, init, init

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

deepCopy, getDegreeBounds, getType

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, toMultiExecution, toSingleExecution

Methods inherited from interface org.aksw.faraday_cage.IdentifiableExecution

getId

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

getInDegree, getOutDegree, init, isInitialized

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

getImplementationType, init

Constructor Detail

DereferencingEnrichmentOperator

public DereferencingEnrichmentOperator()

Method Detail

selfConfig

@NotNull
public org.aksw.faraday_cage.parameter.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 org.aksw.faraday_cage.parameter.ParameterMap createParameterMap()

validateAndAccept

public void validateAndAccept(@NotNull
                              org.aksw.faraday_cage.parameter.ParameterMap params)

Specified by:

validateAndAccept in class org.aksw.faraday_cage.nodes.AbstractParametrizedNode<Model>

safeApply

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

Specified by:

safeApply in class org.aksw.faraday_cage.nodes.AbstractNode<Model>