aGrUM  0.16.0
gum::MultiDimContainer< GUM_SCALAR > Class Template Referenceabstract

Abstract base class for all multi dimensionnal containers. More...

#include <agrum/multidim/multiDimContainer.h>

+ Inheritance diagram for gum::MultiDimContainer< GUM_SCALAR >:
+ Collaboration diagram for gum::MultiDimContainer< GUM_SCALAR >:

Public Member Functions

Constructors / Destructors
 MultiDimContainer ()
 Default constructor. More...
 
 MultiDimContainer (const MultiDimContainer< GUM_SCALAR > &src)
 Copy constructor. More...
 
MultiDimContaineroperator= (const MultiDimContainer< GUM_SCALAR > &src)
 Default constructor. More...
 
 MultiDimContainer (MultiDimContainer< GUM_SCALAR > &&)
 Class move constructor. More...
 
MultiDimContaineroperator= (MultiDimContainer< GUM_SCALAR > &&src)
 Default constructor. More...
 
virtual ~MultiDimContainer ()
 Destructor. More...
 
Accessors / Modifiers
virtual void set (const Instantiation &i, const GUM_SCALAR &value) const
 Changes the value pointed by i. More...
 
virtual GUM_SCALAR get (const Instantiation &i) const
 Returns the value pointed by i. More...
 
GUM_SCALAR operator[] (const Instantiation &i) const
 An [] operator using a Instantiation as argument. More...
 
virtual void fill (const GUM_SCALAR &d) const =0
 Fill the table with d. More...
 
virtual void populate (const std::vector< GUM_SCALAR > &v) const
 Automatically fills this MultiDimContainer with the values in v. More...
 
virtual void populate (std::initializer_list< GUM_SCALAR > l) const
 Automatically fills this MultiDimContainer with the values in l. More...
 
Copy methods.
virtual void copyFrom (const MultiDimContainer< GUM_SCALAR > &src) const
 Basic copy of a MultiDimContainer. More...
 
virtual void copyFrom (const MultiDimContainer< GUM_SCALAR > &src, Instantiation *p_i) const
 Basic copy of a MultiDimContainer. More...
 
virtual void extractFrom (const MultiDimContainer< GUM_SCALAR > &src, const Instantiation &mask)
 Basic extraction of a MultiDimContainer. More...
 
virtual const MultiDimImplementation< GUM_SCALAR > * content () const =0
 Returns the implementation for this object (may be *this). More...
 
virtual MultiDimImplementation< GUM_SCALAR > * content ()=0
 Returns the implementation for this object (may be *this). More...
 
virtual MultiDimAdressablegetMasterRef ()
 In order to insure the dereference for decorators, we need to virtualize the access to master pointer. More...
 
virtual const MultiDimAdressablegetMasterRef () const
 In order to insure the dereference for decorators, we need to virtualize the access to master pointer. More...
 
virtual void copy (const MultiDimContainer< GUM_SCALAR > &src)
 Removes all variables in this MultiDimContainer and copy the content of src, variables included. More...
 
virtual MultiDimContainer< GUM_SCALAR > * newFactory () const =0
 Creates an empty clone of this MultiDimContainer. More...
 
Various methods.
virtual const std::string toString () const
 Returns a representation of this MultiDimContainer. More...
 
virtual const std::string toString (const Instantiation *i) const =0
 Display the internal representation of i. More...
 
bool operator== (const MultiDimContainer< GUM_SCALAR > &p) const
 Test if this MultiDimContainer is equal to p. More...
 
bool operator!= (const MultiDimContainer< GUM_SCALAR > &p) const
 Test if this MultiDimContainer is different of p. More...
 
virtual void apply (std::function< GUM_SCALAR(GUM_SCALAR) > f) const
 Apply a function on every element of the container. More...
 
virtual GUM_SCALAR reduce (std::function< GUM_SCALAR(GUM_SCALAR, GUM_SCALAR) > f, GUM_SCALAR base) const
 compute lfold for this container More...
 
Fast large modifications in structures.
virtual void beginMultipleChanges ()=0
 Call this method before doing important changes in this MultiDimContainer. More...
 
virtual void endMultipleChanges ()=0
 Call this method after doing important changes in this MultiDimContainer. More...
 
virtual void endMultipleChanges (const GUM_SCALAR &v)=0
 Call this method after doing important changes in this MultiDimContainer. More...
 
Slave management and extension due to slave management
virtual bool registerSlave (Instantiation &i)=0
 Register i as a slave of this MultiDimAdressable. More...
 
virtual bool unregisterSlave (Instantiation &i)=0
 Unregister i as a slave of this MultiDimAdressable. More...
 
virtual void changeNotification (const Instantiation &i, const DiscreteVariable *const var, Idx oldval, Idx newval)=0
 Listen to changes in a given Instantiation. More...
 
virtual void setFirstNotification (const Instantiation &i)=0
 Listen to setFirst in a given Instantiation. More...
 
virtual void setLastNotification (const Instantiation &i)=0
 Listen to setLast in a given Instantiation. More...
 
virtual void setIncNotification (const Instantiation &i)=0
 Listen to increment in a given Instantiation. More...
 
virtual void setDecNotification (const Instantiation &i)=0
 Listen to increment in each recorded Instantiation. More...
 
virtual void setChangeNotification (const Instantiation &i)=0
 Listen to an assignment of a value in a Instantiation. More...
 
Accessors / Modifiers
virtual Idx nbrDim () const =0
 Returns the number of vars in the multidimensional container. More...
 
virtual Size domainSize () const =0
 Returns the product of the variables domain size. More...
 
virtual void add (const DiscreteVariable &v)=0
 Adds a new var to the variables of the multidimensional matrix. More...
 
virtual void erase (const DiscreteVariable &v)=0
 Removes a var from the variables of the multidimensional matrix. More...
 
virtual const Sequence< const DiscreteVariable *> & variablesSequence () const =0
 Returns a const ref to the sequence of DiscreteVariable*. More...
 
virtual const DiscreteVariablevariable (Idx i) const =0
 Returns a const ref to the ith var. More...
 
