Generated on Fri Jun 3 2016 12:10:03 for Gecode by doxygen 1.8.11
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
int _nsyms
Number of symmetry implementations.
Definition: ldsb.hh:341
VarImpBase ** xs
Array of variables in symmetry.
Definition: ldsb.hh:123
unsigned int n_indices
Total number of indices (n_seqs * seq_size)
Definition: ldsb.hh:231
void post(Home home, Term *t, int n, FloatRelType frt, FloatVal c)
Post propagator for linear constraint over floats.
Definition: post.cpp:228
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
Implementation of a value sequence symmetry at the modelling level.
Definition: ldsb.hh:154
Handle for brancher.
Definition: core.hpp:1157
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
Support::BitSetOffset< Space > values
Symmetric values.
Definition: ldsb.hh:209
int * lookup
Map from variable&#39;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)
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
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
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
Implementation of a value symmetry.
Definition: ldsb.hh:205
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
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
struct Gecode::@519::NNF::@60::@62 a
For atomic nodes.
Implementation of a variable sequence symmetry at the modelling level.
Definition: ldsb.hh:140
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
Passing integer arguments.
Definition: int.hh:607
unsigned int seq_size
Size of each sequence in symmetry.
Definition: ldsb.hh:275
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
struct Gecode::@519::NNF::@60::@61 b
For binary nodes (and, or, eqv)
Implementation of a single symmetry.
Definition: ldsb.hh:166
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
Simple bitsets.
Definition: bitset.hpp:49
Implementation of a value sequence symmetry.
Definition: ldsb.hh:267
Traits of arrays in Gecode.
Definition: array.hpp:68
unsigned int n_seqs
Number of sequences in symmetry.
Definition: ldsb.hh:235
Gecode toplevel namespace
#define GECODE_VTABLE_EXPORT
Definition: support.hh:76
#define GECODE_INT_EXPORT
Definition: int.hh:78
ArgArray< VarImpBase * > StorageType
Definition: ldsb.hh:91
Home class for posting propagators
Definition: core.hpp:717
Choice storing position and value
int nrefs
Number of references that point to this symmetry object.
Definition: ldsb.hh:113
Bitsets with index offset.
int * values
Set of sequences.
Definition: ldsb.hh:271