main page modules namespaces classes files
Gecode home

search for 

linear.hh

Go to the documentation of this file.

/*
 *  Main authors:
 *     Christian Schulte <schulte@gecode.org>
 *     Guido Tack <tack@gecode.org>
 *
 *  Copyright:
 *     Christian Schulte, 2002
 *     Guido Tack, 2004
 *
 *  Last modified:
 *     $Date: 2006-09-06 15:51:28 +0200 (Wed, 06 Sep 2006) $ by $Author: schulte $
 *     $Revision: 3604 $
 *
 *  This file is part of Gecode, the generic constraint
 *  development environment:
 *     http://www.gecode.org
 *
 *  See the file "LICENSE" for information on usage and
 *  redistribution of this file, and for a
 *     DISCLAIMER OF ALL WARRANTIES.
 *
 */

#ifndef __GECODE_INT_LINEAR_HH__
#define __GECODE_INT_LINEAR_HH__

#include "gecode/int.hh"

namespace Gecode { namespace Int { namespace Linear {

  /*
   * Binary propagators
   *
   */

  template <class Val, class A, class B, PropCond pc>
  class LinBin : public Propagator {
  protected:
    A x0;
    B x1;
    Val c;
    LinBin(Space* home, bool share, LinBin& p);
    LinBin(Space* home, bool share, Propagator& p, A x0, B x1, Val c);
    LinBin(Space* home, A x0, B x1, Val c);
  public:
    virtual PropCost cost(void) const;
    virtual size_t dispose(Space* home);
  };

  template <class Val, class A, class B, PropCond pc, class Ctrl>
  class ReLinBin : public Propagator {
  protected:
    A x0;
    B x1;
    Val c;
    Ctrl b;
    ReLinBin(Space* home, bool share, ReLinBin& p);
    ReLinBin(Space* home, A x0, B x1, Val c, Ctrl b);
  public:
    virtual PropCost cost(void) const;
    virtual size_t dispose(Space* home);
  };

  template <class Val, class A, class B>
  class EqBin : public LinBin<Val,A,B,PC_INT_BND> {
  protected:
    using LinBin<Val,A,B,PC_INT_BND>::x0;
    using LinBin<Val,A,B,PC_INT_BND>::x1;
    using LinBin<Val,A,B,PC_INT_BND>::c;

    EqBin(Space* home, bool share, EqBin& p);
    EqBin(Space* home, A x0, B x1, Val c);
  public:
    EqBin(Space* home, bool share, Propagator& p, A x0, B x1, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, Val c);
  };

  template <class Val, class A, class B, class Ctrl>
  class ReEqBin : public ReLinBin<Val,A,B,PC_INT_BND,Ctrl> {
  protected:
    using ReLinBin<Val,A,B,PC_INT_BND,Ctrl>::x0;
    using ReLinBin<Val,A,B,PC_INT_BND,Ctrl>::x1;
    using ReLinBin<Val,A,B,PC_INT_BND,Ctrl>::c;
    using ReLinBin<Val,A,B,PC_INT_BND,Ctrl>::b;

    ReEqBin(Space* home, bool share, ReEqBin& p);
    ReEqBin(Space* home,A,B,Val,Ctrl);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, Val c, Ctrl b);
  };

  template <class Val, class A, class B>
  class NqBin : public LinBin<Val,A,B,PC_INT_VAL> {
  protected:
    using LinBin<Val,A,B,PC_INT_VAL>::x0;
    using LinBin<Val,A,B,PC_INT_VAL>::x1;
    using LinBin<Val,A,B,PC_INT_VAL>::c;

    NqBin(Space* home, bool share, NqBin& p);
    NqBin(Space* home, A x0, B x1, Val c);
  public:
    NqBin(Space* home, bool share, Propagator& p, A x0, B x1, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    virtual PropCost cost(void) const;
    static ExecStatus post(Space* home, A x0, B x1, Val c);
  };

  template <class Val, class A, class B>
  class LqBin : public LinBin<Val,A,B,PC_INT_BND> {
  protected:
    using LinBin<Val,A,B,PC_INT_BND>::x0;
    using LinBin<Val,A,B,PC_INT_BND>::x1;
    using LinBin<Val,A,B,PC_INT_BND>::c;

    LqBin(Space* home, bool share, LqBin& p);
    LqBin(Space* home, A x0, B x1, Val c);
  public:
    LqBin(Space* home, bool share, Propagator& p, A x0, B x1, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, Val c);
  };

