Package org.tweetyproject.lp.asp.reasoner

Class DLVSolver

java.lang.Object

org.tweetyproject.lp.asp.reasoner.ASPSolver

org.tweetyproject.lp.asp.reasoner.DLVSolver

All Implemented Interfaces:

ModelProvider<ASPRule,Program,AnswerSet>, QualitativeReasoner<Program,ASPLiteral>, Reasoner<Boolean,Program,ASPLiteral>

public class DLVSolver
extends ASPSolver

Wrapper class for the DLV answer set solver command line utility.

Author:

Thomas Vengels, Tim Janus, Anna Gessler

Constructor Summary

Constructors

Constructor	Description
DLVSolver(String pathToDLV)	Constructs a new instance pointing to a specific DLV solver.
DLVSolver(String pathToDLV, int maxNOfModels, int integerMaximum)	Constructs a new instance pointing to a specific DLV solver.
DLVSolver(String pathToDLV, Shell bash)	Constructs a new instance pointing to a specific DLV solver.

Method Summary

Modifier and Type	Method	Description
AnswerSet	getModel(Program p)	Returns a single (dedicated) model of the given belief base.
AnswerSet	getModel(Program p, int maxInt)	Returns a characterizing model (answer set) of the given belief base using the given upper integer limit.
List<AnswerSet>	getModels(File file)	Returns a characterizing model (answer set) of the given belief base.
List<AnswerSet>	getModels(String p)	Returns a characterizing model (answer set) of the given belief base.
List<AnswerSet>	getModels(Program p)	Returns a characterizing model of the given belief base
Collection<AnswerSet>	getModels(Program p, int maxInt)	Returns a characterizing model (answer set) of the given belief base using the given upper integer limit.
boolean	isInstalled()	Checks whether the underlying solver or reasoning mechanism used by this reasoner is installed and available for use.
Boolean	query(Program beliefbase, ASPLiteral formula)	Queries the given belief base with the provided formula and returns a boolean result.
Boolean	query(Program beliefbase, ASPLiteral formula, InferenceMode inferenceMode)	Evaluates a query on the given belief base using the specified inference mode.
void	setOptions(String options)	Set additional command line options for DLV.
void	setPathToDLV(String pathToDLV)	Sets the location of the DLV solver on the hard drive.

Methods inherited from class org.tweetyproject.lp.asp.reasoner.ASPSolver

getIntegerMaximum, getMaxNumOfModels, getOutput, setIntegerMaximum, setMaxNumOfModels

Methods inherited from class java.lang.Object

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

Constructor Details

DLVSolver

public DLVSolver(String pathToDLV)

Constructs a new instance pointing to a specific DLV solver.

Parameters:

pathToDLV - binary location of DLV on the hard drive. The given location has to contain a binary called "dlv". Do not include the binary itself in the path.

DLVSolver

public DLVSolver(String pathToDLV,
 Shell bash)

Constructs a new instance pointing to a specific DLV solver.

Parameters:

pathToDLV - binary location of DLV on the hard drive. The given location has to contain a binary called "dlv". Do not include the binary itself in the path.

bash - shell to run commands

DLVSolver

public DLVSolver(String pathToDLV,
 int maxNOfModels,
 int integerMaximum)

Constructs a new instance pointing to a specific DLV solver.

Parameters:

pathToDLV - binary location of Clingo on the hard drive. The given location has to contain a binary called "clingo". Do not include the binary itself in the path.

maxNOfModels - the maximum number of models that DLV will compute.

integerMaximum - the integer maximum ("-N" parameter) that DLV will use

Method Details

getModels

public Collection<AnswerSet> getModels(Program p,
 int maxInt)

Returns a characterizing model (answer set) of the given belief base using the given upper integer limit.

Overrides:

getModels in class ASPSolver

Parameters:

p - a program

maxInt - the max number of models to be returned

Returns:

AnswerSet

getModel

public AnswerSet getModel(Program p,
 int maxInt)

Returns a characterizing model (answer set) of the given belief base using the given upper integer limit.

Overrides:

getModel in class ASPSolver

Parameters:

p - a program

maxInt - the max number of models to be returned

Returns:

AnswerSet

getModels

public List<AnswerSet> getModels(Program p)

Description copied from interface: ModelProvider

Returns a characterizing model of the given belief base

Specified by:

getModels in interface ModelProvider<ASPRule,Program,AnswerSet>

Specified by:

getModels in class ASPSolver

Parameters:

p - some belief base

Returns:

the (selected) models of the belief base

getModels

public List<AnswerSet> getModels(String p)

Description copied from class: ASPSolver

Returns a characterizing model (answer set) of the given belief base.

Specified by:

getModels in class ASPSolver

Parameters:

p - containing belief base

Returns:

AnswerSet

getModels

public List<AnswerSet> getModels(File file)

Description copied from class: ASPSolver

Returns a characterizing model (answer set) of the given belief base.

Specified by:

getModels in class ASPSolver

Parameters:

file - containing belief base

Returns:

AnswerSet

getModel

public AnswerSet getModel(Program p)

Description copied from interface: ModelProvider

Returns a single (dedicated) model of the given belief base. If the implemented method allows for more than one dedicated model, the selection may be non-deterministic.

Parameters:

p - some belief base

Returns:

a selected model of the belief base.

setOptions

public void setOptions(String options)

Set additional command line options for DLV.

Parameters:

options - a string of options

setPathToDLV

public void setPathToDLV(String pathToDLV)

Sets the location of the DLV solver on the hard drive.

Parameters:

pathToDLV - path to DLV

query

public Boolean query(Program beliefbase,
 ASPLiteral formula)

Description copied from interface: QualitativeReasoner

Queries the given belief base with the provided formula and returns a boolean result. The result indicates whether the formula is entailed or satisfied by the belief base according to the qualitative reasoning method implemented by the reasoner.

Specified by:

query in interface QualitativeReasoner<Program,ASPLiteral>

Specified by:

query in interface Reasoner<Boolean,Program,ASPLiteral>

Specified by:

query in class ASPSolver

Parameters:

beliefbase - The belief base to be queried.

formula - The formula for which the query is made.

Returns:

`TRUE` if the formula is entailed or satisfied by the belief base, `FALSE` otherwise.

query

public Boolean query(Program beliefbase,
 ASPLiteral formula,
 InferenceMode inferenceMode)

Evaluates a query on the given belief base using the specified inference mode.

This method checks whether the given formula is entailed by the belief base under the specified inference mode. It retrieves the answer sets of the belief base and checks the presence of the formula in these sets based on the chosen inference mode, either skeptical or credulous.

Parameters:

beliefbase - The program representing the belief base to query.

formula - The formula (literal) to be checked within the answer sets.

inferenceMode - The mode of inference, either skeptical or credulous.

Returns:

true if the formula is entailed by the belief base under the specified inference mode, false otherwise.

isInstalled

public boolean isInstalled()

Description copied from interface: QualitativeReasoner

Checks whether the underlying solver or reasoning mechanism used by this reasoner is installed and available for use. This can be helpful when the reasoner depends on external tools or libraries for performing the reasoning tasks.

Returns:

`true` if the solver is installed and available, `false` otherwise.