virtual const DiscreteVariablevariable (const std::string &name) const =0
 Returns the variable with the name. More...
 
virtual Idx pos (const DiscreteVariable &v) const =0
 Returns the index of a variable. More...
 
virtual bool contains (const DiscreteVariable &v) const =0
 Returns true if var is in *this. More...
 
virtual bool empty () const =0
 Returns true if no var is in *this. More...
 
void replace (const DiscreteVariable &x, const DiscreteVariable &y)
 Replace variables in this multidim. More...
 

Protected Member Functions

virtual GUM_SCALAR & _get (const Instantiation &i) const =0
 Return a data, given a Instantiation. More...
 
virtual void _replace (const DiscreteVariable *x, const DiscreteVariable *y)=0
 This is called by MultiDimContainer::replace() to proceed with the replacing between x and y. More...
 

Detailed Description

template<typename GUM_SCALAR>
class gum::MultiDimContainer< GUM_SCALAR >

Abstract base class for all multi dimensionnal containers.

The MultiDimContainer is an abstract base class for all multi dimensionnal container of GUM_SCALAR. Its purpose is to deal with GUM_SCALAR access with no regard to how the storage is done (tree, matrix...).

MultiDimContainer is considered as const if its dimension does not change. Contained values may change even in a const MultiDimContainer :

MultiDimArray<char> t;
LabelizedVariable v( "v" ,"v" , 3);
LabelizedVariable w( "w" ,"w" , 3);
{
t<<v;
Instantiation I( t );I.setFirst();
t[I]='a';
}
{
MultiDimContainer<char>& notconst_t=t;
notconst_t<<w;
Instantiation I( notconst_t );I.setFirst();
notconst_t[I]='b';
}
{
const MultiDimContainer<char>& const_t=t;
Instantiation I( const_t );I.setFirst();
// const_t<<w; : ******************** DOES NOT COMPILE : YOU CANNOT DO THIS
!!!!
const_t[I]='c';
}
Template Parameters
GUM_SCALARThe type of the scalar stored in this multidimensional matrix.

Definition at line 93 of file multiDimContainer.h.

Constructor & Destructor Documentation

◆ MultiDimContainer() [1/3]

template<typename GUM_SCALAR >
INLINE gum::MultiDimContainer< GUM_SCALAR >::MultiDimContainer ( )

Default constructor.

Definition at line 45 of file multiDimContainer_tpl.h.

45  :
47  GUM_CONSTRUCTOR(MultiDimContainer);
48  }
MultiDimContainer()
Default constructor.
MultiDimAdressable()
Default constructor.

◆ MultiDimContainer() [2/3]

template<typename GUM_SCALAR >
INLINE gum::MultiDimContainer< GUM_SCALAR >::MultiDimContainer ( const MultiDimContainer< GUM_SCALAR > &  src)

Copy constructor.

Parameters
srcThe MultiDimContainer to copy.

Definition at line 52 of file multiDimContainer_tpl.h.

References gum::MultiDimContainer< GUM_SCALAR >::operator=().

53  :
54  MultiDimAdressable(src) {
55  GUM_CONS_CPY(MultiDimContainer);
56  }
MultiDimContainer()
Default constructor.
MultiDimAdressable()
Default constructor.
+ Here is the call graph for this function:

◆ MultiDimContainer() [3/3]

template<typename GUM_SCALAR >
INLINE gum::MultiDimContainer< GUM_SCALAR >::MultiDimContainer ( MultiDimContainer< GUM_SCALAR > &&  from)

Class move constructor.

Definition at line 37 of file multiDimContainer_tpl.h.

38  :
39  MultiDimAdressable(std::forward< MultiDimAdressable >(from)) {
40  GUM_CONS_MOV(MultiDimContainer);
41  }
MultiDimContainer()
Default constructor.
MultiDimAdressable()
Default constructor.

◆ ~MultiDimContainer()

template<typename GUM_SCALAR >
INLINE gum::MultiDimContainer< GUM_SCALAR >::~MultiDimContainer ( )
virtual

Destructor.

Definition at line 74 of file multiDimContainer_tpl.h.

References gum::MultiDimContainer< GUM_SCALAR >::operator[]().

74  {
75  GUM_DESTRUCTOR(MultiDimContainer);
76  }
MultiDimContainer()
Default constructor.
+ Here is the call graph for this function:

Member Function Documentation

◆ _get()

template<typename GUM_SCALAR>
virtual GUM_SCALAR& gum::MultiDimContainer< GUM_SCALAR >::_get ( const Instantiation i) const
protectedpure virtual

◆ _replace()

◆ add()

virtual void gum::MultiDimInterface::add ( const DiscreteVariable v)
pure virtualinherited

Adds a new var to the variables of the multidimensional matrix.

See also
operator<<(MultiDimInterface& c, const DiscreteVariable& v)
Warning
Note that the variable passed in argument is not duplicated, that is, only a pointer toward the variable is kept by the MultiDimInterface.
Parameters
vThe new var.
Exceptions
DuplicateElementRaised if the variable already belongs to the sequence of variables.
OperationNotAllowedRaised if this object is non mutable.

Implemented in gum::Instantiation, gum::MultiDimBucket< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< Size >, gum::MultiDimFunctionGraph< double >, gum::MultiDimFunctionGraph< GUM_SCALAR >, gum::MultiDimFunctionGraph< double, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< Size, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< gum::ActionSet, gum::SetTerminalNodePolicy >, gum::MultiDimFunctionGraph< bool >, gum::MultiDimFunctionGraph< bool, ExactTerminalNodePolicy >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, gum::MultiDimArray< GUM_SCALAR >, gum::MultiDimBijArray< GUM_SCALAR >, gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimSparse< GUM_SCALAR >, and gum::MultiDimWithOffset< GUM_SCALAR >.

Referenced by gum::MultiDimContainer< GUM_SCALAR >::copy(), gum::MultiDimContainer< GUM_SCALAR >::extractFrom(), gum::operator<<(), and gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