  template <class Val, class A, class B>
  class GqBin : public LinBin<Val,A,B,PC_INT_BND> {
  protected:
    using LinBin<Val,A,B,PC_INT_BND>::x0;
    using LinBin<Val,A,B,PC_INT_BND>::x1;
    using LinBin<Val,A,B,PC_INT_BND>::c;

    GqBin(Space* home, bool share, GqBin& p);
    GqBin(Space* home, A x0, B x1, Val c);
  public:
    GqBin(Space* home, bool share, Propagator& p, A x0, B x1, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, Val c);
  };

  template <class Val, class A, class B>
  class ReLqBin : public ReLinBin<Val,A,B,PC_INT_BND,BoolView> {
  protected:
    using ReLinBin<Val,A,B,PC_INT_BND,BoolView>::x0;
    using ReLinBin<Val,A,B,PC_INT_BND,BoolView>::x1;
    using ReLinBin<Val,A,B,PC_INT_BND,BoolView>::c;
    using ReLinBin<Val,A,B,PC_INT_BND,BoolView>::b;

    ReLqBin(Space* home, bool share, ReLqBin& p);
    ReLqBin(Space* home, A x0, B x1, Val c, BoolView b);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, Val c, BoolView b);
  };

}}}

#include "gecode/int/linear/binary.icc"

namespace Gecode { namespace Int { namespace Linear {

  /*
   * Ternary propagators
   *
   */

  template <class Val, class A, class B, class C, PropCond pc>
  class LinTer : public Propagator {
  protected:
    A x0;
    B x1;
    C x2;
    Val c;
    LinTer(Space* home, bool share, LinTer& p);
    LinTer(Space* home, A x0, B x1, C x2, Val c);
    LinTer(Space* home, bool share, Propagator& p, A x0, B x1, C x2, Val c);
  public:
    virtual PropCost cost(void) const;
    virtual size_t dispose(Space* home);
  };

  template <class Val, class A, class B, class C>
  class EqTer : public LinTer<Val,A,B,C,PC_INT_BND> {
  protected:
    using LinTer<Val,A,B,C,PC_INT_BND>::x0;
    using LinTer<Val,A,B,C,PC_INT_BND>::x1;
    using LinTer<Val,A,B,C,PC_INT_BND>::x2;
    using LinTer<Val,A,B,C,PC_INT_BND>::c;

    EqTer(Space* home, bool share, EqTer& p);
    EqTer(Space* home, A x0, B x1, C x2, Val c);
  public:
    EqTer(Space* home, bool share, Propagator& p, A x0, B x1, C x2, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, C x2, Val c);
  };

  template <class Val, class A, class B, class C>
  class NqTer : public LinTer<Val,A,B,C,PC_INT_VAL> {
  protected:
    using LinTer<Val,A,B,C,PC_INT_VAL>::x0;
    using LinTer<Val,A,B,C,PC_INT_VAL>::x1;
    using LinTer<Val,A,B,C,PC_INT_VAL>::x2;
    using LinTer<Val,A,B,C,PC_INT_VAL>::c;

    NqTer(Space* home, bool share, NqTer& p);
    NqTer(Space* home, A x0, B x1, C x2, Val c);
  public:
    NqTer(Space* home, bool share, Propagator& p, A x0, B x1, C x2, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, C x2, Val c);
  };

  template <class Val, class A, class B, class C>
  class LqTer : public LinTer<Val,A,B,C,PC_INT_BND> {
  protected:
    using LinTer<Val,A,B,C,PC_INT_BND>::x0;
    using LinTer<Val,A,B,C,PC_INT_BND>::x1;
    using LinTer<Val,A,B,C,PC_INT_BND>::x2;
    using LinTer<Val,A,B,C,PC_INT_BND>::c;

    LqTer(Space* home, bool share, LqTer& p);
    LqTer(Space* home, A x0, B x1, C x2, Val c);
  public:
    LqTer(Space* home, bool share, Propagator& p, A x0, B x1, C x2, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, A x0, B x1, C x2, Val c);
  };

}}}

#include "gecode/int/linear/ternary.icc"

namespace Gecode { namespace Int { namespace Linear {

  /*
   * n-ary propagators
   *
   */

  template <class Val, class P, class N, PropCond pc>
  class Lin : public Propagator {
  protected:
    ViewArray<P> x;
    ViewArray<N> y;
    Val c;

