logicng 0.1.0-alpha.3

A Library for Creating, Manipulating, and Solving Boolean Formulas
Documentation
use crate::formulas::operation_cache::OperationCache;
use crate::formulas::{EncodedFormula, Formula, FormulaFactory, NaryIterator};
use crate::handlers::{FactorizationError, FactorizationHandler, NopFactorizationHandler};

/// Constructs the _DNF_ of the given formula by using factorization.
pub fn factorization_dnf(formula: EncodedFormula, f: &FormulaFactory) -> EncodedFormula {
    factorization_dnf_with_handler(formula, f, &mut NopFactorizationHandler {}).expect("Nop Handler never aborts.")
}

/// Constructs the _DNF_ of the given formula by using factorization with a
/// custom handler.
pub fn factorization_dnf_with_handler(
    formula: EncodedFormula,
    f: &FormulaFactory,
    handler: &mut impl FactorizationHandler,
) -> Result<EncodedFormula, FactorizationError> {
    handler.started();
    if f.config.caches.dnf {
        apply_rec(formula, f, handler, &mut None)
    } else {
        apply_rec(formula, f, handler, &mut Some(OperationCache::new()))
    }
}

fn apply_rec(
    formula: EncodedFormula,
    f: &FormulaFactory,
    handler: &mut impl FactorizationHandler,
    local_cache: &mut Option<OperationCache<EncodedFormula>>,
) -> Result<EncodedFormula, FactorizationError> {
    let cached =
        local_cache.as_ref().map_or_else(|| f.caches.dnf.get(formula), |c| c.get(formula).map_or_else(|| f.caches.dnf.get(formula), Some));

    cached.map_or_else(
        || {
            use Formula::{And, Cc, Equiv, False, Impl, Lit, Not, Or, Pbc, True};
            let result = match formula.unpack(f) {
                Lit(_) | True | False => Ok(formula),
                Pbc(_) | Cc(_) | Equiv(_) | Impl(_) | Not(_) => apply_rec(f.nnf_of(formula), f, handler, local_cache),
                Or(ops) => handle_or(ops, f, handler, local_cache),
                And(ops) => handle_and(ops, f, handler, local_cache),
            };
            if let Ok(res) = result {
                if let Some(c) = local_cache.as_mut() {
                    c.insert(formula, res);
                }
                if f.config.caches.dnf {
                    f.caches.dnf.insert(formula, res);
                }
                if f.config.caches.is_dnf {
                    f.caches.is_dnf.insert(res, true);
                }
            }
            result
        },
        Ok,
    )
}

fn handle_or(
    operands: NaryIterator,
    f: &FormulaFactory,
    handler: &mut impl FactorizationHandler,
    cache: &mut Option<OperationCache<EncodedFormula>>,
) -> Result<EncodedFormula, FactorizationError> {
    compute_nops(operands, f, handler, cache).map(|nops| f.or(&nops))
}

fn handle_and(
    operands: NaryIterator,
    f: &FormulaFactory,
    handler: &mut impl FactorizationHandler,
    cache: &mut Option<OperationCache<EncodedFormula>>,
) -> Result<EncodedFormula, FactorizationError> {
    compute_nops(operands, f, handler, cache).and_then(|nops| {
        let mut result = *nops.get(0).unwrap();
        for &op in nops.iter().skip(1) {
            result = distribute(result, op, f, handler)?;
        }
        Ok(result)
    })
}

fn compute_nops(
    operands: NaryIterator,
    f: &FormulaFactory,
    handler: &mut impl FactorizationHandler,
    cache: &mut Option<OperationCache<EncodedFormula>>,
) -> Result<Vec<EncodedFormula>, FactorizationError> {
    let mut nops = Vec::with_capacity(operands.len());
    for op in operands {
        nops.push(apply_rec(op, f, handler, cache)?);
    }
    Ok(nops)
}

fn distribute(
    f1: EncodedFormula,
    f2: EncodedFormula,
    f: &FormulaFactory,
    handler: &mut impl FactorizationHandler,
) -> Result<EncodedFormula, FactorizationError> {
    handler.performed_distribution()?;
    if f1.is_or() || f2.is_or() {
        let mut nops = Vec::new();
        let or = if f1.is_or() { f1 } else { f2 };
        let nor = if f1.is_or() { f2 } else { f1 };
        for &op in &*or.operands(f) {
            nops.push(distribute(op, nor, f, handler)?);
        }
        Ok(f.or(&nops))
    } else {
        let result = f.and(&[f1, f2]);
        handler.created_clause(result).map(|_| result)
    }
}