◆ apply()

template<typename GUM_SCALAR >
void gum::MultiDimContainer< GUM_SCALAR >::apply ( std::function< GUM_SCALAR(GUM_SCALAR) >  f) const
virtual

Apply a function on every element of the container.

Parameters
fthe function to apply

Reimplemented in gum::MultiDimDecorator< GUM_SCALAR >, and gum::MultiDimArray< GUM_SCALAR >.

Definition at line 196 of file multiDimContainer_tpl.h.

References gum::Instantiation::end(), and gum::Instantiation::setFirst().

197  {
198  Instantiation i(*this);
199  for (i.setFirst(); !i.end(); ++i) {
200  set(i, f(get(i)));
201  }
202  }
+ Here is the call graph for this function:

◆ beginMultipleChanges()

template<typename GUM_SCALAR>
virtual void gum::MultiDimContainer< GUM_SCALAR >::beginMultipleChanges ( )
pure virtual

Call this method before doing important changes in this MultiDimContainer.

Warning
Remember to call endMultipleChanges() when you finish your changes.

Implemented in gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, and gum::MultiDimImplementation< std::string >.

Referenced by gum::MultiDimContainer< GUM_SCALAR >::copy(), and gum::MultiDimContainer< GUM_SCALAR >::extractFrom().

+ Here is the caller graph for this function:

◆ changeNotification()

◆ contains()

virtual bool gum::MultiDimInterface::contains ( const DiscreteVariable v) const
pure virtualinherited

Returns true if var is in *this.

Parameters
vA DiscreteVariable.
Returns
Returns true if var is in *this.

Implemented in gum::Instantiation, gum::MultiDimBucket< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::MultiDimInterface::replace(), and gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

◆ content() [1/2]

template<typename GUM_SCALAR>
virtual const MultiDimImplementation< GUM_SCALAR >* gum::MultiDimContainer< GUM_SCALAR >::content ( ) const
pure virtual

Returns the implementation for this object (may be *this).

Implemented in gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::MultiDimContainer< GUM_SCALAR >::getMasterRef(), and gum::Potential< GUM_SCALAR >::Potential().

+ Here is the caller graph for this function:

◆ content() [2/2]

template<typename GUM_SCALAR>
virtual MultiDimImplementation< GUM_SCALAR >* gum::MultiDimContainer< GUM_SCALAR >::content ( )
pure virtual

Returns the implementation for this object (may be *this).

Implemented in gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

◆ copy()

template<typename GUM_SCALAR >
void gum::MultiDimContainer< GUM_SCALAR >::copy ( const MultiDimContainer< GUM_SCALAR > &  src)
virtual

Removes all variables in this MultiDimContainer and copy the content of src, variables included.

Parameters
srcThe MultiDimContainer to copy.

Reimplemented in gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR >, and gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >.

Definition at line 282 of file multiDimContainer_tpl.h.

References gum::MultiDimInterface::add(), gum::MultiDimContainer< GUM_SCALAR >::beginMultipleChanges(), gum::MultiDimContainer< GUM_SCALAR >::copyFrom(), gum::MultiDimContainer< GUM_SCALAR >::endMultipleChanges(), gum::MultiDimInterface::erase(), gum::MultiDimInterface::nbrDim(), and gum::MultiDimInterface::variable().

Referenced by gum::MCBayesNetGenerator< GUM_SCALAR, ICPTGenerator, ICPTDisturber >::__eraseArc(), and gum::MCBayesNetGenerator< GUM_SCALAR, ICPTGenerator, ICPTDisturber >::disturbBN().

283  {
284  this->beginMultipleChanges();
285 
286  Size nbr = this->nbrDim();
287 
288  for (Idx i = 0; i < nbr; i++) {
289  this->erase(this->variable(0));
290  }
291 
292  for (Idx i = 0; i < src.nbrDim(); i++) {
293  this->add(src.variable(i));
294  }
295 
296  this->endMultipleChanges();
297  this->copyFrom(src);
298  }
virtual void endMultipleChanges()=0
Call this method after doing important changes in this MultiDimContainer.
virtual void add(const DiscreteVariable &v)=0
Adds a new var to the variables of the multidimensional matrix.
virtual Idx nbrDim() const =0
Returns the number of vars in the multidimensional container.
virtual const DiscreteVariable & variable(Idx i) const =0
Returns a const ref to the ith var.
virtual void beginMultipleChanges()=0
Call this method before doing important changes in this MultiDimContainer.
virtual void copyFrom(const MultiDimContainer< GUM_SCALAR > &src) const
Basic copy of a MultiDimContainer.
virtual void erase(const DiscreteVariable &v)=0
Removes a var from the variables of the multidimensional matrix.
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition: types.h:48
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ copyFrom() [1/2]

template<typename GUM_SCALAR >
void gum::MultiDimContainer< GUM_SCALAR >::copyFrom ( const MultiDimContainer< GUM_SCALAR > &  src) const
virtual

Basic copy of a MultiDimContainer.

This method is virtual because it should be optimized in certain MultiDimContainer.

Parameters
srcThe MultiDimContainer src which values are copied. This is a full copy with no verification of dimensions.
Exceptions
OperationNotAllowedRaised if src does not have the same domain size than this MultiDimContainer.

Reimplemented in gum::aggregator::MultiDimAggregator< GUM_SCALAR >, gum::MultiDimICIModel< GUM_SCALAR >, and gum::MultiDimArray< GUM_SCALAR >.

Definition at line 265 of file multiDimContainer_tpl.h.

References gum::MultiDimInterface::domainSize(), gum::Instantiation::end(), GUM_ERROR, and gum::Instantiation::setFirst().

Referenced by gum::BayesNet< double >::__copyPotentials(), gum::MultiDimContainer< GUM_SCALAR >::copy(), gum::MultiDimArray< GUM_SCALAR >::copyFrom(), gum::MultiDimICIModel< GUM_SCALAR >::copyFrom(), gum::aggregator::MultiDimAggregator< GUM_SCALAR >::copyFrom(), and gum::Potential< GUM_SCALAR >::reorganize().

