org.chocosolver.solver.constraints.unary.PropNotMember 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.unary;

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.IntVar;
import org.chocosolver.solver.variables.events.IntEventType;
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;

/**
 * This propagator manages a singleton nogood.
 * 
 * 

 * Project: choco-solver.
 *
 * @author Charles Prud'homme
 * @since 12/10/2016.
 */
public class PropNotMember extends Propagator {

    /**
     * List of forbidden values.
     */
    private IntIterableRangeSet range;

    /**
     * Maintain : var∉range
     *
     * @param var a variable
     * @param range  list of possible values
     */
    public PropNotMember(IntVar var, IntIterableRangeSet range) {
        super(new IntVar[]{var}, PropagatorPriority.UNARY, false);
        this.range = range.duplicate();
    }

    @Override
    public int getPropagationConditions(int vIdx) {
        return IntEventType.all();
    }

    @Override
    public void propagate(int evtmask) throws ContradictionException {
        if(enforce(vars[0], range, this)){
            setPassive();
        }
    }

    private static boolean enforce(IntVar var, IntIterableRangeSet fset, Propagator prop) throws ContradictionException {
        return var.removeValues(fset, prop)
                && (var.hasEnumeratedDomain() || IntIterableSetUtils.notIncludedIn(var, fset));
    }

    @Override
    public ESat isEntailed() {
        if(IntIterableSetUtils.includedIn(vars[0], range)){
            return ESat.FALSE;
        }else if(IntIterableSetUtils.intersect(vars[0], range)){
            return ESat.UNDEFINED;
        }
        return ESat.TRUE;
    }

    /**
     * @implSpec
     * 

     *     Consider that v1 has been modified by propagation of this.
     *     Before the propagation, the domains were like:
     * 
     *         (v1 ∈ D1)
     *     
     * Then this propagates v1 ∉ S, then:
     *      *         (v1 ∈ D1) → v1 ∉ S
     *     
     * Converting to DNF:
     *      *         (v1 ∈ (U \ D1) ∪ (U \ S))
     *     
     * 
     */
    @Override
    public void explain(ExplanationForSignedClause explanation,
                        ValueSortedMap front,
                        Implications ig, int p) {
        IntIterableRangeSet set = explanation.getRootSet(vars[0]);
        set.removeAll(range);
        explanation.addLiteral(vars[0], set, true);
    }

    @Override
    public String toString() {
        return vars[0].getName() + " \u2208 " + range;
    }
}