#[cfg(test)]
mod tests {
    use crate::handlers::ClauseLimitFactorizationHandler;

    use super::*;

    #[test]
    fn test_constants() {
        test_dnf("$true", "$true");
        test_dnf("$false", "$false");
    }

    #[test]
    fn test_literals() {
        test_dnf("a", "a");
        test_dnf("~a", "~a");
    }

    #[test]
    fn test_binary_operators() {
        let f = &FormulaFactory::new();
        test_dnf("a => b", "~a | b");
        test_dnf("~a => ~b", "a | ~b");
        test_dnf("a & b => x | y", "~a | ~b | x | y");
        test_dnf("a <=> b", "(a & b) | (~a & ~b)");
        test_dnf("~a <=> ~b", "(a & b) | (~a & ~b)");
        assert!(factorization_dnf(f.parse("a => b").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("~a => ~b").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("a & b => x | y").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("a <=> b").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("~a <=> b").unwrap(), f).is_dnf(f));
    }

    #[test]
    fn test_nary_operators() {
        let f = &FormulaFactory::new();
        test_dnf("a & b", "a & b");
        test_dnf("x | y", "x | y");
        test_dnf(
            "~(a | b) & c & ~(x & ~y) & (w => z)",
            "~w & ~x & ~a & ~b & c | z & ~x & ~a & ~b & c | ~w & y & ~a & ~b & c | z & y & ~a & ~b & c",
        );
        test_dnf("~(a & b) | c | ~(x | ~y)", "~a | ~b | c | ~x & y ");
        test_dnf("a & b & (~x | ~y)", "~x & a & b | ~y & a & b ");
        assert!(factorization_dnf(f.parse("a & b").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("x | y").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("~(a | b) & c & ~(x & ~y) & (w => z)").unwrap(), f,).is_dnf(f));
        assert!(factorization_dnf(f.parse("~(a | b) & c & ~(x & ~y) & (w => z)").unwrap(), f,).is_dnf(f));
        assert!(factorization_dnf(f.parse("~(a & b) | c | ~(x | ~y)").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("~(a & b) | c | ~(x | ~y)").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("a | b | (~x & ~y)").unwrap(), f).is_dnf(f));
        assert!(factorization_dnf(f.parse("a | b | (~x & ~y)").unwrap(), f).is_dnf(f));
    }

    #[test]
    fn test_not() {
        test_dnf("~a2", "~a2");
        test_dnf("~~a2", "a2");
        test_dnf("~(a2 => b2)", "a2 & ~b2");
        test_dnf("~(~(a2 | b2) => ~(x2 | y2))", "x2 & ~a2 & ~b2 | y2 & ~a2 & ~b2");
        test_dnf("~(a2 <=> b2)", "(a2 & ~b2) | (~a2 & b2)");
        test_dnf("~(~(a2 | b2) <=> ~(x2 | y2))", "~x2 & ~y2 & a2 | ~x2 & ~y2 & b2 | ~a2 & ~b2 & x2 | ~a2 & ~b2 & y2");
        test_dnf("~(a2 & b2 & ~x2 & ~y2)", "~a2 | ~b2 | x2 | y2");
        test_dnf("~(a2 | b2 | ~x2 | ~y2)", "~a2 & ~b2 & x2 & y2");
        test_dnf("~(a2 | b2 | ~x2 | ~y2)", "~a2 & ~b2 & x2 & y2");
    }

    #[test]
    fn test_with_handler() {
        let f = &FormulaFactory::new();

        let formula = f.parse("(~(~(a | b) => ~(x | y))) & ((a | x) => ~(b | y))").unwrap();
        let mut handler = ClauseLimitFactorizationHandler::new(100, 2);
        let result = factorization_dnf_with_handler(formula, f, &mut handler);
        assert!(result.is_err());
        assert!(handler.aborted);

        let formula = f.parse("~(a | b)").unwrap();
        let result = factorization_dnf_with_handler(formula, f, &mut handler);
        assert!(result.is_ok());
        assert!(!handler.aborted);

        let mut handler = ClauseLimitFactorizationHandler::new(100, 100);
        let formula = f.parse("~(~(a2 | b2) <=> ~(x2 | y2))").unwrap();
        let result = factorization_dnf_with_handler(formula, f, &mut handler);
        assert!(result.is_ok());
        assert!(!handler.aborted);
        assert_eq!(handler.dists, 15);
        assert_eq!(handler.clauses, 10);
    }

    fn test_dnf(original: &str, expected: &str) {
        let f = &FormulaFactory::new();
        assert_eq!(factorization_dnf(f.parse(original).unwrap(), f), f.parse(expected).unwrap());
    }
}