266  {
267  if (src.domainSize() != domainSize()) {
268  GUM_ERROR(OperationNotAllowed, "Domain sizes do not fit");
269  }
270 
271  Instantiation i_dest(*this);
272  Instantiation i_src(src);
273 
274  for (i_dest.setFirst(), i_src.setFirst(); !i_dest.end(); ++i_dest, ++i_src) {
275  set(i_dest, src[i_src]);
276  }
277  }
virtual Size domainSize() const =0
Returns the product of the variables domain size.
#define GUM_ERROR(type, msg)
Definition: exceptions.h:55
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ copyFrom() [2/2]

template<typename GUM_SCALAR >
void gum::MultiDimContainer< GUM_SCALAR >::copyFrom ( const MultiDimContainer< GUM_SCALAR > &  src,
Instantiation p_i 
) const
virtual

Basic copy of a MultiDimContainer.

This method is virtual because it should be optimized in certain MultiDimContainer.

Parameters
srcThe MultiDimContainer src which values are copied.
p_iGive the order to iterate in this MultiDimContainer during the copy (nullptr will correctly copy if this is a reorganization of src).
Exceptions
OperationNotAllowedRaised if src does not have the same domain size than this MultiDimContainer.

Reimplemented in gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR >, and gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >.

Definition at line 218 of file multiDimContainer_tpl.h.

References gum::MultiDimInterface::domainSize(), gum::Instantiation::end(), GUM_ERROR, gum::Instantiation::incIn(), and gum::Instantiation::setFirst().

219  {
220  if (src.domainSize() != domainSize()) {
221  GUM_ERROR(OperationNotAllowed, "Domain sizes do not fit");
222  }
223 
224  if (p_i == nullptr) { // if null, we just follow the same order
225  Instantiation i(src);
226  for (i.setFirst(); !i.end(); ++i) {
227  set(i, src[i]);
228  }
229  } else {
230  Instantiation i_dest(*this);
231  Instantiation i_src(src);
232  for (i_dest.setFirst(), i_src.setFirst(); !i_dest.end();
233  i_dest.incIn(*p_i), ++i_src) {
234  set(i_dest, src[i_src]);
235  }
236  }
237  }
virtual Size domainSize() const =0
Returns the product of the variables domain size.
#define GUM_ERROR(type, msg)
Definition: exceptions.h:55
+ Here is the call graph for this function:

◆ domainSize()

virtual Size gum::MultiDimInterface::domainSize ( ) const
pure virtualinherited

Returns the product of the variables domain size.

Returns
Returns the product of the variables domain size.

Implemented in gum::Instantiation, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::MultiDimICIModel< GUM_SCALAR >::copyFrom(), gum::MultiDimContainer< GUM_SCALAR >::copyFrom(), gum::MultiDimContainer< GUM_SCALAR >::operator==(), gum::MultiDimContainer< GUM_SCALAR >::populate(), and gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

◆ empty()

virtual bool gum::MultiDimInterface::empty ( ) const
pure virtualinherited

Returns true if no var is in *this.

Returns
Returns true if no var is in *this.

Implemented in gum::Instantiation, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::Potential< GUM_SCALAR >::Potential(), and gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

◆ endMultipleChanges() [1/2]

template<typename GUM_SCALAR>
virtual void gum::MultiDimContainer< GUM_SCALAR >::endMultipleChanges ( )
pure virtual

Call this method after doing important changes in this MultiDimContainer.

Implemented in gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, and gum::MultiDimImplementation< std::string >.

Referenced by gum::MultiDimContainer< GUM_SCALAR >::copy(), and gum::MultiDimContainer< GUM_SCALAR >::extractFrom().

+ Here is the caller graph for this function:

◆ endMultipleChanges() [2/2]

template<typename GUM_SCALAR>
virtual void gum::MultiDimContainer< GUM_SCALAR >::endMultipleChanges ( const GUM_SCALAR &  v)
pure virtual

Call this method after doing important changes in this MultiDimContainer.

Implemented in gum::MultiDimDecorator< GUM_SCALAR >, and gum::MultiDimImplementation< GUM_SCALAR >.

◆ erase()

virtual void gum::MultiDimInterface::erase ( const DiscreteVariable v)
pure virtualinherited

◆ extractFrom()

template<typename GUM_SCALAR >
void gum::MultiDimContainer< GUM_SCALAR >::extractFrom ( const MultiDimContainer< GUM_SCALAR > &  src,
const Instantiation mask 
)
virtual

Basic extraction of a MultiDimContainer.

This method is virtual because it should be optimized in certain MultiDimContainer.

Parameters
srcThe MultiDimContainer src which datas are copied.
maskpartial instantiation of variables of the Potential : the extraction will concern every variable not in the instantiation and the copy of data will use the values in this instantiation.

Definition at line 240 of file multiDimContainer_tpl.h.

References gum::MultiDimInterface::add(), gum::MultiDimContainer< GUM_SCALAR >::beginMultipleChanges(), gum::Instantiation::contains(), gum::Instantiation::end(), gum::MultiDimContainer< GUM_SCALAR >::endMultipleChanges(), gum::MultiDimInterface::erase(), GUM_ERROR, gum::Instantiation::incOut(), gum::MultiDimInterface::nbrDim(), gum::Instantiation::setFirstOut(), gum::Instantiation::setVals(), and gum::MultiDimInterface::variable().

Referenced by gum::Potential< GUM_SCALAR >::extract().

