Generated on Sat Feb 7 2015 02:01:23 for Gecode by doxygen 1.8.9.1
ldsb.hh
Go to the documentation of this file.
1 /* -*- mode: C++; c-basic-offset: 2; indent-tabs-mode: nil -*- */
2 /*
3  * Main authors:
4  * Christopher Mears <chris.mears@monash.edu>
5  *
6  * Copyright:
7  * Christopher Mears, 2012
8  *
9  * Last modified:
10  * $Date: 2013-05-08 13:30:48 +0200 (Wed, 08 May 2013) $ by $Author: schulte $
11  * $Revision: 13622 $
12  *
13  * This file is part of Gecode, the generic constraint
14  * development environment:
15  * http://www.gecode.org
16  *
17  * Permission is hereby granted, free of charge, to any person obtaining
18  * a copy of this software and associated documentation files (the
19  * "Software"), to deal in the Software without restriction, including
20  * without limitation the rights to use, copy, modify, merge, publish,
21  * distribute, sublicense, and/or sell copies of the Software, and to
22  * permit persons to whom the Software is furnished to do so, subject to
23  * the following conditions:
24  *
25  * The above copyright notice and this permission notice shall be
26  * included in all copies or substantial portions of the Software.
27  *
28  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
29  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
30  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
31  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
32  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
33  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
34  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
35  *
36  */
37 
38 #ifndef __GECODE_INT_LDSB_HH__
39 #define __GECODE_INT_LDSB_HH__
40 
41 #include <gecode/int.hh>
42 
47 namespace Gecode { namespace Int { namespace LDSB {
48 
50  class Literal {
51  public:
53  Literal(void);
55  Literal(int _var, int _val);
56 
59  int _variable;
63  int _value;
64 
67  bool operator <(const Literal &rhs) const;
68  };
69 
82  std::pair<int,int>
83  findVar(int *indices, unsigned int n_values, unsigned int seq_size, int index);
84 }}}
85 
86 namespace Gecode {
88  template<>
90  public:
94  };
95 
99  template<>
100  class ArrayTraits<LiteralArgs> {
101  public:
102  typedef LiteralArgs StorageType;
104  typedef LiteralArgs ArgsType;
105  };
106 }
107 
108 namespace Gecode { namespace Int { namespace LDSB {
111  public:
113  int nrefs;
115  SymmetryObject(void);
117  virtual ~SymmetryObject(void);
118  };
121  public:
125  int nxs;
129  ~VariableSymmetryObject(void);
130  };
133  public:
138  };
141  public:
145  int nxs;
147  int seq_size;
152  };
155  public:
159  int seq_size;
162  };
163 
165  template<class View>
166  class SymmetryImp {
167  public:
169  virtual ArgArray<Literal> symmetric(Literal, const ViewArray<View>&) const = 0;
171  virtual void update(Literal) = 0;
173  virtual SymmetryImp<View>* copy(Space& home, bool share) const = 0;
175  virtual size_t dispose(Space& home) = 0;
177  static void* operator new(size_t s, Space& home);
179  static void operator delete(void*,Space&);
181  static void operator delete(void*);
182  };
184  template <class View>
185  class VariableSymmetryImp : public SymmetryImp<View> {
186  protected:
189  public:
191  VariableSymmetryImp<View>(Space& home, int* vs, unsigned int n);
195  virtual size_t dispose(Space& home);
197  void update(Literal);
199  virtual ArgArray<Literal> symmetric(Literal, const ViewArray<View>&) const;
201  SymmetryImp<View>* copy(Space& home, bool share) const;
202  };
204  template <class View>
205  class ValueSymmetryImp : public SymmetryImp<View>
206  {
207  public:
211  ValueSymmetryImp<View>(Space& home, int* vs, unsigned int n);
215  virtual size_t dispose(Space& home);
217  void update(Literal);
219  virtual ArgArray<Literal> symmetric(Literal, const ViewArray<View>&) const;
221  SymmetryImp<View>* copy(Space& home, bool share) const;
222  };
224  template <class View>
226  {
227  protected:
229  unsigned int *indices;
231  unsigned int n_indices;
233  unsigned int seq_size;
235  unsigned int n_seqs;
236 
238  // e.g. lookup[2] == 10 indicates that the variable with index 2
239  // occurs at position 10 in the "indices" array.
240  // If a variable occurs more than once, only the first occurrence
241  // is recorded.
242  // A value of -1 indicates that the variable does not occur in
243  // "indices".
244  int *lookup;
246  unsigned int lookup_size;
247 
250  int getVal(unsigned int sequence, unsigned int position) const;
251  public:
253  VariableSequenceSymmetryImp<View>(Space& home, int *_indices, unsigned int n, unsigned int seqsize);
257  virtual size_t dispose(Space& home);
259  void update(Literal);
261  virtual ArgArray<Literal> symmetric(Literal, const ViewArray<View>&) const;
263  SymmetryImp<View>* copy(Space& home, bool share) const;
264  };
266  template <class View>
268  {
269  protected:
271  int *values;
273  unsigned int n_values;
275  unsigned int seq_size;
277  unsigned int n_seqs;
282  int getVal(unsigned int sequence, unsigned int position) const;
283  private:
285  public:
287  ValueSequenceSymmetryImp<View>(Space& home, int* _values, unsigned int n, unsigned int seqsize);
291  virtual size_t dispose(Space& home);
293  void update(Literal);
295  virtual ArgArray<Literal> symmetric(Literal, const ViewArray<View>&) const;
297  SymmetryImp<View>* copy(Space& home, bool share) const;
298  };
299 
302  template<class Val>
304  private:
306  const Literal * const _literals;
308  const int _nliterals;
309  public:
312  LDSBChoice(const Brancher& b, unsigned int a, const Pos& p, const Val& n,
313  const Literal* literals, int nliterals);
315  ~LDSBChoice(void);
317  const Literal* literals(void) const;
319  int nliterals(void) const;
321  virtual size_t size(void) const;
323  virtual void archive(Archive& e) const;
324  };
325 
334  template<class View, int n, class Val, unsigned int a>
335  class LDSBBrancher : public ViewValBrancher<View,n,Val,a> {
336  typedef typename ViewBrancher<View,n>::BranchFilter BranchFilter;
337  public:
341  int _nsyms;
342  // Position of variable that last choice was created for
343  int _prevPos;
344  protected:
346  typedef void (*VarValPrint)(const Space& home, const BrancherHandle& bh,
347  unsigned int b,
348  typename View::VarType x, int i,
349  const Val& m,
350  std::ostream& o);
352  LDSBBrancher(Space& home, bool share, LDSBBrancher& b);
354  LDSBBrancher(Home home,
355  ViewArray<View>& x,
356  ViewSel<View>* vs[n],
358  SymmetryImp<View>** syms, int nsyms,
359  BranchFilter bf,
360  VarValPrint vvp);
361  public:
363  virtual const Choice* choice(Space& home);
365  virtual const Choice* choice(const Space& home, Archive& e);
367  virtual ExecStatus commit(Space& home, const Choice& c, unsigned int b);
369  virtual Actor* copy(Space& home, bool share);
371  virtual size_t dispose(Space& home);
373  static BrancherHandle post(Home home,
374  ViewArray<View>& x,
375  ViewSel<View>* vs[n],
377  SymmetryImp<View>** syms,
378  int nsyms,
379  BranchFilter bf,
380  VarValPrint vvp);
381  };
382 
384  template<class View>
385  ModEvent prune(Space& home, View x, int v);
386 
387 }}}
388 
391 
392 #endif
393 
394 // STATISTICS: int-branch
395 
Int::LDSB::Literal ValueType
Definition: ldsb.hh:103
ValSelCommitBase< View, Val > * vsc
Value selection and commit object.
virtual size_t dispose(Space &home)
Disposal.
Definition: sym-imp.hpp:222
int _nsyms
Number of symmetry implementations.
Definition: ldsb.hh:341
VarImpBase ** xs
Array of variables in symmetry.
Definition: ldsb.hh:123
BranchFilter bf
Branch filter function.
unsigned int n_indices
Total number of indices (n_seqs * seq_size)
Definition: ldsb.hh:231
IntSet values
Set of symmetric values.
Definition: ldsb.hh:135
A Literal is a pair of variable index and value.
Definition: ldsb.hh:50
unsigned int lookup_size
Size of lookup.
Definition: ldsb.hh:246
IntArgs values
Array of values in symmetry.
Definition: ldsb.hh:157
std::pair< int, int > findVar(int *indices, unsigned int n_values, unsigned int seq_size, int index)
Find the location of an integer in a collection of sequences.
Definition: ldsb.cpp:46
Implementation of a value symmetry at the modelling level.
Definition: ldsb.hh:132
bool operator<(const Literal &rhs) const
Less than. The ordering is the lexicographical order on the (variable,value) pair.
Definition: brancher.hpp:53
int getVal(unsigned int sequence, unsigned int position) const
Get the value in the specified sequence at the specified position. (Both are zero-based.)
Definition: sym-imp.hpp:179
Implementation of a value sequence symmetry at the modelling level.
Definition: ldsb.hh:154
Handle for brancher.
Definition: core.hpp:1157
virtual Actor * copy(Space &home, bool share)
Perform cloning.
Definition: brancher.hpp:141
BranchTraits< typename View::VarType >::Filter BranchFilter
The branch filter that corresponds to the var type.
int ModEvent
Type for modification events.
Definition: core.hpp:146
Implementation of a symmetry at the modelling level.
Definition: ldsb.hh:110
Implementation of a variable sequence symmetry.
Definition: ldsb.hh:225
virtual const Choice * choice(Space &home)
Return choice.
Definition: brancher.hpp:149
SymmetryImp< View > * copy(Space &home, bool share) const
Copy function.
Definition: sym-imp.hpp:354
Support::BitSetOffset< Space > values
Symmetric values.
Definition: ldsb.hh:209
int * lookup
Map from variable's index to its sequence and position.
Definition: ldsb.hh:244
int _value
The value of the literal. For int and bool variables, this is the value itself; for set variables...
Definition: ldsb.hh:63
Base-class for variable implementations.
Definition: core.hpp:243
int _variable
Variable index. The ViewArray that the index is meant for is assumed to be known by context...
Definition: ldsb.hh:59
Computation spaces.
Definition: core.hpp:1362
SymmetryImp< View > ** _syms
Array of symmetry implementations.
Definition: ldsb.hh:339
Base-class for both propagators and branchers.
Definition: core.hpp:666
int nxs
Number of variables in symmetry.
Definition: ldsb.hh:145
ArgArray< Int::LDSB::Literal > LiteralArgs
An array of literals.
Definition: ldsb.hh:97
void sequence(Home home, const IntVarArgs &x, const IntSet &s, int q, int l, int u, IntConLevel)
Post propagator for .
Definition: sequence.cpp:51
Gecode::FloatVal c(-8, 8)
virtual ArgArray< Literal > symmetric(Literal, const ViewArray< View > &) const
Compute symmetric literals.
int p
Number of positive literals for node type.
Definition: bool-expr.cpp:236
Choice storing position and value, and symmetric literals to be excluded on the right branch...
Definition: ldsb.hh:303
Gecode::IntArgs i(4, 1, 2, 3, 4)
Base-class for branchers.
Definition: core.hpp:1071
virtual ArgArray< Literal > symmetric(Literal, const ViewArray< View > &) const
Compute symmetric literals.
int n
Number of negative literals for node type.
Definition: bool-expr.cpp:238
unsigned int n_seqs
Number of sequences in symmetry.
Definition: ldsb.hh:277
Argument array for non-primitive types.
Definition: array.hpp:727
virtual size_t dispose(Space &home)
Disposal.
Definition: sym-imp.hpp:323
virtual size_t dispose(Space &home)=0
Disposal.
virtual size_t dispose(Space &home)
Delete brancher and return its size.
Definition: brancher.hpp:262
unsigned int * indices
Array of variable indices.
Definition: ldsb.hh:229
Generic brancher by view and value selection.
Literal(void)
Constructor for an empty literal.
Definition: brancher.hpp:44
ModEvent prune(Space &home, View x, int v)
Exclude value from variable view .
Implementation of a variable symmetry at the modelling level.
Definition: ldsb.hh:120
int getVal(unsigned int sequence, unsigned int position) const
Get the value in the specified sequence at the specified position. (Both are zero-based.)
Definition: sym-imp.hpp:292
Implementation of a value symmetry.
Definition: ldsb.hh:205
virtual SymmetryImp< View > * copy(Space &home, bool share) const =0
Copy function.
ViewSel< View > * vs[n]
View selection objects.
unsigned int size(I &i)
Size of all ranges of range iterator i.
unsigned int seq_size
Size of each sequence in symmetry.
Definition: ldsb.hh:233
ArgArray< VarImpBase * > ArgsType
Definition: ldsb.hh:93
int nxs
Number of variables in symmetry.
Definition: ldsb.hh:125
Support::BitSet< Space > dead_sequences
Which sequences are dead.
Definition: ldsb.hh:279
virtual size_t dispose(Space &home)
Disposal.
Definition: sym-imp.hpp:153
int seq_size
Size of each sequence in symmetry.
Definition: ldsb.hh:147
Symmetry-breaking brancher with generic view and value selection.
Definition: ldsb.hh:335
Implementation of a variable sequence symmetry at the modelling level.
Definition: ldsb.hh:140
VarValPrint vvp
Print function.
Support::BitSetOffset< Space > indices
Symmetric variable indices.
Definition: ldsb.hh:188
Integer sets.
Definition: int.hh:171
VarImpBase ** xs
Array of variables in symmetry.
Definition: ldsb.hh:143
Position information.
View arrays.
Definition: array.hpp:234
int seq_size
Size of each sequence in symmetry.
Definition: ldsb.hh:159
virtual void update(Literal)=0
Left-branch update.
Passing integer arguments.
Definition: int.hh:607
unsigned int seq_size
Size of each sequence in symmetry.
Definition: ldsb.hh:275
void(* VarValPrint)(const Space &home, const BrancherHandle &bh, unsigned int b, typename View::VarType x, int i, const Val &m, std::ostream &o)
Function type for printing variable and value selection.
Definition: ldsb.hh:346
double position(const Space &home, IntVar x, int i)
Definition: ldsb.cpp:1277
const int v[7]
Definition: distinct.cpp:207
BrancherHandle bh
unsigned int n_values
Total number of values (n_seqs * seq_size)
Definition: ldsb.hh:273
virtual ArgArray< Literal > symmetric(Literal, const ViewArray< View > &) const
Compute symmetric literals.
Implementation of a single symmetry.
Definition: ldsb.hh:166
void update(Literal)
Left-branch update.
Definition: sym-imp.hpp:161
Node * x
Pointer to corresponding Boolean expression node.
Definition: bool-expr.cpp:253
Choice for performing commit
Definition: core.hpp:1036
Archive representation
Definition: archive.hpp:45
ExecStatus
Definition: core.hpp:523
Implementation of a variable symmetry.
Definition: ldsb.hh:185
virtual ArgArray< Literal > symmetric(Literal, const ViewArray< View > &) const
Compute symmetric literals.
Definition: sym-imp.hpp:232
Simple bitsets.
Definition: bitset.hpp:49
static BrancherHandle post(Home home, ViewArray< View > &x, ViewSel< View > *vs[n], ValSelCommitBase< View, Val > *vsc, SymmetryImp< View > **syms, int nsyms, BranchFilter bf, VarValPrint vvp)
Brancher post function.
Definition: brancher.hpp:120
void update(Literal)
Left-branch update.
Definition: sym-imp.hpp:105
SymmetryImp< View > * copy(Space &home, bool share) const
Copy function.
Definition: sym-imp.hpp:169
Implementation of a value sequence symmetry.
Definition: ldsb.hh:267
Traits of arrays in Gecode.
Definition: array.hpp:68
LDSBBrancher(Space &home, bool share, LDSBBrancher &b)
Constructor for cloning b.
Definition: brancher.hpp:130
struct Gecode::@518::NNF::@57::@58 b
For binary nodes (and, or, eqv)
unsigned int n_seqs
Number of sequences in symmetry.
Definition: ldsb.hh:235
void update(Literal)
Search left-branch update.
Definition: sym-imp.hpp:275
Gecode toplevel namespace
SymmetryImp< View > * copy(Space &home, bool share) const
Copy function.
Definition: sym-imp.hpp:114
#define GECODE_VTABLE_EXPORT
Definition: support.hh:76
virtual ArgArray< Literal > symmetric(Literal, const ViewArray< View > &) const =0
Compute symmetric literals.
#define GECODE_INT_EXPORT
Definition: int.hh:78
ArgArray< VarImpBase * > StorageType
Definition: ldsb.hh:91
virtual size_t dispose(Space &home)
Disposal.
Definition: sym-imp.hpp:97
virtual ExecStatus commit(Space &home, const Choice &c, unsigned int b)
Perform commit for choice c and alternative b.
Definition: brancher.hpp:230
ViewArray< View > x
Views to branch on.
Home class for posting propagators
Definition: core.hpp:717
SymmetryImp< View > * copy(Space &home, bool share) const
Copy function.
Definition: sym-imp.hpp:283
Choice storing position and value
int nrefs
Number of references that point to this symmetry object.
Definition: ldsb.hh:113
struct Gecode::@518::NNF::@57::@59 a
For atomic nodes.
void update(Literal)
Left-branch update.
Definition: sym-imp.hpp:331
Bitsets with index offset.
int * values
Set of sequences.
Definition: ldsb.hh:271