branch.cpp
Go to the documentation of this file.
/* -*- mode: C++; c-basic-offset: 2; indent-tabs-mode: nil -*- */
/*
* Main authors:
* Christian Schulte <schulte@gecode.org>
*
* Copyright:
* Christian Schulte, 2012
*
* 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.
*
*/
#include <gecode/int/branch.hh>
namespace Gecode {
void
branch(Home home, const IntVarArgs& x,
IntVarBranch vars, IntValBranch vals,
IntBranchFilter bf,
IntVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
vars.expand(home,x);
ViewArray<IntView> xv(home,x);
ViewSel<IntView>* vs[1] = {
Branch::viewsel(home,vars)
};
switch (vals.select()) {
case IntValBranch::SEL_VALUES_MIN:
Branch::postviewvaluesbrancher<1,true>(home,xv,vs,bf,vvp);
break;
case IntValBranch::SEL_VALUES_MAX:
Branch::postviewvaluesbrancher<1,false>(home,xv,vs,bf,vvp);
break;
default:
postviewvalbrancher<IntView,1,int,2>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
break;
}
}
void
branch(Home home, const IntVarArgs& x,
TieBreak<IntVarBranch> vars, IntValBranch vals,
IntBranchFilter bf,
IntVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
vars.a.expand(home,x);
if ((vars.a.select() == IntVarBranch::SEL_NONE) ||
(vars.a.select() == IntVarBranch::SEL_RND))
vars.b = INT_VAR_NONE();
vars.b.expand(home,x);
if ((vars.b.select() == IntVarBranch::SEL_NONE) ||
(vars.b.select() == IntVarBranch::SEL_RND))
vars.c = INT_VAR_NONE();
vars.c.expand(home,x);
if ((vars.c.select() == IntVarBranch::SEL_NONE) ||
(vars.c.select() == IntVarBranch::SEL_RND))
vars.d = INT_VAR_NONE();
vars.d.expand(home,x);
if (vars.b.select() == IntVarBranch::SEL_NONE) {
branch(home,x,vars.a,vals,bf,vvp);
} else {
ViewArray<IntView> xv(home,x);
if (vars.c.select() == IntVarBranch::SEL_NONE) {
ViewSel<IntView>* vs[2] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b)
};
switch (vals.select()) {
case IntValBranch::SEL_VALUES_MIN:
Branch::postviewvaluesbrancher<2,true>(home,xv,vs,bf,vvp);
break;
case IntValBranch::SEL_VALUES_MAX:
Branch::postviewvaluesbrancher<2,false>(home,xv,vs,bf,vvp);
break;
default:
postviewvalbrancher<IntView,2,int,2>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
}
} else if (vars.d.select() == IntVarBranch::SEL_NONE) {
ViewSel<IntView>* vs[3] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c)
};
switch (vals.select()) {
case IntValBranch::SEL_VALUES_MIN:
Branch::postviewvaluesbrancher<3,true>(home,xv,vs,bf,vvp);
break;
case IntValBranch::SEL_VALUES_MAX:
Branch::postviewvaluesbrancher<3,false>(home,xv,vs,bf,vvp);
break;
default:
postviewvalbrancher<IntView,3,int,2>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
}
} else {
ViewSel<IntView>* vs[4] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c),Branch::viewsel(home,vars.d)
};
switch (vals.select()) {
case IntValBranch::SEL_VALUES_MIN:
Branch::postviewvaluesbrancher<4,true>(home,xv,vs,bf,vvp);
break;
case IntValBranch::SEL_VALUES_MAX:
Branch::postviewvaluesbrancher<4,false>(home,xv,vs,bf,vvp);
break;
default:
postviewvalbrancher<IntView,4,int,2>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
}
}
}
}
void
branch(Home home, IntVar x, IntValBranch vals, IntVarValPrint vvp) {
IntVarArgs xv(1); xv[0]=x;
branch(home, xv, INT_VAR_NONE(), vals, nullptr, vvp);
}
void
assign(Home home, const IntVarArgs& x,
IntVarBranch vars, IntAssign vals,
IntBranchFilter bf,
IntVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
ViewArray<IntView> xv(home,x);
ViewSel<IntView>* vs[1] = {
new (home) ViewSelNone<IntView>(home,vars)
};
postviewvalbrancher<IntView,1,int,1>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
}
void
branch(Home home, const IntVarArgs& x,
TieBreak<IntVarBranch> vars, IntAssign vals,
IntBranchFilter bf,
IntVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
vars.a.expand(home,x);
if ((vars.a.select() == IntVarBranch::SEL_NONE) ||
(vars.a.select() == IntVarBranch::SEL_RND))
vars.b = INT_VAR_NONE();
vars.b.expand(home,x);
if ((vars.b.select() == IntVarBranch::SEL_NONE) ||
(vars.b.select() == IntVarBranch::SEL_RND))
vars.c = INT_VAR_NONE();
vars.c.expand(home,x);
if ((vars.c.select() == IntVarBranch::SEL_NONE) ||
(vars.c.select() == IntVarBranch::SEL_RND))
vars.d = INT_VAR_NONE();
vars.d.expand(home,x);
if (vars.b.select() == IntVarBranch::SEL_NONE) {
assign(home,x,vars.a,vals,bf,vvp);
} else {
ViewArray<IntView> xv(home,x);
if (vars.c.select() == IntVarBranch::SEL_NONE) {
ViewSel<IntView>* vs[2] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b)
};
postviewvalbrancher<IntView,2,int,1>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
} else if (vars.d.select() == IntVarBranch::SEL_NONE) {
ViewSel<IntView>* vs[3] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c)
};
postviewvalbrancher<IntView,3,int,1>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
} else {
ViewSel<IntView>* vs[4] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c),Branch::viewsel(home,vars.d)
};
postviewvalbrancher<IntView,4,int,1>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
}
}
}
void
assign(Home home, IntVar x, IntAssign ia, IntVarValPrint vvp) {
IntVarArgs xv(1); xv[0]=x;
assign(home, xv, INT_VAR_NONE(), ia, nullptr, vvp);
}
void
branch(Home home, const BoolVarArgs& x,
BoolVarBranch vars, BoolValBranch vals,
BoolBranchFilter bf,
BoolVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
vars.expand(home,x);
ViewArray<BoolView> xv(home,x);
ViewSel<BoolView>* vs[1] = {
Branch::viewsel(home,vars)
};
postviewvalbrancher<BoolView,1,int,2>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
}
void
branch(Home home, const BoolVarArgs& x,
TieBreak<BoolVarBranch> vars, BoolValBranch vals,
BoolBranchFilter bf,
BoolVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
vars.a.expand(home,x);
if ((vars.a.select() == BoolVarBranch::SEL_NONE) ||
(vars.a.select() == BoolVarBranch::SEL_RND))
vars.b = BOOL_VAR_NONE();
vars.b.expand(home,x);
if ((vars.b.select() == BoolVarBranch::SEL_NONE) ||
(vars.b.select() == BoolVarBranch::SEL_RND))
vars.c = BOOL_VAR_NONE();
vars.c.expand(home,x);
if ((vars.c.select() == BoolVarBranch::SEL_NONE) ||
(vars.c.select() == BoolVarBranch::SEL_RND))
vars.d = BOOL_VAR_NONE();
vars.d.expand(home,x);
if (vars.b.select() == BoolVarBranch::SEL_NONE) {
branch(home,x,vars.a,vals,bf,vvp);
} else {
ViewArray<BoolView> xv(home,x);
ValSelCommitBase<BoolView,int>*
vsc = Branch::valselcommit(home,vals);
if (vars.c.select() == BoolVarBranch::SEL_NONE) {
ViewSel<BoolView>* vs[2] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b)
};
postviewvalbrancher<BoolView,2,int,2>(home,xv,vs,vsc,bf,vvp);
} else if (vars.d.select() == BoolVarBranch::SEL_NONE) {
ViewSel<BoolView>* vs[3] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c)
};
postviewvalbrancher<BoolView,3,int,2>(home,xv,vs,vsc,bf,vvp);
} else {
ViewSel<BoolView>* vs[4] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c),Branch::viewsel(home,vars.d)
};
postviewvalbrancher<BoolView,4,int,2>(home,xv,vs,vsc,bf,vvp);
}
}
}
void
branch(Home home, BoolVar x, BoolValBranch vals, BoolVarValPrint vvp) {
BoolVarArgs xv(1); xv[0]=x;
branch(home, xv, BOOL_VAR_NONE(), vals, nullptr, vvp);
}
void
assign(Home home, const BoolVarArgs& x,
BoolVarBranch vars, BoolAssign vals,
BoolBranchFilter bf,
BoolVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
ViewArray<BoolView> xv(home,x);
ViewSel<BoolView>* vs[1] = {
new (home) ViewSelNone<BoolView>(home,vars)
};
postviewvalbrancher<BoolView,1,int,1>
(home,xv,vs,Branch::valselcommit(home,vals),bf,vvp);
}
void
assign(Home home, const BoolVarArgs& x,
TieBreak<BoolVarBranch> vars, BoolAssign vals,
BoolBranchFilter bf,
BoolVarValPrint vvp) {
using namespace Int;
if (home.failed()) return;
vars.a.expand(home,x);
if ((vars.a.select() == BoolVarBranch::SEL_NONE) ||
(vars.a.select() == BoolVarBranch::SEL_RND))
vars.b = BOOL_VAR_NONE();
vars.b.expand(home,x);
if ((vars.b.select() == BoolVarBranch::SEL_NONE) ||
(vars.b.select() == BoolVarBranch::SEL_RND))
vars.c = BOOL_VAR_NONE();
vars.c.expand(home,x);
if ((vars.c.select() == BoolVarBranch::SEL_NONE) ||
(vars.c.select() == BoolVarBranch::SEL_RND))
vars.d = BOOL_VAR_NONE();
vars.d.expand(home,x);
if (vars.b.select() == BoolVarBranch::SEL_NONE) {
assign(home,x,vars.a,vals,bf,vvp);
} else {
ViewArray<BoolView> xv(home,x);
ValSelCommitBase<BoolView,int>*
vsc = Branch::valselcommit(home,vals);
if (vars.c.select() == BoolVarBranch::SEL_NONE) {
ViewSel<BoolView>* vs[2] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b)
};
postviewvalbrancher<BoolView,2,int,1>(home,xv,vs,vsc,bf,vvp);
} else if (vars.d.select() == BoolVarBranch::SEL_NONE) {
ViewSel<BoolView>* vs[3] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c)
};
postviewvalbrancher<BoolView,3,int,1>(home,xv,vs,vsc,bf,vvp);
} else {
ViewSel<BoolView>* vs[4] = {
Branch::viewsel(home,vars.a),Branch::viewsel(home,vars.b),
Branch::viewsel(home,vars.c),Branch::viewsel(home,vars.d)
};
postviewvalbrancher<BoolView,4,int,1>(home,xv,vs,vsc,bf,vvp);
}
}
}
void
assign(Home home, BoolVar x, BoolAssign ba, BoolVarValPrint vvp) {
BoolVarArgs xv(1); xv[0]=x;
assign(home, xv, BOOL_VAR_NONE(), ba, nullptr, vvp);
}
#ifdef GECODE_HAS_CBS
void
cbsbranch(Home home, const IntVarArgs& x) {
using namespace Int;
if (home.failed()) return;
ViewArray<IntView> y(home,x);
Branch::CBSBrancher<IntView>::post(home,y);
}
void
cbsbranch(Home home, const BoolVarArgs& x) {
using namespace Int;
if (home.failed()) return;
ViewArray<BoolView> y(home,x);
Branch::CBSBrancher<BoolView>::post(home,y);
}
#endif
}
// STATISTICS: int-post
Gecode::BoolAssign
Which values to select for assignment.
Definition int.hh:5000
Gecode::BoolValBranch
Which values to select for branching first.
Definition int.hh:4889
Gecode::BoolVarArgs
Passing Boolean variables.
Definition int.hh:712
Gecode::BoolVarBranch
Which Boolean variable to select for branching.
Definition int.hh:4656
Gecode::BoolVarBranch::expand
void expand(Home home, const BoolVarArgs &x)
Expand decay factor into AFC or action.
Definition var.hpp:345
Gecode::BoolVarBranch::SEL_RND
@ SEL_RND
Random (uniform, for tie breaking).
Definition int.hh:4661
Gecode::BoolVarBranch::SEL_NONE
@ SEL_NONE
First unassigned.
Definition int.hh:4660
Gecode::BoolVar
Boolean integer variables.
Definition int.hh:512
Gecode::Home
Home class for posting propagators
Definition core.hpp:856
Gecode::Home::failed
bool failed(void) const
Check whether corresponding space is failed.
Definition core.hpp:4048
Gecode::IntAssign
Which values to select for assignment.
Definition int.hh:4971
Gecode::IntValBranch
Which values to select for branching first.
Definition int.hh:4854
Gecode::IntValBranch::SEL_VALUES_MIN
@ SEL_VALUES_MIN
Select all values starting from smallest.
Definition int.hh:4867
Gecode::IntValBranch::SEL_VALUES_MAX
@ SEL_VALUES_MAX
Select all values starting from largest.
Definition int.hh:4868
Gecode::IntValBranch::select
Select select(void) const
Return selection strategy.
Definition val.hpp:49
Gecode::IntVarArgs
Passing integer variables.
Definition int.hh:656
Gecode::IntVarBranch
Which integer variable to select for branching.
Definition int.hh:4570
Gecode::IntVarBranch::expand
void expand(Home home, const IntVarArgs &x)
Expand AFC, action, and CHB.
Definition var.hpp:74
Gecode::IntVarBranch::SEL_RND
@ SEL_RND
Random (uniform, for tie breaking).
Definition int.hh:4575
Gecode::IntVarBranch::SEL_NONE
@ SEL_NONE
First unassigned.
Definition int.hh:4574
Gecode::IntVar
Integer variables.
Definition int.hh:371
Gecode::TieBreak
Combine variable selection criteria for tie-breaking.
Definition tiebreak.hpp:38
Gecode::TieBreak::b
VarBranch b
Definition tiebreak.hpp:41
Gecode::TieBreak::a
VarBranch a
Branching criteria to try in order.
Definition tiebreak.hpp:41
Gecode::TieBreak::c
VarBranch c
Definition tiebreak.hpp:41
Gecode::TieBreak::d
VarBranch d
Definition tiebreak.hpp:41
Gecode::ValSelCommitBase
Base class for value selection and commit.
Definition val-sel-commit.hpp:44
Gecode::ViewArray
View arrays.
Definition array.hpp:253
Gecode::ViewSelNone
Select the first unassigned view.
Definition view-sel.hpp:109
Gecode::ViewSel
Abstract class for view selection.
Definition view-sel.hpp:44
branch.hh
Gecode::assign
void assign(Home home, const FloatVarArgs &x, FloatVarBranch vars, FloatAssign vals, FloatBranchFilter bf=nullptr, FloatVarValPrint vvp=nullptr)
Assign all x with variable selection vars and value selection vals.
Definition branch.cpp:111
Gecode::branch
void branch(Home home, const FloatVarArgs &x, FloatVarBranch vars, FloatValBranch vals, FloatBranchFilter bf=nullptr, FloatVarValPrint vvp=nullptr)
Branch over x with variable selection vars and value selection vals.
Definition branch.cpp:39
Gecode::IntBranchFilter
std::function< bool(const Space &home, IntVar x, int i)> IntBranchFilter
Branch filter function type for integer variables.
Definition int.hh:4176
Gecode::BoolBranchFilter
std::function< bool(const Space &home, BoolVar x, int i)> BoolBranchFilter
Branch filter function type for Boolean variables.
Definition int.hh:4186
Gecode::Int::Branch::viewsel
ViewSel< IntView > * viewsel(Space &home, const IntVarBranch &ivb)
Return view selectors for integer views.
Definition view-sel.cpp:39
Gecode::Int::Branch::postviewvaluesbrancher
void postviewvaluesbrancher(Home home, ViewArray< IntView > &x, ViewSel< IntView > *vs[n], IntBranchFilter bf, IntVarValPrint vvp)
Post brancher for view and values.
Definition view-values.hpp:191
Gecode::Int::Branch::valselcommit
ValSelCommitBase< IntView, int > * valselcommit(Space &home, const IntValBranch &ivb)
Return value and commit for integer views.
Definition val-sel-commit.cpp:39
Gecode::Int
Finite domain integers.
Gecode
Gecode toplevel namespace
Gecode::ba
IntPropLevel ba(IntPropLevel ipl)
Extract basic or advanced from propagation level.
Definition ipl.hpp:43
Gecode::INT_VAR_NONE
IntVarBranch INT_VAR_NONE(void)
Select first unassigned variable.
Definition var.hpp:96
Gecode::BOOL_VAR_NONE
BoolVarBranch BOOL_VAR_NONE(void)
Select first unassigned variable.
Definition var.hpp:364
Gecode::postviewvalbrancher
void postviewvalbrancher(Home home, ViewArray< View > &x, ViewSel< View > *vs[n], ValSelCommitBase< View, Val > *vsc, BranchFilter< typename View::VarType > bf, VarValPrint< typename View::VarType, Val > vvp)
Post view value brancher.
Definition view-val.hpp:341
Gecode::IntVarValPrint
std::function< void(const Space &home, const Brancher &b, unsigned int a, IntVar x, int i, const int &n, std::ostream &o)> IntVarValPrint
Function type for printing branching alternatives for integer variables.
Definition int.hh:4552
Gecode::BoolVarValPrint
std::function< void(const Space &home, const Brancher &b, unsigned int a, BoolVar x, int i, const int &n, std::ostream &o)> BoolVarValPrint
Function type for printing branching alternatives for Boolean variables.
Definition int.hh:4559