241  {
242  this->beginMultipleChanges();
243 
244  Size nbr = this->nbrDim();
245 
246  for (Idx i = 0; i < nbr; i++) {
247  this->erase(this->variable(0));
248  }
249 
250  for (Idx i = 0; i < src.nbrDim(); i++) {
251  if (!imask.contains(src.variable(i))) this->add(src.variable(i));
252  }
253 
254  if (this->nbrDim() == 0) { GUM_ERROR(FatalError, "Empty potential"); }
255 
256  this->endMultipleChanges();
257 
258  Instantiation inst(src);
259  inst.setVals(imask);
260  for (inst.setFirstOut(imask); !inst.end(); inst.incOut(imask))
261  set(inst, src[inst]);
262  }
virtual void endMultipleChanges()=0
Call this method after doing important changes in this MultiDimContainer.
virtual void add(const DiscreteVariable &v)=0
Adds a new var to the variables of the multidimensional matrix.
virtual Idx nbrDim() const =0
Returns the number of vars in the multidimensional container.
virtual const DiscreteVariable & variable(Idx i) const =0
Returns a const ref to the ith var.
virtual void beginMultipleChanges()=0
Call this method before doing important changes in this MultiDimContainer.
virtual void erase(const DiscreteVariable &v)=0
Removes a var from the variables of the multidimensional matrix.
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition: types.h:48
#define GUM_ERROR(type, msg)
Definition: exceptions.h:55
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ fill()

◆ get()

template<typename GUM_SCALAR >
INLINE GUM_SCALAR gum::MultiDimContainer< GUM_SCALAR >::get ( const Instantiation i) const
virtual

Returns the value pointed by i.

Warning
If i variables set is disjoint with this MultiDimContainer then 0 is assumed for dimensions (i.e. variables) not present in the instantiation.
Parameters
iAn Instantiation of this MultiDimContainer.
Returns
Returns the value pointe by i.

Reimplemented in gum::MultiDimBucket< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< Size >, gum::MultiDimFunctionGraph< double >, gum::MultiDimFunctionGraph< GUM_SCALAR >, gum::MultiDimFunctionGraph< double, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< Size, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< gum::ActionSet, gum::SetTerminalNodePolicy >, gum::MultiDimFunctionGraph< bool >, gum::MultiDimFunctionGraph< bool, ExactTerminalNodePolicy >, gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimBijArray< GUM_SCALAR >, gum::aggregator::MultiDimAggregator< GUM_SCALAR >, gum::MultiDimNoisyAND< GUM_SCALAR >, gum::MultiDimNoisyORCompound< GUM_SCALAR >, gum::MultiDimNoisyORNet< GUM_SCALAR >, gum::MultiDimLogit< GUM_SCALAR >, and gum::MultiDimSparse< GUM_SCALAR >.

Definition at line 98 of file multiDimContainer_tpl.h.

References gum::MultiDimContainer< GUM_SCALAR >::_get().

Referenced by gum::prm::PRMFormAttribute< GUM_SCALAR >::__fillCpf(), gum::prm::PRMFormAttribute< GUM_SCALAR >::copy(), and gum::MultiDimContainer< GUM_SCALAR >::operator==().

98  {
99  return _get(i);
100  }
virtual GUM_SCALAR & _get(const Instantiation &i) const =0
Return a data, given a Instantiation.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getMasterRef() [1/2]

template<typename GUM_SCALAR >
INLINE MultiDimAdressable & gum::MultiDimContainer< GUM_SCALAR >::getMasterRef ( )
virtual

In order to insure the dereference for decorators, we need to virtualize the access to master pointer.

Returns
Returns the ref to content as MultiDimAdressable&

Implements gum::MultiDimAdressable.

Reimplemented in gum::MultiDimBucket< GUM_SCALAR >.

Definition at line 301 of file multiDimContainer_tpl.h.

References gum::MultiDimContainer< GUM_SCALAR >::content().

301  {
302  return static_cast< MultiDimAdressable& >(*content());
303  }
virtual const MultiDimImplementation< GUM_SCALAR > * content() const =0
Returns the implementation for this object (may be *this).
MultiDimAdressable()
Default constructor.
+ Here is the call graph for this function:

◆ getMasterRef() [2/2]

template<typename GUM_SCALAR >
INLINE const MultiDimAdressable & gum::MultiDimContainer< GUM_SCALAR >::getMasterRef ( ) const
virtual

In order to insure the dereference for decorators, we need to virtualize the access to master pointer.

Returns
Returns the master of this MultiDimAdressable.

Implements gum::MultiDimAdressable.

Reimplemented in gum::MultiDimBucket< GUM_SCALAR >.

Definition at line 307 of file multiDimContainer_tpl.h.

References gum::MultiDimContainer< GUM_SCALAR >::content().

307  {
308  return static_cast< const MultiDimAdressable& >(*content());
309  }
virtual const MultiDimImplementation< GUM_SCALAR > * content() const =0
Returns the implementation for this object (may be *this).
MultiDimAdressable()
Default constructor.
+ Here is the call graph for this function:

◆ nbrDim()

virtual Idx gum::MultiDimInterface::nbrDim ( ) const
pure virtualinherited

Returns the number of vars in the multidimensional container.

Returns
Returns the number of vars in the multidimensional container.

Implemented in gum::Instantiation, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::MultiDimContainer< GUM_SCALAR >::copy(), gum::MultiDimContainer< GUM_SCALAR >::extractFrom(), gum::MultiDimContainer< GUM_SCALAR >::operator==(), gum::MultiDimContainer< GUM_SCALAR >::toString(), and gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

◆ newFactory()

template<typename GUM_SCALAR>
virtual MultiDimContainer< GUM_SCALAR >* gum::MultiDimContainer< GUM_SCALAR >::newFactory ( ) const
pure virtual

Creates an empty clone of this MultiDimContainer.

This method creates a clone of this object, withouth its content (including variable), you must use this method if you want to ensure that the generated object has the same type than the object containing the called newFactory() For example :

MultiDimArray<double> y;
MultiDimContainer<double>* x = y.newFactory();

Then x is a MultiDimArray<double>*.

Warning
You must free by yourself the returned pointer.
Returns
Returns an empty clone of this object with the same type.

