branching.icc

Go to the documentation of this file.

/* -*- mode: C++; c-basic-offset: 2; indent-tabs-mode: nil -*- */
/*
 *  Main authors:
 *     Christian Schulte <schulte@gecode.org>
 *     Guido Tack <tack@gecode.org>
 *
 *  Copyright:
 *     Christian Schulte, 2004
 *     Guido Tack, 2004
 *
 *  Last modified:
 *     $Date: 2008-08-20 15:55:47 +0200 (Wed, 20 Aug 2008) $ by $Author: tack $
 *     $Revision: 7658 $
 *
 *  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.
 *
 */

namespace Gecode {


  enum ViewSelStatus {
    VSS_NONE,   
    VSS_SELECT, 
    VSS_COMMIT  
  };

  template <class View, class Val, class ViewSel, class ValSel>
  class ViewValBranching : public Branching {
  protected:
    ViewArray<View> x;  
    mutable int start;  

    ViewValBranching(Space* home, bool share, ViewValBranching& b);
  public:
    ViewValBranching(Space* home, ViewArray<View>& x);
    virtual bool status(const Space* home) const;
    virtual const BranchingDesc* description(const Space* home) const;
    virtual ExecStatus commit(Space* home, const BranchingDesc* d,
                              unsigned int a);
    virtual Reflection::ActorSpec spec(const Space* home,
                                       Reflection::VarMap& m) const;
    virtual Reflection::BranchingSpec
    branchingSpec(const Space* home, 
                  Reflection::VarMap& m,
                  const BranchingDesc* d) const;
    static Support::Symbol ati(void);
    static void post(Space* home, Reflection::VarMap& m,
                     const Reflection::ActorSpec& spec);
    virtual Actor* copy(Space* home, bool share);
  };

  template <class View, class Val, class ValSel>
  class ViewValAssignment : public Branching {
  protected:
    ViewArray<View> x;  
    mutable int start;  

    ViewValAssignment(Space* home, bool share, ViewValAssignment& b);
  public:
    ViewValAssignment(Space* home, ViewArray<View>& x);
    virtual bool status(const Space* home) const;
    virtual const BranchingDesc* description(const Space* home) const;
    virtual ExecStatus commit(Space* home, const BranchingDesc* d,
                              unsigned int a);
    virtual Reflection::ActorSpec spec(const Space* home,
                                        Reflection::VarMap& m) const;
    virtual Reflection::BranchingSpec
    branchingSpec(const Space* home, 
                  Reflection::VarMap& m,
                  const BranchingDesc* d) const;
    static Support::Symbol ati(void);
    static void post(Space* home, Reflection::VarMap& m,
                     const Reflection::ActorSpec& spec);
    virtual Actor* copy(Space* home, bool share);
  };

  template <class Val, unsigned int alt>
  class PosValDesc : public BranchingDesc {
  protected:
    const int _pos;
    const Val _val;
  public:
    PosValDesc(const Branching* b, const int p, const Val& n);
    int pos(void) const;
    Val val(void) const;
    virtual size_t size(void) const;
  };







  /*
   * Branching descriptions with position and value
   *
   */

  template <class Val, unsigned int alt>
  forceinline
  PosValDesc<Val,alt>::PosValDesc(const Branching* b, const int p,
                                  const Val& n)
    : BranchingDesc(b,alt), _pos(p), _val(n) {}

  template <class Val, unsigned int alt>
  forceinline int
  PosValDesc<Val,alt>::pos(void) const {
    return _pos;
  }

  template <class Val, unsigned int alt>
  forceinline Val
  PosValDesc<Val,alt>::val(void) const {
    return _val;
  }

  template <class Val, unsigned int alt>
  size_t
  PosValDesc<Val,alt>::size(void) const {
    return sizeof(PosValDesc<Val,alt>);
  }


  /*
   * Generic branching based on variable/value selection
   *
   */

  template <class View, class Val, class ViewSel, class ValSel>
  forceinline
  ViewValBranching<View,Val,ViewSel,ValSel>
  ::ViewValBranching(Space* home, ViewArray<View>& x0)
    : Branching(home), x(x0), start(0) {}


  template <class View, class Val, class ViewSel, class ValSel>
  forceinline
  ViewValBranching<View,Val,ViewSel,ValSel>
  ::ViewValBranching(Space* home, bool share, ViewValBranching& b)
    : Branching(home,share,b), start(b.start) {
    x.update(home,share,b.x);
  }

  template <class View, class Val, class ViewSel, class ValSel>
  Actor*
  ViewValBranching<View,Val,ViewSel,ValSel>::copy(Space* home, bool share) {
    return new (home)
      ViewValBranching<View,Val,ViewSel,ValSel>(home,share,*this);
  }

  template <class View, class Val, class ViewSel, class ValSel>
  bool
  ViewValBranching<View,Val,ViewSel,ValSel>
  ::status(const Space*) const {
    for (int i=start; i < x.size(); i++)
      if (!x[i].assigned()) {
        start = i;
        return true;
      }
    return false;
  }

  template <class View, class Val, class ViewSel, class ValSel>
  const BranchingDesc*
  ViewValBranching<View,Val,ViewSel,ValSel>
  ::description(const Space* home) const {
    assert(!x[start].assigned());
    ViewSel vs; // For view selection
    ValSel  vl; // For value selection
    int i = start;
    int b = i++;
    if (vs.init(home,x[b]) != VSS_COMMIT)
      for (; i < x.size(); i++)
        if (!x[i].assigned())
          switch (vs.select(home,x[i])) {
          case VSS_SELECT: b=i; break;
          case VSS_COMMIT: b=i; goto create;
          case VSS_NONE:   break;
          default:         GECODE_NEVER;
          }
  create:
    return new PosValDesc<Val,2>(this,b,vl.val(home,x[b]));
  }

