won.utils.goals

Class GoalInstantiationProducer

java.lang.Object

won.utils.goals.GoalInstantiationProducer

public class GoalInstantiationProducer
extends java.lang.Object

Class supports in producing goal instantiations that can be used to create proposals for instance. Goal instantiations are data models that evaluate successfully against defined shacl shapes taken from two goals of two needs.

Constructor Summary

Constructors

Constructor and Description
GoalInstantiationProducer(org.apache.jena.query.Dataset need1, org.apache.jena.query.Dataset need2, org.apache.jena.query.Dataset conversation, java.lang.String variableUriPrefix, java.lang.String blendingUriPrefix) Initialize the GoalInstantiationProducer

Method Summary

Modifier and Type	Method and Description
java.util.Collection<GoalInstantiationResult>	createAllGoalCombinationInstantiationResults() create all possible goal instantiations between two needs.
java.util.Collection<GoalInstantiationResult>	createAllGoalInstantiationResults() create all possible goal instantiations between two needs.
java.util.Collection<GoalInstantiationResult>	createGoalInstantiationResultsForNeed1()
java.util.Collection<GoalInstantiationResult>	createGoalInstantiationResultsForNeed2()
GoalInstantiationResult	findInstantiationForGoal(org.apache.jena.rdf.model.Resource goal) Create a goal instantiation result from the attempt to instantiate one goal with data of two needs using all the need data, the conversation data and the shapes data of the goal.
static GoalInstantiationResult	findInstantiationForGoalInDataset(org.apache.jena.query.Dataset need, org.apache.jena.rdf.model.Resource goal, org.apache.jena.rdf.model.Model model) Create a goal instantiation result from the attempt to instantiate one goal with data given in the dataset The data is extracted and validated against the shacl shape of the goal.

Methods inherited from class java.lang.Object

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

Constructor Detail

GoalInstantiationProducer

public GoalInstantiationProducer(org.apache.jena.query.Dataset need1,
                                 org.apache.jena.query.Dataset need2,
                                 org.apache.jena.query.Dataset conversation,
                                 java.lang.String variableUriPrefix,
                                 java.lang.String blendingUriPrefix)

Initialize the GoalInstantiationProducer

Parameters:

need1 - Dataset of need 1

need2 - Dataset of need 2

conversation - Dataset of the conversation between two needs

variableUriPrefix - uri prefix defines which resource URIs are considered for blending

blendingUriPrefix - uri prefix that is used to generate the result URIs of blended resources

Method Detail

findInstantiationForGoal

public GoalInstantiationResult findInstantiationForGoal(org.apache.jena.rdf.model.Resource goal)

Create a goal instantiation result from the attempt to instantiate one goal with data of two needs using all the need data, the conversation data and the shapes data of the goal. The data is extracted and validated against the shacl shape of the goal.

Parameters:

goal - resource referencing goal from need1 or need2

Returns:

a goal instantiation result whose input model can either conform to its shacl shapes or not

findInstantiationForGoalInDataset

public static GoalInstantiationResult findInstantiationForGoalInDataset(org.apache.jena.query.Dataset need,
                                                                        org.apache.jena.rdf.model.Resource goal,
                                                                        org.apache.jena.rdf.model.Model model)

Create a goal instantiation result from the attempt to instantiate one goal with data given in the dataset The data is extracted and validated against the shacl shape of the goal.

Parameters:

need - Dataset of the need to retrieve the goalShapesModel from

goal - resource referencing goal from need1 or need2

model - Model that should be checked for goal validity

Returns:

a goal instantiation result whose input model can either conform to its shacl shapes or not

createAllGoalCombinationInstantiationResults

public java.util.Collection<GoalInstantiationResult> createAllGoalCombinationInstantiationResults()

create all possible goal instantiations between two needs. That means trying to combine each two goals of the two needs.

Returns:

createAllGoalInstantiationResults

public java.util.Collection<GoalInstantiationResult> createAllGoalInstantiationResults()

create all possible goal instantiations between two needs. Including the separate goals of each need as well.

Returns:

createGoalInstantiationResultsForNeed1

public java.util.Collection<GoalInstantiationResult> createGoalInstantiationResultsForNeed1()

createGoalInstantiationResultsForNeed2

public java.util.Collection<GoalInstantiationResult> createGoalInstantiationResultsForNeed2()