Implemented in gum::MultiDimBucket< GUM_SCALAR >, gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, gum::MultiDimBijArray< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< Size >, gum::MultiDimFunctionGraph< double >, gum::MultiDimFunctionGraph< GUM_SCALAR >, gum::MultiDimFunctionGraph< double, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< Size, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< gum::ActionSet, gum::SetTerminalNodePolicy >, gum::MultiDimFunctionGraph< bool >, gum::MultiDimFunctionGraph< bool, ExactTerminalNodePolicy >, gum::Potential< GUM_SCALAR >, gum::aggregator::MultiDimAggregator< GUM_SCALAR >, gum::MultiDimNoisyAND< GUM_SCALAR >, gum::MultiDimNoisyORCompound< GUM_SCALAR >, gum::MultiDimNoisyORNet< GUM_SCALAR >, gum::MultiDimLogit< GUM_SCALAR >, gum::MultiDimArray< GUM_SCALAR >, gum::MultiDimSparse< GUM_SCALAR >, gum::MultiDimWithOffset< GUM_SCALAR >, gum::aggregator::Median< GUM_SCALAR >, gum::aggregator::Amplitude< GUM_SCALAR >, gum::aggregator::Count< GUM_SCALAR >, gum::aggregator::Or< GUM_SCALAR >, gum::aggregator::And< GUM_SCALAR >, gum::aggregator::Forall< GUM_SCALAR >, gum::aggregator::Max< GUM_SCALAR >, gum::aggregator::Exists< GUM_SCALAR >, gum::aggregator::Min< GUM_SCALAR >, and gum::MultiDimReadOnly< GUM_SCALAR >.

◆ operator!=()

template<typename GUM_SCALAR >
INLINE bool gum::MultiDimContainer< GUM_SCALAR >::operator!= ( const MultiDimContainer< GUM_SCALAR > &  p) const

Test if this MultiDimContainer is different of p.

Parameters
pThe MultiDimContainer to test for inequality.
Returns
Returns true if this MultiDimContainer is different of p.

Definition at line 160 of file multiDimContainer_tpl.h.

References gum::MultiDimContainer< GUM_SCALAR >::operator==().

Referenced by gum::MultiDimContainer< GUM_SCALAR >::operator==().

160  {
161  return !operator==(p);
162  }
bool operator==(const MultiDimContainer< GUM_SCALAR > &p) const
Test if this MultiDimContainer is equal to p.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ operator=() [1/2]

template<typename GUM_SCALAR >
INLINE MultiDimContainer< GUM_SCALAR > & gum::MultiDimContainer< GUM_SCALAR >::operator= ( const MultiDimContainer< GUM_SCALAR > &  src)

Default constructor.

Definition at line 59 of file multiDimContainer_tpl.h.

References gum::MultiDimAdressable::operator=().

Referenced by gum::MultiDimContainer< GUM_SCALAR >::MultiDimContainer(), and gum::MultiDimDecorator< GUM_SCALAR >::operator=().

59  {
61  return *this;
62  }
MultiDimAdressable & operator=(const MultiDimAdressable &from)
Default constructor.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ operator=() [2/2]

template<typename GUM_SCALAR >
INLINE MultiDimContainer< GUM_SCALAR > & gum::MultiDimContainer< GUM_SCALAR >::operator= ( MultiDimContainer< GUM_SCALAR > &&  src)

Default constructor.

Definition at line 65 of file multiDimContainer_tpl.h.

References gum::MultiDimAdressable::operator=().

65  {
66  GUM_OP_MOV(MultiDimContainer);
67  MultiDimAdressable::operator=(std::forward< MultiDimAdressable >(from));
68  return *this;
69  }
MultiDimAdressable & operator=(const MultiDimAdressable &from)
Default constructor.
MultiDimContainer()
Default constructor.
+ Here is the call graph for this function:

◆ operator==()

template<typename GUM_SCALAR >
bool gum::MultiDimContainer< GUM_SCALAR >::operator== ( const MultiDimContainer< GUM_SCALAR > &  p) const

Test if this MultiDimContainer is equal to p.

Parameters
pThe MultiDimContainer to test for equality.
Returns
Returns true if this MultiDimContainer is equal to p.

Definition at line 129 of file multiDimContainer_tpl.h.

References gum::MultiDimInterface::domainSize(), gum::Instantiation::end(), gum::MultiDimContainer< GUM_SCALAR >::get(), gum::MultiDimInterface::nbrDim(), gum::MultiDimContainer< GUM_SCALAR >::operator!=(), gum::Instantiation::setFirst(), and gum::MultiDimInterface::variablesSequence().

Referenced by gum::MultiDimContainer< GUM_SCALAR >::operator!=(), and gum::MultiDimContainer< GUM_SCALAR >::toString().

129  {
130  if ((nbrDim() == p.nbrDim()) && (domainSize() == p.domainSize())) {
131  if (nbrDim() == 0) return true;
132 
134  var_iterator;
135 
136  for (var_iterator iter = variablesSequence().beginSafe();
137  iter != variablesSequence().endSafe();
138  ++iter) {
139  if (!p.variablesSequence().exists(*iter)) { return false; }
140  }
141  } else {
142  return false;
143  }
144 
145  Instantiation i(*this);
146 
147  AlmostDifferent< GUM_SCALAR > cmp;
148 
149  for (i.setFirst(); !i.end(); ++i) {
150  if (cmp(get(i), p.get(i))) { return false; }
151  }
152 
153  return true;
154  }
virtual Idx nbrDim() const =0
Returns the number of vars in the multidimensional container.
virtual Size domainSize() const =0
Returns the product of the variables domain size.
virtual const Sequence< const DiscreteVariable *> & variablesSequence() const =0
Returns a const ref to the sequence of DiscreteVariable*.
SequenceIteratorSafe< Key > const_iterator_safe
Types for STL compliance.
Definition: sequence.h:1038
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ operator[]()

template<typename GUM_SCALAR >
INLINE GUM_SCALAR gum::MultiDimContainer< GUM_SCALAR >::operator[] ( const Instantiation i) const

An [] operator using a Instantiation as argument.

Warning
If i variables set is disjoint with this MultiDimContainer then 0 is assumed for dimensions (i.e. variables) not prensent in the instantiation.
Parameters
iAn Instantiation.
Returns
Returns the adressed (GUM_SCALAR) value.