  template <class View, class Val, class ViewSel, class ValSel>
  ExecStatus
  ViewValBranching<View,Val,ViewSel,ValSel>
  ::commit(Space* home, const BranchingDesc* d, unsigned int a) {
    const PosValDesc<Val,2>* pvd = static_cast<const PosValDesc<Val,2>*>(d);
    ValSel vs;
    return me_failed(vs.tell(home,a,x[pvd->pos()],pvd->val()))
      ? ES_FAILED : ES_OK;
  }

  template <class View, class Val, class ViewSel, class ValSel>
  Support::Symbol
  ViewValBranching<View,Val,ViewSel,ValSel>::ati(void) {
    return Reflection::mangle<View,Val,ViewSel,ValSel>("Gecode::ViewValBranching");
  }

  template <class View, class Val, class ViewSel, class ValSel>
  void
  ViewValBranching<View,Val,ViewSel,ValSel>
    ::post(Space* home, Reflection::VarMap& vars,
           const Reflection::ActorSpec& spec) {
    spec.checkArity(1);
    ViewArray<View> x(home, vars, spec[0]);
    (void) new (home) ViewValBranching<View,Val,ViewSel,ValSel>(home, x);
  }

  template <class View, class Val, class ViewSel, class ValSel>
  Reflection::ActorSpec
  ViewValBranching<View,Val,ViewSel,ValSel>::spec(const Space* home,
    Reflection::VarMap& m) const {
    Reflection::ActorSpec s(ati());
    return s << x.spec(home, m);
  }

  template <class View, class Val, class ViewSel, class ValSel>
  Reflection::BranchingSpec
  ViewValBranching<View,Val,ViewSel,ValSel>::branchingSpec(const Space* home, 
    Reflection::VarMap& m, const BranchingDesc* d) const {
    Reflection::BranchingSpec bs(d);
    const PosValDesc<Val,2>* pvd = static_cast<const PosValDesc<Val,2>*>(d);
    ValSel vs;
    vs.branchingSpec(home, m, bs, 2, x[pvd->pos()], pvd->val());
    return bs;
  }

  /*
   * Generic assignment based on value selection
   *
   */

  template <class View, class Val, class ValSel>
  forceinline
  ViewValAssignment<View,Val,ValSel>
  ::ViewValAssignment(Space* home, ViewArray<View>& x0)
    : Branching(home), x(x0), start(0) {}


  template <class View, class Val, class ValSel>
  forceinline
  ViewValAssignment<View,Val,ValSel>
  ::ViewValAssignment(Space* home, bool share, ViewValAssignment& b)
    : Branching(home,share,b), start(b.start) {
    x.update(home,share,b.x);
  }

  template <class View, class Val, class ValSel>
  Actor*
  ViewValAssignment<View,Val,ValSel>::copy(Space* home, bool share) {
    return new (home)
      ViewValAssignment<View,Val,ValSel>(home,share,*this);
  }

  template <class View, class Val, class ValSel>
  bool
  ViewValAssignment<View,Val,ValSel>
  ::status(const Space*) const {
    for (int i=start; i < x.size(); i++)
      if (!x[i].assigned()) {
        start = i;
        return true;
      }
    return false;
  }

  template <class View, class Val, class ValSel>
  const BranchingDesc*
  ViewValAssignment<View,Val,ValSel>
  ::description(const Space* home) const {
    assert(!x[start].assigned());
    ValSel vl; // For value selection
    return new PosValDesc<Val,1>(this,start,vl.val(home,x[start]));
  }

  template <class View, class Val, class ValSel>
  ExecStatus
  ViewValAssignment<View,Val,ValSel>
  ::commit(Space* home, const BranchingDesc* d, unsigned int) {
    const PosValDesc<Val,1>* pvd = static_cast<const PosValDesc<Val,1>*>(d);
    ValSel vs;
    return me_failed(vs.tell(home,0,x[pvd->pos()],pvd->val()))
      ? ES_FAILED : ES_OK;
  }

  template <class View, class Val, class ValSel>
  Support::Symbol
  ViewValAssignment<View,Val,ValSel>::ati(void) {
    return Reflection::mangle<View,Val,ValSel>("Gecode::ViewValAssignment");
  }

  template <class View, class Val, class ValSel>
  void
  ViewValAssignment<View,Val,ValSel>
    ::post(Space* home, Reflection::VarMap& vars,
           const Reflection::ActorSpec& spec) {
    spec.checkArity(1);
    ViewArray<View> x(home, vars, spec[0]);
    (void) new (home) ViewValAssignment<View,Val,ValSel>(home, x);
  }

  template <class View, class Val, class ValSel>
  Reflection::ActorSpec
  ViewValAssignment<View,Val,ValSel>::spec(const Space* home,
    Reflection::VarMap& m) const {
    Reflection::ActorSpec s(ati());
    return s << x.spec(home, m);
  }

  template <class View, class Val, class ValSel>
  Reflection::BranchingSpec
  ViewValAssignment<View,Val,ValSel>::branchingSpec(const Space* home, 
    Reflection::VarMap& m, const BranchingDesc* d) const {
    Reflection::BranchingSpec bs(d);
    const PosValDesc<Val,1>* pvd = static_cast<const PosValDesc<Val,1>*>(d);
    ValSel vs;
    vs.branchingSpec(home, m, bs, 1, x[pvd->pos()], pvd->val());
    return bs;
  }

}

// STATISTICS: kernel-other