org.chocosolver.solver.constraints.reification.PropXinSReif Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of choco-solver Show documentation
Open-source constraint solver.
There is a newer version: 4.10.17
/*
 * This file is part of choco-solver, http://choco-solver.org/
 *
 * Copyright (c) 2020, IMT Atlantique. All rights reserved.
 *
 * Licensed under the BSD 4-clause license.
 *
 * See LICENSE file in the project root for full license information.
 */
package org.chocosolver.solver.constraints.reification;

import org.chocosolver.solver.constraints.Propagator;
import org.chocosolver.solver.constraints.PropagatorPriority;
import org.chocosolver.solver.exception.ContradictionException;
import org.chocosolver.solver.learn.ExplanationForSignedClause;
import org.chocosolver.solver.learn.Implications;
import org.chocosolver.solver.variables.BoolVar;
import org.chocosolver.solver.variables.IntVar;
import org.chocosolver.util.ESat;
import org.chocosolver.util.objects.ValueSortedMap;
import org.chocosolver.util.objects.setDataStructures.iterable.IntIterableRangeSet;
import org.chocosolver.util.objects.setDataStructures.iterable.IntIterableSetUtils;

/**
 * A propagator dedicated to express in a compact way: (x = c) ⇔ b
 *
 * @author Charles Prud'homme
 * @since 03/05/2016.
 */
public class PropXinSReif extends Propagator {

    IntVar var;
    IntIterableRangeSet set;
    BoolVar r;

    public PropXinSReif(IntVar x, IntIterableRangeSet set, BoolVar r) {
        super(new IntVar[]{x, r}, PropagatorPriority.BINARY, false, true);
        this.set = set;
        this.var = x;
        this.r = r;
    }

    @Override
    public void propagate(int evtmask) throws ContradictionException {
        if (r.getLB() == 1) {
            var.removeAllValuesBut(set, this);
            setPassive();
        } else if (r.getUB() == 0) {
            if (var.removeValues(set, this) || !IntIterableSetUtils.intersect(var, set)) {
                setPassive();
            }
        } else {
            if (IntIterableSetUtils.includedIn(var, set)) {
                r.setToTrue(this);
                setPassive();
            } else if (!IntIterableSetUtils.intersect(var, set)) {
                r.setToFalse(this);
                setPassive();
            }
        }
    }

    @Override
    public ESat isEntailed() {
        if(isCompletelyInstantiated()){
            if(r.isInstantiatedTo(1)){
                return ESat.eval(IntIterableSetUtils.includedIn(var, set));
            }else{
                return ESat.eval(!IntIterableSetUtils.intersect(var, set));
            }
        }
        return ESat.UNDEFINED;
    }


    /**
     * @implSpec
     *
     * Premise: (x ∈ S) ⇔ b
     * 
     * 4 cases here (only cases that triggered filtering are reported):
     * 

     *  
     *       *      (b = 1 ∧ x ∈ (-∞, +∞)) → x ∈ S
     *  
     *       *      ⇔ (b = 0 ∨ x ∈ S)
     *  
     *  
     *  
     *       *      (b = [0,1] ∧ x ∈ S) → b = 1
     *  
     *       *      ⇔ (b = 1 ∨ x ∈ (U \ S))
     *  
     *  
     *  
     *       *      (b = 0 ∧ x ∈ (-∞, +∞)) → x ∈ (U \ S)
     *  
     *       *      ⇔ (b = 1 ∨ x ∈ (U \ S))
     *  
     *  
     *  
     *       *      (b = [0,1] ∧ x ∈ (U \ S)) → b = 0
     *  
     *       *      ⇔ (b = 0 ∨ x ∈ S)
     *  
     *  
     * 
     * 
     */
    @Override
    public void explain(ExplanationForSignedClause explanation, ValueSortedMap front, Implications ig, int p) {
        IntVar pivot = ig.getIntVarAt(p);
        if (vars[1].isInstantiatedTo(1)) { // b is true and X > c holds
            if (pivot == vars[1]) { // b is the pivot
                explanation.addLiteral(vars[1], explanation.getFreeSet(1), true);
                IntIterableRangeSet set0 = explanation.getRootSet(vars[0]);
                set0.removeAll(this.set);
                explanation.addLiteral(vars[0], set0, false);
            } else if (pivot == vars[0]) { // x is the pivot
                explanation.addLiteral(vars[1], explanation.getFreeSet(0), false);
                explanation.addLiteral(vars[0], explanation.getFreeSet().copyFrom(set), true);
            }
        } else if (vars[1].isInstantiatedTo(0)) {
            if (pivot == vars[1]) { // b is the pivot
                explanation.addLiteral(vars[1], explanation.getFreeSet(0), true);
                explanation.addLiteral(vars[0], explanation.getFreeSet().copyFrom(set), false);
            } else if (pivot == vars[0]) { // x is the pivot, case e. in javadoc
                explanation.addLiteral(vars[1], explanation.getFreeSet(1), false);
                IntIterableRangeSet set0 = explanation.getRootSet(vars[0]);
                set0.removeAll(this.set);
                explanation.addLiteral(vars[0], set0, true);
            }
        } else {
            throw new UnsupportedOperationException();
        }
    }

    @Override
    public String toString() {
        return "(" + var.getName() +" ∈ " + set + ") <=> "+r.getName();
    }

}