Definition at line 82 of file multiDimContainer_tpl.h.

Referenced by gum::MultiDimContainer< GUM_SCALAR >::~MultiDimContainer().

82  {
83  return get(i);
84  }
+ Here is the caller graph for this function:

◆ populate() [1/2]

template<typename GUM_SCALAR >
void gum::MultiDimContainer< GUM_SCALAR >::populate ( const std::vector< GUM_SCALAR > &  v) const
virtual

Automatically fills this MultiDimContainer with the values in v.

The order used to fill this MultiDimContainer is the same as with an instantiation over it.

Size cpt = 0;
Instantiation i( *this );
for (i.setFirst(); !i.end(); ++i, ++cpt) {
set(i, v[cpt]);
}
Parameters
vVector of values.
Exceptions
SizeErrorRaised if v size's does not matches this MultiDimContainer domain size.

Reimplemented in gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimBijArray< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR >, and gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >.

Definition at line 166 of file multiDimContainer_tpl.h.

References gum::MultiDimInterface::domainSize(), gum::Instantiation::end(), GUM_ERROR, and gum::Instantiation::setFirst().

167  {
168  if (domainSize() != v.size()) {
169  GUM_ERROR(SizeError, "Sizes do not match in populate");
170  }
171 
172  Size cpt = 0;
173 
174  Instantiation i(*this);
175 
176  for (i.setFirst(); !i.end(); ++i, ++cpt)
177  set(i, v[cpt]);
178  }
virtual Size domainSize() const =0
Returns the product of the variables domain size.
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition: types.h:48
#define GUM_ERROR(type, msg)
Definition: exceptions.h:55
+ Here is the call graph for this function:

◆ populate() [2/2]

template<typename GUM_SCALAR >
void gum::MultiDimContainer< GUM_SCALAR >::populate ( std::initializer_list< GUM_SCALAR >  l) const
virtual

Automatically fills this MultiDimContainer with the values in l.

The order used to fill this MultiDimContainer is the same as with an instantiation over it.

Size cpt = 0;
Instantiation i( *this );
for (i.setFirst(); !i.end(); ++i, ++cpt) {
set(i, v[cpt]);
}
Parameters
lcontains the data.
Exceptions
SizeErrorRaised if l size's does not matches this MultiDimContainer domain size.

Reimplemented in gum::MultiDimBijArray< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR >, and gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >.

Definition at line 181 of file multiDimContainer_tpl.h.

References gum::MultiDimInterface::domainSize(), and GUM_ERROR.

182  {
183  if (domainSize() != l.size()) {
184  GUM_ERROR(SizeError, "Sizes do not match in populate");
185  }
186 
187  Instantiation i(*this);
188  // insert all the elements
189  for (const auto& elt : l) {
190  set(i, elt);
191  ++i;
192  }
193  }
virtual Size domainSize() const =0
Returns the product of the variables domain size.
#define GUM_ERROR(type, msg)
Definition: exceptions.h:55
+ Here is the call graph for this function:

◆ pos()

virtual Idx gum::MultiDimInterface::pos ( const DiscreteVariable v) const
pure virtualinherited

Returns the index of a variable.

Parameters
vThe variable for which the index is returned.
Returns
Returns the index of a variable.
Exceptions
NotFoundRaised if v is not in this multidimensional matrix.

Implemented in gum::Instantiation, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

◆ reduce()

template<typename GUM_SCALAR >
GUM_SCALAR gum::MultiDimContainer< GUM_SCALAR >::reduce ( std::function< GUM_SCALAR(GUM_SCALAR, GUM_SCALAR) >  f,
GUM_SCALAR  base 
) const
virtual

compute lfold for this container

Parameters
fthe function to apply
basethe initial value

Reimplemented in gum::MultiDimDecorator< GUM_SCALAR >, and gum::MultiDimArray< GUM_SCALAR >.

Definition at line 205 of file multiDimContainer_tpl.h.

References gum::Instantiation::end(), and gum::Instantiation::setFirst().

207  {
208  GUM_SCALAR tmp = base;
209  Instantiation i(*this);
210  for (i.setFirst(); !i.end(); ++i) {
211  tmp = f(tmp, get(i));
212  }
213  return tmp;
214  }
+ Here is the call graph for this function:

◆ registerSlave()

virtual bool gum::MultiDimAdressable::registerSlave ( Instantiation i)
pure virtualinherited

Register i as a slave of this MultiDimAdressable.

Parameters
iThe Instantiation to enslave.
Returns
Returns true if i becomes a slave of this MultiDimAdressable.

Implemented in gum::MultiDimBucket< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, gum::MultiDimDecorator< GUM_SCALAR >, and gum::MultiDimWithOffset< GUM_SCALAR >.

Referenced by gum::Instantiation::actAsSlave().

+ Here is the caller graph for this function:

◆ replace()

INLINE void gum::MultiDimInterface::replace ( const DiscreteVariable x,
const DiscreteVariable y 
)
inherited

Replace variables in this multidim.

If x is in this MultiDim and y has the same domain size, then x will be replace by y in this MultiDim.

Parameters
xThe variable in this which will be replaced.
yThe variable replacing y.
Exceptions
NotFoundRaised if x does not belong to this MultiDim.
OperationNotAllowedIf y and x are not interchangeable.
DuplicateElementIf y is already in this MultiDim.

Definition at line 36 of file multiDimInterface_inl.h.

References gum::MultiDimInterface::_replace(), gum::MultiDimInterface::contains(), gum::DiscreteVariable::domainSize(), and GUM_ERROR.

Referenced by gum::MultiDimImplementation< std::string >::_replace(), gum::MultiDimBucket< GUM_SCALAR >::_replace(), and gum::MultiDimInterface::~MultiDimInterface().

