Package org.aksw.deer.enrichments

Class DereferencingEnrichmentOperator

java.lang.Object

org.aksw.faraday_cage.engine.AbstractExecutionGraphNode<T>

org.aksw.faraday_cage.engine.AbstractParameterizedExecutionGraphNode<T>

org.aksw.faraday_cage.engine.AbstractParameterizedExecutionGraphNode.WithImplicitCloning<Model>

org.aksw.deer.enrichments.AbstractParameterizedEnrichmentOperator

org.aksw.deer.enrichments.DereferencingEnrichmentOperator

All Implemented Interfaces:

DeerExecutionGraphNode, EnrichmentOperator, ParameterizedEnrichmentOperator, ParameterizedDeerExecutionGraphNode, ExecutionGraphNode<Model>, Parameterized, Plugin, org.pf4j.ExtensionPoint

@Extension
public class DereferencingEnrichmentOperator
extends AbstractParameterizedEnrichmentOperator

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

Each operation 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.engine.AbstractParameterizedExecutionGraphNode

AbstractParameterizedExecutionGraphNode.WithImplicitCloning<T>

Nested classes/interfaces inherited from interface org.aksw.faraday_cage.engine.ExecutionGraphNode

ExecutionGraphNode.DegreeBounds

Field Summary

Fields

Modifier and Type	Field	Description
static Property	DEREFERENCING_PROPERTY
static Property	IMPORT_PROPERTY
static Property	LOOKUP_PREFIX
static Property	LOOKUP_PROPERTY
static Property	OPERATION

Constructor Summary

Constructors

Constructor	Description
DereferencingEnrichmentOperator()

Method Summary

Modifier and Type	Method	Description
ValidatableParameterMap	createParameterMap()	Create an uninitialized ParameterMap to be filled by the ExecutionGraphGenerator.
void	initializeOperations()
protected List<Model>	safeApply(List<Model> models)

Methods inherited from class org.aksw.faraday_cage.engine.AbstractExecutionGraphNode

apply, getId, getInDegree, getOutDegree, initDegrees, initPluginId, usesImplicitCloning

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

deepCopy, getDegreeBounds, getType

Methods inherited from class org.aksw.faraday_cage.engine.AbstractParameterizedExecutionGraphNode

getParameterMap, getValidationModelFor, initParameters, isInitialized

Methods inherited from interface org.aksw.faraday_cage.engine.ExecutionGraphNode

apply, getInDegree, getOutDegree, initDegrees, usesImplicitCloning

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.engine.Parameterized

getParameterMap, initParameters, isInitialized

Methods inherited from interface org.aksw.faraday_cage.engine.Plugin

getId, initPluginId, isInitialized

Field Detail

LOOKUP_PROPERTY

public static final Property LOOKUP_PROPERTY

LOOKUP_PREFIX

public static final Property LOOKUP_PREFIX

DEREFERENCING_PROPERTY

public static final Property DEREFERENCING_PROPERTY

IMPORT_PROPERTY

public static final Property IMPORT_PROPERTY

OPERATION

public static final Property OPERATION

Constructor Detail

DereferencingEnrichmentOperator

public DereferencingEnrichmentOperator()

Method Detail

createParameterMap

@NotNull
public ValidatableParameterMap createParameterMap()

Description copied from interface: Parameterized

Create an uninitialized ParameterMap to be filled by the ExecutionGraphGenerator.

Returns:

uninitialized ParameterMap containing all allowed Parameter

initializeOperations

public void initializeOperations()

safeApply

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

Specified by:

safeApply in class AbstractExecutionGraphNode<Model>