2 releases (1 stable)

3.1.1 Oct 13, 2023
0.1.0 Nov 18, 2022

#1732 in Math

37 downloads per month

MIT license

685KB
21K SLoC

C 20K SLoC // 0.0% comments Rust 271 SLoC

Kissat SAT solver

Crate Documentation GitHub

This is a stand alone crate that contains both the C source code of the Kissat SAT solver together with its Rust binding. The C files are compiled and statically linked during the build process.

Kissat variants dominated the main track of the Sat Competition 2022. Author Armin Biere describes Kissat as follows:

Kissat is a "keep it simple and clean bare metal SAT solver" written in C. It is a port of CaDiCaL back to C with improved data structures, better scheduling of inprocessing and optimized algorithms and implementation. Coincidentally "kissat" also means "cats" in Finnish.

This crate is based on the "cadical" crate, and is as API-compatible as possible. This enables a switch back to cadical::Solver (which has extra features like file I/O) as a debugging strategy. Beware: this also means the API will let you try to modify the problem after solving, but Kissat will abort if you do. Incremental solving is not yet implemented.

The literals are unwrapped positive and negative integers, exactly as in the DIMACS format. The common IPASIR operations are presented in a safe Rust interface.

let mut sat: cat_solver::Solver::new();
sat.add_clause([1, 2]);
sat.add_clause([-1, 2]);
assert_eq!(sat.solve(), Some(true));
assert_eq!(sat.value(2), Some(true));

Dependencies