/* -*- mode: C++; c-basic-offset: 2; indent-tabs-mode: nil -*- */ /* * Main authors: * Christian Schulte * Guido Tack * * Copyright: * Christian Schulte, 2002 * Guido Tack, 2004 * * Last modified: * $Date: 2009-11-03 03:10:59 +1100 (Tue, 03 Nov 2009) $ by $Author: tack $ * $Revision: 10021 $ * * This file is part of Gecode, the generic constraint * development environment: * http://www.gecode.org * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * */ #ifndef __GECODE_INT_ARITHMETIC_HH__ #define __GECODE_INT_ARITHMETIC_HH__ #include #include #include /** * \namespace Gecode::Int::Arithmetic * \brief Numerical (arithmetic) propagators */ namespace Gecode { namespace Int { namespace Arithmetic { /** * \brief Bounds consistent absolute value propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class AbsBnd : public BinaryPropagator { protected: using BinaryPropagator::x0; using BinaryPropagator::x1; /// Constructor for cloning \a p AbsBnd(Space& home, bool share, AbsBnd& p); /// Constructor for posting AbsBnd(Home home, View x0, View x1); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /** * \brief Cost function * * If a view has been assigned, the cost is low unary. * Otherwise it is low binary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post bounds consistent propagator \f$ |x_0|=x_1\f$ static ExecStatus post(Home home, View x0, View x1); }; /** * \brief Domain consistent absolute value propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class AbsDom : public BinaryPropagator { protected: using BinaryPropagator::x0; using BinaryPropagator::x1; /// Constructor for cloning \a p AbsDom(Space& home, bool share, AbsDom& p); /// Constructor for posting AbsDom(Home home, View x0, View x1); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /** * \brief Cost function * * If a view has been assigned, the cost is low binary. * If in stage for bounds propagation, the cost is * low binary. Otherwise it is high binary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post domain consistent propagator \f$ |x_0|=x_1\f$ static ExecStatus post(Home home, View x0, View x1); }; /** * \brief Bounds consistent ternary maximum propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class MaxBnd : public TernaryPropagator { protected: using TernaryPropagator::x0; using TernaryPropagator::x1; using TernaryPropagator::x2; /// Constructor for cloning \a p MaxBnd(Space& home, bool share, MaxBnd& p); /// Constructor for posting MaxBnd(Home home, View x0, View x1, View x2); public: /// Constructor for rewriting \a p during cloning MaxBnd(Space& home, bool share, Propagator& p, View x0, View x1, View x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post propagator \f$ \max\{x_0,x_1\}=x_2\f$ static ExecStatus post(Home home, View x0, View x1, View x2); }; /** * \brief Bounds consistent n-ary maximum propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class NaryMaxBnd : public NaryOnePropagator { protected: using NaryOnePropagator::x; using NaryOnePropagator::y; /// Constructor for cloning \a p NaryMaxBnd(Space& home, bool share, NaryMaxBnd& p); /// Constructor for posting NaryMaxBnd(Home home, ViewArray& x, View y); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post propagator \f$ \max x=y\f$ static ExecStatus post(Home home, ViewArray& x, View y); }; /** * \brief Domain consistent ternary maximum propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class MaxDom : public TernaryPropagator { protected: using TernaryPropagator::x0; using TernaryPropagator::x1; using TernaryPropagator::x2; /// Constructor for cloning \a p MaxDom(Space& home, bool share, MaxDom& p); /// Constructor for posting MaxDom(Home home, View x0, View x1, View x2); public: /// Constructor for rewriting \a p during cloning MaxDom(Space& home, bool share, Propagator& p, View x0, View x1, View x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /** * \brief Cost function * * If in stage for bounds propagation, the cost is * low ternary. Otherwise it is high ternary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post propagator \f$ \max\{x_0,x_1\}=x_2\f$ static ExecStatus post(Home home, View x0, View x1, View x2); }; /** * \brief Domain consistent n-ary maximum propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class NaryMaxDom : public NaryOnePropagator { protected: using NaryOnePropagator::x; using NaryOnePropagator::y; /// Constructor for cloning \a p NaryMaxDom(Space& home, bool share, NaryMaxDom& p); /// Constructor for posting NaryMaxDom(Home home, ViewArray& x, View y); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /** * \brief Cost function * * If in stage for bounds propagation, the cost is * low linear. Otherwise it is high linear. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post propagator \f$ \max x=y\f$ static ExecStatus post(Home home, ViewArray& x, View y); }; /** * \brief Bounds consistent positive square propagator * * This propagator provides multiplication for positive views only. */ template class SqrPlusBnd : public MixBinaryPropagator { protected: using MixBinaryPropagator::x0; using MixBinaryPropagator::x1; /// Constructor for posting SqrPlusBnd(Home home, VA x0, VB x1); /// Constructor for cloning \a p SqrPlusBnd(Space& home, bool share, SqrPlusBnd& p); public: /// Post propagator \f$x_0\cdot x_0=x_1\f$ static ExecStatus post(Home home, VA x0, VB x1); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Bounds consistent square propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class SqrBnd : public BinaryPropagator { protected: using BinaryPropagator::x0; using BinaryPropagator::x1; /// Constructor for cloning \a p SqrBnd(Space& home, bool share, SqrBnd& p); /// Constructor for posting SqrBnd(Home home, View x0, View x1); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post propagator \f$x_0\cdot x_0=x_1\f$ static ExecStatus post(Home home, View x0, View x1); }; /** * \brief Domain consistent positive square propagator * * This propagator provides multiplication for positive views only. */ template class SqrPlusDom : public MixBinaryPropagator { protected: using MixBinaryPropagator::x0; using MixBinaryPropagator::x1; /// Constructor for posting SqrPlusDom(Home home, VA x0, VB x1); /// Constructor for cloning \a p SqrPlusDom(Space& home, bool share, SqrPlusDom& p); public: /// Post propagator \f$x_0\cdot x_0=x_1\f$ static ExecStatus post(Home home, VA x0, VB x1); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /** * \brief Cost function * * If a view has been assigned, the cost is low unary. * If in stage for bounds propagation, the cost is * low binary. Otherwise it is high binary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Domain consistent square propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class SqrDom : public BinaryPropagator { protected: using BinaryPropagator::x0; using BinaryPropagator::x1; /// Constructor for cloning \a p SqrDom(Space& home, bool share, SqrDom& p); /// Constructor for posting SqrDom(Home home, View x0, View x1); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /** * \brief Cost function * * If a view has been assigned, the cost is low unary. * If in stage for bounds propagation, the cost is * low binary. Otherwise it is high binary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Post propagator \f$x_0\cdot x_0=x_1\f$ static ExecStatus post(Home home, View x0, View x1); }; /** * \brief Bounds consistent square root propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class SqrtBnd : public BinaryPropagator { protected: using BinaryPropagator::x0; using BinaryPropagator::x1; /// Constructor for cloning \a p SqrtBnd(Space& home, bool share, SqrtBnd& p); /// Constructor for posting SqrtBnd(Home home, View x0, View x1); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post propagator \f$\lfloor\sqrt{x_0}\rfloor=x_1\f$ static ExecStatus post(Home home, View x0, View x1); }; /** * \brief Domain consistent square root propagator * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class SqrtDom : public BinaryPropagator { protected: using BinaryPropagator::x0; using BinaryPropagator::x1; /// Constructor for cloning \a p SqrtDom(Space& home, bool share, SqrtDom& p); /// Constructor for posting SqrtDom(Home home, View x0, View x1); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /** * \brief Cost function * * If a view has been assigned, the cost is low unary. * If in stage for bounds propagation, the cost is * low binary. Otherwise it is high binary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Post propagator \f$\lfloor\sqrt{x_0}\rfloor=x_1\f$ static ExecStatus post(Home home, View x0, View x1); }; /** * \brief Bounds or domain consistent propagator for \f$x_0\times x_1=x_0\f$ * * Requires \code #include \endcode * \ingroup FuncIntProp */ template class MultZeroOne : public BinaryPropagator { protected: using BinaryPropagator::x0; using BinaryPropagator::x1; /// Constructor for cloning \a p MultZeroOne(Space& home, bool share, MultZeroOne& p); /// Constructor for posting MultZeroOne(Home home, View x0, View x1); /// Test whether \a x is equal to \a n static RelTest equal(View x, int n); public: /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); /// Post propagator \f$x_0\cdot x_1=x_0\f$ static ExecStatus post(Home home, View x0, View x1); }; /** * \brief Bounds consistent positive multiplication propagator * * This propagator provides multiplication for positive views only. */ template class MultPlusBnd : public MixTernaryPropagator { protected: using MixTernaryPropagator::x0; using MixTernaryPropagator::x1; using MixTernaryPropagator::x2; public: /// Constructor for posting MultPlusBnd(Home home, VA x0, VB x1, VC x2); /// Constructor for cloning \a p MultPlusBnd(Space& home, bool share, MultPlusBnd& p); /// Post propagator \f$x_0\cdot x_1=x_2\f$ static ExecStatus post(Home home, VA x0, VB x1, VC x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Bounds consistent multiplication propagator * * Requires \code #include \endcode * * \ingroup FuncIntProp */ template class MultBnd : public TernaryPropagator { protected: using TernaryPropagator::x0; using TernaryPropagator::x1; using TernaryPropagator::x2; /// Constructor for cloning \a p MultBnd(Space& home, bool share, MultBnd& p); public: /// Constructor for posting MultBnd(Home home, View x0, View x1, View x2); /// Post propagator \f$x_0\cdot x_1=x_2\f$ static ExecStatus post(Home home, View x0, View x1, View x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Domain consistent positive multiplication propagator * * This propagator provides multiplication for positive views only. */ template class MultPlusDom : public MixTernaryPropagator { protected: using MixTernaryPropagator::x0; using MixTernaryPropagator::x1; using MixTernaryPropagator::x2; public: /// Constructor for posting MultPlusDom(Home home, VA x0, VB x1, VC x2); /// Constructor for cloning \a p MultPlusDom(Space& home, bool share, MultPlusDom& p); /// Post propagator \f$x_0\cdot x_1=x_2\f$ static ExecStatus post(Home home, VA x0, VB x1, VC x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /** * \brief Cost function * * If in stage for bounds propagation, the cost is * low ternary. Otherwise it is high ternary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Domain consistent multiplication propagator * * Requires \code #include \endcode * * \ingroup FuncIntProp */ template class MultDom : public TernaryPropagator { protected: using TernaryPropagator::x0; using TernaryPropagator::x1; using TernaryPropagator::x2; /// Constructor for cloning \a p MultDom(Space& home, bool share, MultDom& p); public: /// Constructor for posting MultDom(Home home, View x0, View x1, View x2); /// Post propagator \f$x_0\cdot x_1=x_2\f$ static ExecStatus post(Home home, View x0, View x1, View x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /** * \brief Cost function * * If in stage for bounds propagation, the cost is * low ternary. Otherwise it is high ternary. */ virtual PropCost cost(const Space& home, const ModEventDelta& med) const; /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Bounds consistent positive division propagator * * This propagator provides division for positive views only. */ template class DivPlusBnd : public MixTernaryPropagator { protected: using MixTernaryPropagator::x0; using MixTernaryPropagator::x1; using MixTernaryPropagator::x2; public: /// Constructor for posting DivPlusBnd(Home home, VA x0, VB x1, VC x2); /// Constructor for cloning \a p DivPlusBnd(Space& home, bool share, DivPlusBnd& p); /// Post propagator \f$x_0\mathrm{div} x_1=x_2\f$ (rounding towards 0) static ExecStatus post(Home home, VA x0, VB x1, VC x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Bounds consistent division propagator * * Requires \code #include \endcode * * \ingroup FuncIntProp */ template class DivBnd : public TernaryPropagator { protected: using TernaryPropagator::x0; using TernaryPropagator::x1; using TernaryPropagator::x2; /// Constructor for cloning \a p DivBnd(Space& home, bool share, DivBnd& p); public: /// Constructor for posting DivBnd(Home home, View x0, View x1, View x2); /// Post propagator \f$x_0\mathrm{div} x_1=x_2\f$ (rounding towards 0) static ExecStatus post(Home home, View x0, View x1, View x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; /** * \brief Integer division/modulo propagator * * This propagator implements the relation between divisor and * modulo of an integer division. * * Requires \code #include \endcode * * \ingroup FuncIntProp */ template class DivMod : public TernaryPropagator { protected: using TernaryPropagator::x0; using TernaryPropagator::x1; using TernaryPropagator::x2; /// Constructor for cloning \a p DivMod(Space& home, bool share, DivMod& p); public: /// Constructor for posting DivMod(Home home, View x0, View x1, View x2); /// Post propagator \f$x_1\neq 0 \land (x_2\neq 0\Rightarrow x_0\times x_2>0) \land \mathrm{abs}(x_2)<\mathrm{abs}(x_1)\f$ static ExecStatus post(Home home, View x0, View x1, View x2); /// Copy propagator during cloning virtual Actor* copy(Space& home, bool share); /// Perform propagation virtual ExecStatus propagate(Space& home, const ModEventDelta& med); }; }}} #include #include #include #include #include #include #endif // STATISTICS: int-prop