    Lin(Space* home, bool share, Lin& p);
    Lin(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c);
  public:
    virtual PropCost cost(void) const;
    virtual size_t dispose(Space* home);
  };

  template <class Val, class P, class N, PropCond pc, class Ctrl>
  class ReLin : public Lin<Val,P,N,pc> {
  protected:
    Ctrl b;
    ReLin(Space* home, bool share, ReLin& p);
    ReLin(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c, Ctrl b);
  public:
    virtual size_t dispose(Space* home);
  };

  template <class Val, class View>
  void bounds_p(const Propagator*, ViewArray<View>& x,
                Val& c, Val& sl, Val& su);

  template <class Val, class View>
  void bounds_n(const Propagator*, ViewArray<View>& y,
                Val& c, Val& sl, Val& su);

  template <class Val, class P, class N>
  class Eq : public Lin<Val,P,N,PC_INT_BND> {
  protected:
    using Lin<Val,P,N,PC_INT_BND>::x;
    using Lin<Val,P,N,PC_INT_BND>::y;
    using Lin<Val,P,N,PC_INT_BND>::c;

    Eq(Space* home, bool share, Eq& p);
  public:
    Eq(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus
    post(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c);
  };

  template <class Val, class View>
  class DomEq
    : public Lin<Val,View,View,PC_INT_DOM> {
  protected:
    using Lin<Val,View,View,PC_INT_DOM>::x;
    using Lin<Val,View,View,PC_INT_DOM>::y;
    using Lin<Val,View,View,PC_INT_DOM>::c;

    DomEq(Space* home, bool share, DomEq& p);
  public:
    DomEq(Space* home, ViewArray<View>& x, ViewArray<View>& y, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual PropCost cost(void) const;
    virtual ExecStatus propagate(Space* home);
    static ExecStatus
    post(Space* home, ViewArray<View>& x, ViewArray<View>& y, Val c);
  };

  template <class Val, class P, class N, class Ctrl>
  class ReEq : public ReLin<Val,P,N,PC_INT_BND,Ctrl> {
  protected:
    using ReLin<Val,P,N,PC_INT_BND,Ctrl>::x;
    using ReLin<Val,P,N,PC_INT_BND,Ctrl>::y;
    using ReLin<Val,P,N,PC_INT_BND,Ctrl>::c;
    using ReLin<Val,P,N,PC_INT_BND,Ctrl>::b;

    ReEq(Space* home, bool share, ReEq& p);
  public:
    ReEq(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c, Ctrl b);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus
    post(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c, Ctrl b);
  };

  template <class Val, class P, class N>
  class Nq : public Lin<Val,P,N,PC_INT_VAL> {
  protected:
    using Lin<Val,P,N,PC_INT_VAL>::x;
    using Lin<Val,P,N,PC_INT_VAL>::y;
    using Lin<Val,P,N,PC_INT_VAL>::c;

    Nq(Space* home, bool share, Nq& p);
  public:
    Nq(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus
    post(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c);
  };

  template <class Val, class P, class N>
  class Lq : public Lin<Val,P,N,PC_INT_BND> {
  protected:
    using Lin<Val,P,N,PC_INT_BND>::x;
    using Lin<Val,P,N,PC_INT_BND>::y;
    using Lin<Val,P,N,PC_INT_BND>::c;

    Lq(Space* home, bool share, Lq& p);
  public:
    Lq(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus
    post(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c);
  };

  template <class Val, class P, class N>
  class ReLq : public ReLin<Val,P,N,PC_INT_BND,BoolView> {
  protected:
    using ReLin<Val,P,N,PC_INT_BND,BoolView>::x;
    using ReLin<Val,P,N,PC_INT_BND,BoolView>::y;
    using ReLin<Val,P,N,PC_INT_BND,BoolView>::c;
    using ReLin<Val,P,N,PC_INT_BND,BoolView>::b;

    ReLq(Space* home, bool share, ReLq& p);
  public:
    ReLq(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c, BoolView b);
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus
    post(Space* home, ViewArray<P>& x, ViewArray<N>& y, Val c, BoolView b);
  };

}}}

#include "gecode/int/linear/nary.icc"
#include "gecode/int/linear/dom.icc"

namespace Gecode { namespace Int { namespace Linear {

  /*
   * Boolean linear propagators
   *
   */