37  {
38  if (!contains(x)) { GUM_ERROR(NotFound, "could not find the variable"); }
39 
40  if (contains(y)) {
41  GUM_ERROR(DuplicateElement, "variable " << y << " already in MultiDim");
42  }
43 
44  if (x.domainSize() != y.domainSize()) {
45  GUM_ERROR(OperationNotAllowed, "incompatible variables");
46  }
47 
48  _replace(&x, &y);
49  }
virtual bool contains(const DiscreteVariable &v) const =0
Returns true if var is in *this.
virtual void _replace(const DiscreteVariable *x, const DiscreteVariable *y)=0
This is called by MultiDimContainer::replace() to proceed with the replacing between x and y...
#define GUM_ERROR(type, msg)
Definition: exceptions.h:55
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ set()

template<typename GUM_SCALAR >
INLINE void gum::MultiDimContainer< GUM_SCALAR >::set ( const Instantiation i,
const GUM_SCALAR &  value 
) const
virtual

Changes the value pointed by i.

Warning
If i variables set is disjoint with this MultiDimContainer then 0 is assumed for dimensions (i.e. variables) not prensent in the instantiation.
Parameters
iAn Instantiation of this MultiDimContainer.
valueThe new value.

Reimplemented in gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >, gum::MultiDimBijArray< GUM_SCALAR >, gum::MultiDimSparse< GUM_SCALAR >, and gum::MultiDimReadOnly< GUM_SCALAR >.

Definition at line 89 of file multiDimContainer_tpl.h.

References gum::MultiDimContainer< GUM_SCALAR >::_get().

Referenced by gum::prm::PRMFormAttribute< GUM_SCALAR >::_type(), gum::prm::PRMFormAttribute< GUM_SCALAR >::becomeCastDescendant(), gum::prm::PRMFormAttribute< GUM_SCALAR >::copyCpf(), and gum::prm::PRMFormAttribute< GUM_SCALAR >::swap().

90  {
91  _get(i) = value;
92  }
virtual GUM_SCALAR & _get(const Instantiation &i) const =0
Return a data, given a Instantiation.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setChangeNotification()

◆ setDecNotification()

◆ setFirstNotification()

◆ setIncNotification()

◆ setLastNotification()

◆ toString() [1/2]

template<typename GUM_SCALAR >
const std::string gum::MultiDimContainer< GUM_SCALAR >::toString ( ) const
virtual

Returns a representation of this MultiDimContainer.

Returns
Returns a representation of this MultiDimContainer.

Reimplemented in gum::Potential< GUM_SCALAR >, gum::MultiDimDecorator< GUM_SCALAR >, gum::aggregator::MultiDimAggregator< GUM_SCALAR >, gum::MultiDimNoisyAND< GUM_SCALAR >, gum::MultiDimNoisyORCompound< GUM_SCALAR >, gum::MultiDimNoisyORNet< GUM_SCALAR >, gum::MultiDimLogit< GUM_SCALAR >, and gum::MultiDimICIModel< GUM_SCALAR >.

Definition at line 105 of file multiDimContainer_tpl.h.

References gum::Instantiation::end(), gum::MultiDimInterface::nbrDim(), gum::MultiDimContainer< GUM_SCALAR >::operator==(), and gum::Instantiation::setFirst().

Referenced by gum::operator<<().

105  {
106  // we create a new instantiation and iterate over it to display the whole
107  // content of the array
108  if (this->nbrDim() == 0) { return "[]"; }
109 
110  std::stringstream ss;
111  Instantiation inst(const_cast< MultiDimContainer* >(this));
112 
113  bool first = true;
114 
115  for (inst.setFirst(); !inst.end(); ++inst) {
116  if (!first) { ss << " /"; }
117  first = false;
118 
119  ss << inst << " :: " << get(inst);
120  }
121 
122  return ss.str();
123  }
virtual Idx nbrDim() const =0
Returns the number of vars in the multidimensional container.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ toString() [2/2]

◆ unregisterSlave()

virtual bool gum::MultiDimAdressable::unregisterSlave ( Instantiation i)
pure virtualinherited

Unregister i as a slave of this MultiDimAdressable.

Parameters
iThe Instantiation to free.
Returns
Returns true, whatever happens.

Implemented in gum::MultiDimBucket< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, gum::MultiDimDecorator< GUM_SCALAR >, and gum::MultiDimWithOffset< GUM_SCALAR >.

Referenced by gum::Instantiation::forgetMaster(), and gum::Instantiation::~Instantiation().

+ Here is the caller graph for this function:

◆ variable() [1/2]

virtual const DiscreteVariable& gum::MultiDimInterface::variable ( Idx  i) const
pure virtualinherited

Returns a const ref to the ith var.

param i An index of this multidimensional matrix.

Returns
Returns a const ref to the ith var.
Exceptions
NotFoundRaised if i does not reference a variable in this multidimensional matrix.

Implemented in gum::Instantiation, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::MultiDimContainer< GUM_SCALAR >::copy(), gum::MultiDimContainer< GUM_SCALAR >::extractFrom(), and gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

◆ variable() [2/2]

virtual const DiscreteVariable& gum::MultiDimInterface::variable ( const std::string &  name) const
pure virtualinherited

Returns the variable with the name.

Parameters
nameThe index of the variable
Returns
Returns the variable qith the name in the tuple. This function is not O(1)
Exceptions
NotFoundRaised if the element cannot be found.

Implemented in gum::Instantiation, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

◆ variablesSequence()

virtual const Sequence< const DiscreteVariable* >& gum::MultiDimInterface::variablesSequence ( ) const
pure virtualinherited

Returns a const ref to the sequence of DiscreteVariable*.

Returns
Returns a const ref to the sequence of DiscreteVariable*.

Implemented in gum::Instantiation, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< std::string >, and gum::MultiDimDecorator< GUM_SCALAR >.

Referenced by gum::Instantiation::__init(), gum::MultiDimBucket< GUM_SCALAR >::add(), gum::MultiDimBucket< GUM_SCALAR >::erase(), gum::MultiDimContainer< GUM_SCALAR >::operator==(), gum::Potential< GUM_SCALAR >::Potential(), gum::Instantiation::synchronizeWithMaster(), and gum::MultiDimInterface::~MultiDimInterface().

+ Here is the caller graph for this function:

The documentation for this class was generated from the following files: