net.sf.tweety.arg.dung.prover

Interface InterfaceSolver

All Known Implementing Classes:

AbstractDungSolver, AbstractSolver, GroundTruthSolver, ProboSolver, TweetySolver

public interface InterfaceSolver

The most general interface for solvers of argumentation problems. If you want to develop a solver, better use AbstractSolver or even better AbstractDungSolver as these already contain basic functionalities.

Author:

Matthias Thimm

Method Summary

Modifier and Type	Method and Description
void	execute(java.lang.String[] args) This is the main method of the solver.
java.lang.String	solve(Problem problem, java.io.File input, FileFormat format, java.lang.String additionalParameters) Solves the given problem on the given file (represented in the given format) with possibly additional parameters.
java.util.Collection<FileFormat>	supportedFormats() Gives a collection view of the supported formats of this solver, cf.
java.util.Collection<Problem>	supportedProblems() Gives a collection view on the supported problems of this solver, cf.
java.lang.String	versionInfo() Returns author and version information of the solver as a string.

Method Detail

versionInfo

java.lang.String versionInfo()

Returns author and version information of the solver as a string.

Returns:

a string containing author and version information of the solver.

supportedFormats

java.util.Collection<FileFormat> supportedFormats()

Gives a collection view of the supported formats of this solver, cf. FileFormat. For a description of these formats see the handbook for the argumentation competition.

Returns:

a collection view of the supported formats of this solver.

supportedProblems

java.util.Collection<Problem> supportedProblems()

Gives a collection view on the supported problems of this solver, cf. Problem. For a description of these problems see the handbook for the argumentation competition.

Returns:

a collection view on the supported problems of this solver.

solve

java.lang.String solve(Problem problem,
                       java.io.File input,
                       FileFormat format,
                       java.lang.String additionalParameters)
                throws java.io.IOException,
                       java.lang.IllegalArgumentException

Solves the given problem on the given file (represented in the given format) with possibly additional parameters.

Parameters:

problem - the problem type to be solved.

input - the input (an abstract argumentation graph)

format - the format of the input file

additionalParameters - additional parameters for the problem (maybe "null" if no further parameters are given)

Returns:

A string representing the solution to the given problem.

Throws:

java.io.IOException - in case of errors in accessing the input file.

java.lang.IllegalArgumentException - if this solver is not able to solve the given problem or does not understand the format.

execute

void execute(java.lang.String[] args)

This is the main method of the solver. It receives all command line arguments and prints its solution of System.out. An actual implementation of a solver must then only contain a main method of the form "public static void main(String[] args){ new MySolver().execute(args); }".

Parameters:

args - command line arguments