CommonSAT

CommonSAT is intended as a common SAT solver interface for different SAT solvers.

The minimum required C++ version is C++11.

So... what is CommonSAT?

It is a header-only library, providing a common interface for

• reading CNFs in DIMACS format
• writing CNFs in DIMACS format
• generating CNF formulae
• solving them (sequentially)
• solving them in parallel
• obtaining satisfiability or non-satisfiability information
• obtaining a satisfiable assignment (if satisfiable)
• obtaining conflict information (if non-satisfiable)
• obtaining information about the computation
• freezing and thawing variables for incremental computations

for SAT solver libraries like

• MiniSAT
• CryptoMiniSat
• Lingeling
• Plingeling
• Treengeling
• PicoSat
• PrecoSat
• YALS

Note that the things mentioned above are TODO list items that are probably not implemented.

Code example

/* commonsat::SolverInterface solver */
solver.add_clause({1, 2});
solver.add_clause({1, -2, 3});
solver.add_clause({-1, 2});
solver.add_clause({-1, -2});
bool isSatisfiable = solver.solve();
if (isSatisfiable) {
  for (int i : std::views::iota(1, 4)) {
    std::println("Variable {} is assigned {}", i, solver.is_true(2));
  }
} else {
  std::println("Not satisfiable");
}

How do I get something to run ...quickly?

The quickest way to get started is along the following lines:

# install dependencies, e.g.,
sudo apt install git cmake doxygen graphviz zlib1g-dev libgmp-dev
# or
sudo dnf install git cmake doxygen graphviz zlib-devel gmp-devel

# clone the repo
git clone https://github.com/sbeyer/commonsat.git

# run the quickstart script
cd commonsat
util/quickstart.sh

# make the documentation
util/check-doxygen-errors.sh

The quickstart script will do a lot of magic, like updating submodules (for the test suite), obtaining and compiling all the supported solvers, and compile and run the commonsat tests.