org.sat4j.reader
Class Reader

java.lang.Object
  org.sat4j.reader.Reader

Direct Known Subclasses:

AAGReader, AIGReader, DimacsReader, InstanceReader, LecteurDimacs

public abstract class Reader
extends Object

A reader is responsible to feed an ISolver from a text file and to convert the model found by the solver to a textual representation.

Author:

leberre

Constructor Summary

Reader()

Method Summary

abstract String	decode(int[] model) Deprecated.
abstract void	decode(int[] model, PrintWriter out) Produce a model using the reader format on a provided printwriter.
boolean	isVerbose()
abstract IProblem	parseInstance(InputStream in) Read a file from a stream.
IProblem	parseInstance(Reader in) Deprecated.
IProblem	parseInstance(String filename) This is the usual method to feed a solver with a benchmark.
void	setVerbosity(boolean b)

Methods inherited from class java.lang.Object

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

Constructor Detail

Reader

public Reader()

Method Detail

parseInstance

public IProblem parseInstance(String filename)
                       throws FileNotFoundException,
                              ParseFormatException,
                              IOException,
                              ContradictionException

This is the usual method to feed a solver with a benchmark.

Parameters:

filename - the fully qualified name of the benchmark. The filename extension may by used to detect which type of benchmarks it is (SAT, OPB, MAXSAT, etc).

Returns:

the problem to solve (an ISolver in fact).

Throws:

FileNotFoundException - if the file cannot be found.

ParseFormatException - if an error occurs during parsing.

IOException - if an I/O error occurs.

ContradictionException - if the problem is found trivially inconsistent.

parseInstance

public abstract IProblem parseInstance(InputStream in)
                                throws ParseFormatException,
                                       ContradictionException,
                                       IOException

Read a file from a stream. It is important to note that benchmarks are usually encoded in ASCII, not UTF8. As such, the only reasonable way to feed a solver from a stream is to use a stream.

Parameters:

in - a stream containing the benchmark.

Returns:

the problem to solve (an ISolver in fact).

Throws:

ParseFormatException - if an error occurs during parsing.

IOException - if an I/O error occurs.

ContradictionException - if the problem is found trivially inconsistent.

parseInstance

@Deprecated
public IProblem parseInstance(Reader in)
                       throws ParseFormatException,
                              ContradictionException,
                              IOException

Deprecated.

Read a file from a reader. Do not use that method, it is no longer supported.

Parameters:

in - a stream containing the benchmark.

Returns:

the problem to solve (an ISolver in fact).

Throws:

ParseFormatException - if an error occurs during parsing.

IOException - if an I/O error occurs.

ContradictionException - if the problem is found trivially inconsistent.

See Also:

parseInstance(InputStream)

decode

@Deprecated
public abstract String decode(int[] model)

Deprecated.

Produce a model using the reader format.

Parameters:

model - a model using the Dimacs format.

Returns:

a human readable view of the model.

decode

public abstract void decode(int[] model,
                            PrintWriter out)

Produce a model using the reader format on a provided printwriter.

Parameters:

model - a model using the Dimacs format.

out - the place where to display the model

isVerbose

public boolean isVerbose()

setVerbosity

public void setVerbosity(boolean b)