aGrUM  0.16.0
multiDimDecorator.h
Go to the documentation of this file.
1 
29 #ifndef GUM_MULTI_DIM_DECORATOR_H
30 #define GUM_MULTI_DIM_DECORATOR_H
31 
32 #include <agrum/agrum.h>
33 
35 
36 namespace gum {
37 
38  // ===========================================================================
39  // === MULTIDIM DECORATOR ===
40  // ===========================================================================
41 
58  template < typename GUM_SCALAR >
59  class MultiDimDecorator : public MultiDimContainer< GUM_SCALAR > {
60  public:
61  // =========================================================================
63  // =========================================================================
65 
71  GUM_SCALAR empty_value = (GUM_SCALAR)0);
72 
77 
82  operator=(const MultiDimDecorator& from) noexcept;
83 
88 
93 
98 
100  // =========================================================================
102  // =========================================================================
104 
105  virtual Idx nbrDim() const final;
106 
107  virtual Size domainSize() const final;
108 
109  virtual void add(const DiscreteVariable& v) final;
110 
111  virtual void erase(const DiscreteVariable& var) final;
112 
114  variablesSequence() const final;
115  virtual const DiscreteVariable& variable(Idx) const final;
116  virtual const DiscreteVariable& variable(const std::string& name) const final;
117 
118  virtual Idx pos(const DiscreteVariable& var) const final;
119 
120  virtual bool contains(const DiscreteVariable& var) const final;
121 
122  virtual bool empty() const final;
123 
125  // ========================================================================
127  // ========================================================================
129 
130  virtual bool unregisterSlave(Instantiation& i) final;
131 
132  virtual bool registerSlave(Instantiation& i) final;
133 
134  virtual void changeNotification(const Instantiation& i,
135  const DiscreteVariable* const var,
136  Idx oldval,
137  Idx newval) final;
138 
139  virtual void setChangeNotification(const Instantiation& i) final;
140 
141  virtual void setFirstNotification(const Instantiation& i) final;
142 
143  virtual void setLastNotification(const Instantiation& i) final;
144 
145  virtual void setIncNotification(const Instantiation& i) final;
146 
147  virtual void setDecNotification(const Instantiation& i) final;
148 
149  virtual void notifyChange() const final;
150 
152  // =========================================================================
154  // =========================================================================
156 
162  virtual void set(const Instantiation& i, const GUM_SCALAR& value) const final;
163 
169  virtual GUM_SCALAR get(const Instantiation& i) const final;
170 
171  virtual void fill(const GUM_SCALAR& d) const final;
172 
191  virtual void populate(const std::vector< GUM_SCALAR >& v) const final;
192 
197  virtual void apply(std::function< GUM_SCALAR(GUM_SCALAR) > f) const final;
198 
204  virtual GUM_SCALAR
205  reduce(std::function< GUM_SCALAR(GUM_SCALAR, GUM_SCALAR) > f,
206  GUM_SCALAR base) const final;
207 
208  virtual MultiDimDecorator< GUM_SCALAR >* newFactory() const = 0;
209 
210  virtual void beginMultipleChanges() final;
211 
212  virtual void endMultipleChanges() final;
213 
214  virtual void endMultipleChanges(const GUM_SCALAR&) final;
215 
216  virtual const std::string toString(const Instantiation* i) const;
217 
218  virtual const std::string toString() const;
219 
221  // =========================================================================
223  // =========================================================================
225 
226 
230  virtual const MultiDimImplementation< GUM_SCALAR >* content() const final;
231 
236 
238  protected:
239  virtual void _replace(const DiscreteVariable* x, const DiscreteVariable* y);
240 
246 
251 
258  GUM_SCALAR& _get(const Instantiation& i) const final;
259 
264  mutable GUM_SCALAR _empty_value;
265  };
266 
267 } /* namespace gum */
268 
270 
271 #endif /* GUM_MULTI_DIM_DECORATOR_H */
virtual void beginMultipleChanges() final
Default implementation of MultiDimContainer::set().
virtual Idx nbrDim() const final
Returns the number of vars in the multidimensional container.
MultiDimImplementation< GUM_SCALAR > * _content
The true container.
virtual Size domainSize() const final
Returns the product of the variables domain size.
virtual const std::string toString() const
Default implementation of MultiDimContainer::set().
virtual bool unregisterSlave(Instantiation &i) final
Unregister i as a slave of this MultiDimAdressable.
GUM_SCALAR & _get(const Instantiation &i) const final
Return a data, given a Insantiation - final method.
The generic class for storing (ordered) sequences of objects.
Definition: sequence.h:1022
virtual void erase(const DiscreteVariable &var) final
Removes a var from the variables of the multidimensional matrix.
virtual MultiDimDecorator< GUM_SCALAR > * newFactory() const =0
Default implementation of MultiDimContainer::set().
GUM_SCALAR _empty_value
value of the MultiDimDecorator if no dimension.
MultiDimDecorator< GUM_SCALAR > & operator=(const MultiDimDecorator &from) noexcept
copy operator
Base class for discrete random variable.
Copyright 2005-2019 Pierre-Henri WUILLEMIN et Christophe GONZALES (LIP6) {prenom.nom}_at_lip6.fr.
Definition: agrum.h:25
Abstract base class for all multi dimensionnal containers.
virtual void changeNotification(const Instantiation &i, const DiscreteVariable *const var, Idx oldval, Idx newval) final
Listen to changes in a given Instantiation.
virtual void _replace(const DiscreteVariable *x, const DiscreteVariable *y)
This is called by MultiDimContainer::replace() to proceed with the replacing between x and y...
virtual bool empty() const final
Returns true if no var is in *this.
virtual const MultiDimImplementation< GUM_SCALAR > * content() const final
Returns the implementation for this object (may be *this).
virtual void populate(const std::vector< GUM_SCALAR > &v) const final
Automatically fills this MultiDimContainer with the values in v.
virtual void setLastNotification(const Instantiation &i) final
Listen to setLast in a given Instantiation.
MultiDimDecorator(MultiDimImplementation< GUM_SCALAR > *aContent=nullptr, GUM_SCALAR empty_value=(GUM_SCALAR) 0)
Class constructor.
virtual void setFirstNotification(const Instantiation &i) final
Listen to setFirst in a given Instantiation.
virtual void apply(std::function< GUM_SCALAR(GUM_SCALAR) > f) const final
Apply a function on every element of the container.
void _swapContent(MultiDimImplementation< GUM_SCALAR > *aContent) const
protecte method to swap the implementation behind the Potential
virtual bool registerSlave(Instantiation &i) final
Register i as a slave of this MultiDimAdressable.
virtual void endMultipleChanges() final
Default implementation of MultiDimContainer::set().
virtual GUM_SCALAR reduce(std::function< GUM_SCALAR(GUM_SCALAR, GUM_SCALAR) > f, GUM_SCALAR base) const final
compute lfold for this container
virtual void notifyChange() const final
Copyright 2005-2019 Pierre-Henri WUILLEMIN et Christophe GONZALES (LIP6) {prenom.nom}_at_lip6.fr.
virtual const DiscreteVariable & variable(Idx) const final
Returns a const ref to the ith var.
virtual void setIncNotification(const Instantiation &i) final
Listen to increment in a given Instantiation.
virtual void setDecNotification(const Instantiation &i) final
Listen to increment in each recorded Instantiation.
Class for assigning/browsing values to tuples of discrete variables.
Definition: instantiation.h:83
virtual Idx pos(const DiscreteVariable &var) const final
Returns the index of a variable.
Decorator design pattern in order to separate implementations from multidimensional matrix concepts...
virtual void add(const DiscreteVariable &v) final
Adds a new var to the variables of the multidimensional matrix.
<agrum/multidim/multiDimImplementation.h>
Size Idx
Type for indexes.
Definition: types.h:53
virtual void fill(const GUM_SCALAR &d) const final
Default implementation of MultiDimContainer::set().
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition: types.h:48
Copyright 2005-2019 Pierre-Henri WUILLEMIN et Christophe GONZALES (LIP6) {prenom.nom}_at_lip6.fr.
~MultiDimDecorator()
Class destructor.
virtual const Sequence< const DiscreteVariable *> & variablesSequence() const final
Returns a const ref to the sequence of DiscreteVariable*.
virtual void setChangeNotification(const Instantiation &i) final
Listen to an assignment of a value in a Instantiation.
virtual bool contains(const DiscreteVariable &var) const final
Returns true if var is in *this.