Civilisation-hs/Sat.hs
2016-08-04 20:11:47 +01:00

245 lines
7.3 KiB
Haskell

{- |
Module : Sat
Description : Simple SAT solver
Copyright : (c) Dimitri Lozeve
License : BSD3
Maintainer : Dimitri Lozeve <dimitri.lozeve@gmail.com>
Stability : unstable
Portability : portable
A simple SAT solver.
-}
module Sat where
import Data.List
-- Variables are represented by positive integers
type Var = Int
-- A literal is either a variable, or the negation of a variable
data Lit = Pos Var | Neg Var deriving (Eq, Show)
-- A clause is a disjunction of literals, represented by a list of
-- literals
type Clause = [Lit]
-- A formula, represented in its Conjunctive Normal Form (CNF), is a
-- conjunction of clauses, represented as a list
type CNF = [Clause]
-- An assignment is a list of literals. For instance, if an assignment
-- contains (Pos 5), it means that in this assignment, the variable 5
-- is assigned to True.
type Assignment = [Lit]
-- The result of the SAT solver
data Result = UNSAT | SAT Assignment deriving (Eq, Show)
----------------------------------------------------------------------
-- General-purpose functions
-- Extracts a variable from a literal
fromLit :: Lit -> Var
fromLit (Pos x) = x
fromLit (Neg x) = x
-- Tests for positive/negative literals
isPos :: Lit -> Bool
isPos (Pos _) = True
isPos (Neg _) = False
isNeg :: Lit -> Bool
isNeg = not . isPos
-- Checks if a clause is always true, i.e. if it contains both a
-- literal and its negation.
isClauseTrue :: Clause -> Bool
isClauseTrue [] = False
isClauseTrue (x:xs)
| notLit x `elem` xs = True
| otherwise = isClauseTrue xs
----------------------------------------------------------------------
-- Literal Evaluation
-- Negates a literal
notLit :: Lit -> Lit
notLit (Pos x) = Neg x
notLit (Neg x) = Pos x
-- Evaluates a CNF by fixing the value of a given literal
evalLit :: Lit -> CNF -> CNF
evalLit _ [] = []
evalLit lit f = foldr g [] f
where g c acc
| lit `elem` c = acc
| notLit lit `elem` c = (c \\ [notLit lit]):acc
| otherwise = c:acc
-- Pure Literal rule
-- Tests whether a literal is pure, i.e. only appears as positive or
-- negative
testPureLit :: Lit -> CNF -> Bool
testPureLit _ [] = True
testPureLit (Pos x) (c:cs) = Neg x `notElem` c && testPureLit (Pos x) cs
testPureLit (Neg x) (c:cs) = Pos x `notElem` c && testPureLit (Neg x) cs
-- Tests whether a variable appears only as a pure literal
testPureVar :: Var -> CNF -> Bool
testPureVar x f = testPureLit (Pos x) f || testPureLit (Neg x) f
-- Given a pure literal (given as a variable), eliminates all the
-- clauses containing it
eliminatePure :: Var -> CNF -> CNF
eliminatePure _ [] = []
eliminatePure x (c:cs) =
if Pos x `elem` c || Neg x `elem` c
then eliminatePure x cs
else c : eliminatePure x cs
-- Returns the set of positive or negative clauses of a formula
posLits :: CNF -> [Lit]
posLits = nub . filter isPos . concat
negLits :: CNF -> [Lit]
negLits = nub . filter isNeg . concat
-- Returns the set of the pure literals of a formula
pureLits :: CNF -> [Lit]
pureLits f = (pos \\ map notLit neg) `union` (neg \\ map notLit pos)
where pos = posLits f
neg = negLits f
-- Applies the pure literal rule: removes all clauses containing pure
-- literals. The function also takes a preexisting assignment, and
-- updates it by appending the value assigned to the eliminated pure
-- literals.
pureLitRule :: (CNF, Assignment) -> (CNF, Assignment)
pureLitRule (f, asst) = (f', asst ++ pures)
where pures = pureLits f
f' = foldr (eliminatePure . fromLit) f pures
-- Unit Propagation
-- Evaluates the formula with all the unit clauses given in argument
eliminateUnits :: [Lit] -> CNF -> CNF
eliminateUnits xs f = foldr evalLit f xs
-- Applies the unit propagation rule
unitPropagate :: (CNF, Assignment) -> (CNF, Assignment)
unitPropagate (f, asst) =
let units = concat $ filter (\xs -> length xs == 1) f in
case units of
[] -> (f, asst)
_ -> unitPropagate (eliminateUnits units f, asst `union` units)
-- Resolution
-- Returns the first common variable between two clauses, if it exists
commonVar :: Clause -> Clause -> Maybe Lit
commonVar _ [] = Nothing
commonVar as (b:bs) = if b `elem` as || notLit b `elem` as
then Just b
else commonVar as bs
-- Applies the resolution rule to two clauses sharing a variable. This
-- function does not test whether the literals are of different sign.
resolve :: Clause -> Clause -> Maybe Clause
resolve a b = do
x <- commonVar a b
return $ (a \\ [x, notLit x]) `union` (b \\ [x, notLit x])
-- Given a formula and a clause, returns a clause which can be reduced
-- with the first one by applying the resolution rule.
findMatchingClause :: CNF -> Clause -> Maybe Clause
findMatchingClause _ [] = Nothing
findMatchingClause f (x:xs) =
case find (elem $ notLit x) f of
Nothing -> findMatchingClause f xs
Just c -> Just c
-- Returns a two clauses suitable for the resolution rule, if
-- possible.
findMatchingPair :: CNF -> Maybe (Clause, Clause)
findMatchingPair [] = Nothing
findMatchingPair (c:cs) =
case findMatchingClause cs c of
Nothing -> findMatchingPair cs
Just d -> Just (c, d)
-- Recursively applies the resolution rule to all suitable pairs of
-- clauses.
resolveAll :: CNF -> CNF
resolveAll f = case findMatchingPair f of
Nothing -> f
Just (c, d) ->
case resolve c d of
Nothing -> f
Just e ->
if isClauseTrue e
then resolveAll (f \\ [c,d])
else resolveAll $ e:(f \\ [c,d])
-- Applies the resolution rule to solve the formula. It recursively
-- applies resolveAll and the unit propagation and pure literals
-- rules, until it reaches the empty formula (therefore SAT) or an
-- empty clause (therefore UNSAT).
resolutionSolve :: (CNF, Assignment) -> Result
resolutionSolve ([], asst) = SAT asst
resolutionSolve (f, asst)
| [] `elem` f = UNSAT
| otherwise =
let (f', asst') = (pureLitRule . unitPropagate) (f, asst) in
resolutionSolve (resolveAll f', asst')
-- Davis-Putnam-Logemann-Loveland (DPLL)
-- DPLL algorithm, in its most simple form. Applies the unit
-- propagation rule and the pure literal rule, and then select a
-- literal (using the selectLit function) and calls itself on the two
-- possible branches, stopping when a solution is found.
solveDPLL :: (CNF, Assignment) -> Result
solveDPLL ([], asst) = SAT (nub asst)
solveDPLL (f, asst)
| [] `elem` f = UNSAT
| otherwise = let lit = selectLit f in
let (f', asst') = (pureLitRule . unitPropagate) (f, asst) in
case solveDPLL (evalLit lit f', lit:asst') of
SAT a -> SAT a
UNSAT -> solveDPLL (evalLit (notLit lit) f', notLit lit : asst')
-- Select a literal from a given formula. This function just takes the
-- first available literal. The function head makes it unsafe, as it
-- might fail if the formula is empty or if the first clause is
-- empty. However, this function is only called by solveDPLL, which
-- checks beforehand to avoid these cases.
selectLit :: CNF -> Lit
selectLit = head . head
----------------------------------------------------------------------
-- Examples for testing purposes
test1 :: CNF
test1 = [[Neg 1, Pos 2], [Pos 3, Neg 2], [Pos 4, Neg 5], [Pos 5, Neg 4]]
test2 :: CNF
test2 = [[Pos 1], [Neg 1, Pos 4], [Neg 1, Pos 4]]
test3 :: CNF
test3 = [[Neg 1, Pos 2], [Neg 1, Pos 3], [Neg 2, Pos 4],
[Neg 3, Neg 4], [Pos 1, Neg 3, Pos 5]]