  template <class VX>
  class LinBoolInt : public Propagator {
  protected:
    ViewArray<VX> x;
    int n_s;
    int c;
    LinBoolInt(Space* home, bool share, LinBoolInt& p);
    LinBoolInt(Space* home, ViewArray<VX>& x, int n_s, int c);
  public:
    virtual PropCost cost(void) const;
    virtual size_t dispose(Space* home);
  };

  template <class VX>
  class EqBoolInt : public LinBoolInt<VX> {
  protected:
    using LinBoolInt<VX>::x;
    using LinBoolInt<VX>::n_s;
    using LinBoolInt<VX>::c;
    EqBoolInt(Space* home, bool share, EqBoolInt& p);
    EqBoolInt(Space* home, ViewArray<VX>& x, int n_s, int c);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, ViewArray<VX>& x, int c);
  };

  template <class VX>
  class GqBoolInt : public LinBoolInt<VX> {
  protected:
    using LinBoolInt<VX>::x;
    using LinBoolInt<VX>::n_s;
    using LinBoolInt<VX>::c;
    GqBoolInt(Space* home, bool share, GqBoolInt& p);
    GqBoolInt(Space* home, ViewArray<VX>& x, int n_s, int c);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, ViewArray<VX>& x, int c);
  };

  template<class VX>
  class NqBoolInt : public BinaryPropagator<VX,PC_INT_VAL> {
  protected:
    using BinaryPropagator<VX,PC_INT_VAL>::x0;
    using BinaryPropagator<VX,PC_INT_VAL>::x1;
    ViewArray<VX> x;
    int c;
    bool resubscribe(Space* home, VX& y);
    NqBoolInt(Space* home,  ViewArray<VX>& b, int c);
    NqBoolInt(Space* home, bool share, NqBoolInt<VX>& p);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual PropCost cost(void) const;
    virtual ExecStatus propagate(Space* home);
    static  ExecStatus post(Space* home, ViewArray<VX>& b, int c);
  };

}}}

#include "gecode/int/linear/bool-int.icc"

namespace Gecode { namespace Int { namespace Linear {

  template <class XV, class YV>
  class LinBoolView : public Propagator {
  protected:
    ViewArray<XV> x;
    YV y;
    int c;
    LinBoolView(Space* home, bool share, LinBoolView& p);
    LinBoolView(Space* home, ViewArray<XV>& x, YV y, int c);
  public:
    virtual PropCost cost(void) const;
    virtual size_t dispose(Space* home);
  };


  template <class XV, class YV>
  class EqBoolView : public LinBoolView<XV,YV> {
  protected:
    using LinBoolView<XV,YV>::x;
    using LinBoolView<XV,YV>::y;
    using LinBoolView<XV,YV>::c;

    EqBoolView(Space* home, bool share, EqBoolView& p);
    EqBoolView(Space* home, ViewArray<XV>& x, YV y, int c);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, ViewArray<XV>& x, YV y, int c);
  };

  template <class XV, class YV>
  class NqBoolView : public LinBoolView<XV,YV> {
  protected:
    using LinBoolView<XV,YV>::x;
    using LinBoolView<XV,YV>::y;
    using LinBoolView<XV,YV>::c;

    NqBoolView(Space* home, bool share, NqBoolView& p);
    NqBoolView(Space* home, ViewArray<XV>& x, YV y, int c);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, ViewArray<XV>& x, YV y, int c);
  };

  template <class XV, class YV>
  class GqBoolView : public LinBoolView<XV,YV> {
  protected:
    using LinBoolView<XV,YV>::x;
    using LinBoolView<XV,YV>::y;
    using LinBoolView<XV,YV>::c;

    GqBoolView(Space* home, bool share, GqBoolView& p);
    GqBoolView(Space* home, ViewArray<XV>& x, YV y, int c);
  public:
    virtual Actor* copy(Space* home, bool share);
    virtual ExecStatus propagate(Space* home);
    static ExecStatus post(Space* home, ViewArray<XV>& x, YV y, int c);
  };

}}}

#include "gecode/int/linear/bool-view.icc"

namespace Gecode { namespace Int { namespace Linear {


  /*
   * Support for preprocessing and posting
   *
   */

  class Term {
  public:
    int a;
    IntView x;
  };

  GECODE_INT_EXPORT void
  post(Space* home, Term t[], int n, IntRelType r, int c, IntConLevel=ICL_DEF);

  GECODE_INT_EXPORT void
  post(Space* home, Term t[], int n, IntRelType r, int c, BoolView b);

}}}

#endif

// STATISTICS: int-prop