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

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

Protected Member Functions
virtual GUM_SCALAR &	get_ (const Instantiation &i) const =0
	Return a data, given a Instantiation.
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.

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_SCALAR The type of the scalar stored in this multidimensional matrix.

Definition at line 113 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 65 of file multiDimContainer_tpl.h.

                                                            : MultiDimAdressable() {
    GUM_CONSTRUCTOR(MultiDimContainer);
  }

References gum::MultiDimAdressable::MultiDimAdressable(), and MultiDimContainer().

Here is the call graph for this function:

◆ MultiDimContainer() [2/3]

template<typename GUM_SCALAR>

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

Copy constructor.

Parameters

src	The MultiDimContainer to copy.

Definition at line 71 of file multiDimContainer_tpl.h.

                                                  : MultiDimAdressable(src) {
    GUM_CONS_CPY(MultiDimContainer);
  }

References gum::MultiDimAdressable::MultiDimAdressable(), and MultiDimContainer().

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 58 of file multiDimContainer_tpl.h.

                                                                                               :
      MultiDimAdressable(std::forward< MultiDimAdressable >(from)) {
    GUM_CONS_MOV(MultiDimContainer);
  }

References gum::MultiDimAdressable::MultiDimAdressable(), and MultiDimContainer().

Here is the call graph for this function:

◆ ~MultiDimContainer()

template<typename GUM_SCALAR>

INLINE gum::MultiDimContainer< GUM_SCALAR >::~MultiDimContainer ( )

virtual

Destructor.

Definition at line 94 of file multiDimContainer_tpl.h.

                                                             {
    GUM_DESTRUCTOR(MultiDimContainer);
  }

References MultiDimContainer().

Here is the call graph for this function:

Member Function Documentation

◆ 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

v	The new var.

Exceptions

DuplicateElement	Raised if the variable already belongs to the sequence of variables.
OperationNotAllowed	Raised if this object is non mutable.

Referenced by gum::operator<<().

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

f	the function to apply

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

Definition at line 205 of file multiDimContainer_tpl.h.

                                                                                           {
    Instantiation i(*this);
    for (i.setFirst(); !i.end(); ++i) {
      set(i, f(get(i)));
    }
  }

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

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.

Referenced by copy(), and extractFrom().

Here is the caller graph for this function:

◆ changeNotification()

virtual void gum::MultiDimAdressable::changeNotification	(	const Instantiation &	i,
		const DiscreteVariable *const	var,
		Idx	oldval,
		Idx	newval )

pure virtualinherited

Listen to changes in a given Instantiation.

Parameters

i	The Instantiation to listen.
var	The changed dim.
oldval	The old value.
newval	The changed value.

◆ contains()

virtual bool gum::MultiDimInterface::contains ( const DiscreteVariable & v ) const

pure virtualinherited

Returns true if var is in *this.

Parameters

v	A DiscreteVariable.

Returns: Returns true if var is in *this.

Referenced by replace().

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).

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

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::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR > *(*)(const MultiDimImplementation< GUM_SCALAR > *, const HashTable< const DiscreteVariable *, Idx > &), gum::MultiDimImplementation< GUM_SCALAR > *(*)(const MultiDimImplementation< GUM_SCALAR > *, const MultiDimImplementation< GUM_SCALAR > *), and gum::VariableSet &)< GUM_SCALAR >.

References gum::MultiDimAdressable::MultiDimAdressable(), and MultiDimContainer().

Here is the call graph for this function:

◆ 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

src	The MultiDimContainer to copy.

Reimplemented in gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< bool >, gum::MultiDimFunctionGraph< bool, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< double >, gum::MultiDimFunctionGraph< double, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< gum::ActionSet, gum::SetTerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< Size >, and gum::MultiDimFunctionGraph< Size, ExactTerminalNodePolicy >.

Definition at line 288 of file multiDimContainer_tpl.h.

                                                                                       {
    this->beginMultipleChanges();
 
    Size nbr = this->nbrDim();
 
    for (Idx i = 0; i < nbr; i++) {
      this->erase(this->variable(0));
    }
 
    for (Idx i = 0; i < src.nbrDim(); i++) {
      this->add(src.variable(i));
    }
 
    this->endMultipleChanges();
    this->copyFrom(src);
  }

References MultiDimContainer(), beginMultipleChanges(), gum::MultiDimInterface::erase(), gum::MultiDimInterface::nbrDim(), and gum::MultiDimInterface::variable().

Referenced by gum::TreeRegress< GUM_SCALAR, COMBINEOPERATOR, PROJECTOPERATOR, TerminalNodePolicy >::compute().

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

src	The MultiDimContainer src which values are copied. This is a full copy with no verification of dimensions.

Exceptions

OperationNotAllowed Raised if src does not have the same domain size than this MultiDimContainer.

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

Definition at line 271 of file multiDimContainer_tpl.h.

                                                                                                 {
    if (src.domainSize() != domainSize()) {
      GUM_ERROR(OperationNotAllowed,
                "Domain sizes do not fit : " << src.domainSize() << "!=" << domainSize());
    }
 
    Instantiation i_dest(*this);
    Instantiation i_src(src);
 
    for (i_dest.setFirst(), i_src.setFirst(); !i_dest.end(); ++i_dest, ++i_src) {
      set(i_dest, src[i_src]);
    }
  }

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

Referenced by gum::aggregator::MultiDimAggregator< GUM_SCALAR >::copyFrom(), gum::MultiDimArray< GUM_SCALAR >::copyFrom(), and gum::MultiDimICIModel< GUM_SCALAR >::copyFrom().

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

src	The MultiDimContainer src which values are copied.
p_i	Give the order to iterate in this MultiDimContainer during the copy (nullptr will correctly copy if this is a reorganization of src).

Exceptions

OperationNotAllowed Raised if src does not have the same domain size than this MultiDimContainer.

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

Definition at line 225 of file multiDimContainer_tpl.h.

                                                                                                   {
    if (src.domainSize() != domainSize()) {
      GUM_ERROR(OperationNotAllowed,
                "Domain sizes do not fit : " << src.domainSize() << "!=" << domainSize());
    }
 
    if (p_i == nullptr) {   // if null, we just follow the same order
      Instantiation i(src);
      for (i.setFirst(); !i.end(); ++i) {
        set(i, src[i]);
      }
    } else {
      Instantiation i_dest(*this);
      Instantiation i_src(src);
      for (i_dest.setFirst(), i_src.setFirst(); !i_dest.end(); i_dest.incIn(*p_i), ++i_src) {
        set(i_dest, src[i_src]);
      }
    }
  }

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

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.

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

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.

Referenced by gum::Tensor< GUM_SCALAR >::Tensor().

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.

◆ 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 >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR > *(*)(const MultiDimImplementation< GUM_SCALAR > *, const HashTable< const DiscreteVariable *, Idx > &), gum::MultiDimImplementation< GUM_SCALAR > *(*)(const MultiDimImplementation< GUM_SCALAR > *, const MultiDimImplementation< GUM_SCALAR > *), and gum::VariableSet &)< GUM_SCALAR >.

◆ erase()

virtual void gum::MultiDimInterface::erase ( const DiscreteVariable & v )

pure virtualinherited

Removes a var from the variables of the multidimensional matrix.

See also: operator>>(MultiDimInterface& c, const DiscreteVariable& v)

Exceptions

OperationNotAllowed	Raised if this object is non mutable.
NotFound	Raised if v does not belong to this.

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

Here is the caller graph for this function:

◆ 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

src	The MultiDimContainer src which datas are copied.
mask	partial instantiation of variables of the Tensor : the

extraction will concern every variable not in the instantiation and the copy of data will use the (relevant) values in this instantiation.

Definition at line 247 of file multiDimContainer_tpl.h.

                                                                                                  {
    this->beginMultipleChanges();
 
    Size nbr = this->nbrDim();
    for (Idx i = 0; i < nbr; i++) {
      this->erase(this->variable(0));
    }
 
    for (Idx i = 0; i < src.nbrDim(); i++) {
      if (!imask.contains(src.variable(i))) this->add(src.variable(i));
    }
 
    this->endMultipleChanges();
 
    if (this->nbrDim() == 0) { GUM_ERROR(FatalError, "Empty tensor") }
 
    Instantiation inst(src);
    inst.setVals(imask);
    for (inst.setFirstOut(imask); !inst.end(); inst.incOut(imask))
      set(inst, src[inst]);
  }

References MultiDimContainer(), and beginMultipleChanges().

Here is the call graph for this function:

◆ fill()

template<typename GUM_SCALAR>

virtual void gum::MultiDimContainer< GUM_SCALAR >::fill ( const GUM_SCALAR & d ) const

pure virtual

Fill the table with d.

Parameters

d	The value used to fill this MultiDimContainer.

Implemented in gum::MultiDimArray< GUM_SCALAR >, gum::MultiDimBijArray< GUM_SCALAR >, gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< bool >, gum::MultiDimFunctionGraph< double >, gum::MultiDimFunctionGraph< gum::ActionSet, gum::SetTerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >, gum::MultiDimFunctionGraph< Size >, gum::MultiDimReadOnly< GUM_SCALAR >, gum::MultiDimSparse< GUM_SCALAR >, and gum::MultiDimWithOffset< GUM_SCALAR >.

References MultiDimContainer().

Here is the call graph for this function:

◆ 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

i	An Instantiation of this MultiDimContainer.

Returns: Returns the value pointe by i.

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

Definition at line 116 of file multiDimContainer_tpl.h.

                                                                                     {
    return get_(i);
  }

References get_().

Referenced by apply(), operator[](), reduce(), and gum::MultiDimContainer< double >::set().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get_()

template<typename GUM_SCALAR>

virtual GUM_SCALAR & gum::MultiDimContainer< GUM_SCALAR >::get_ ( const Instantiation & i ) const

protectedpure virtual

Return a data, given a Instantiation.

Note that get allows to change a value in the container. The method is tagged as const since a multidim is not const if its dimension changed.

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

i	The instantiation used to find the data.

Referenced by get(), and set().

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 306 of file multiDimContainer_tpl.h.

                                                                           {
    return static_cast< MultiDimAdressable& >(*content());
  }

References gum::MultiDimAdressable::MultiDimAdressable(), and content().

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 311 of file multiDimContainer_tpl.h.

                                                                                       {
    return static_cast< const MultiDimAdressable& >(*content());
  }

References gum::MultiDimAdressable::MultiDimAdressable(), and content().

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.

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

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();

gum::MultiDimArray::newFactory

virtual MultiDimContainer< GUM_SCALAR > * newFactory() const

Default constructor.

Definition multiDimArray_tpl.h:189

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.

References MultiDimContainer().

Here is the call graph for this function:

◆ 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

p	The MultiDimContainer to test for inequality.

Returns: Returns true if this MultiDimContainer is different of p.

Definition at line 171 of file multiDimContainer_tpl.h.

                                                                                              {
    return !operator==(p);
  }

References MultiDimContainer().

Here is the call 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 78 of file multiDimContainer_tpl.h.

                                                                                             {
    MultiDimAdressable::operator=(from);
    return *this;
  }

References MultiDimContainer(), and gum::MultiDimAdressable::operator=().

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

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 85 of file multiDimContainer_tpl.h.

                                                                                        {
    GUM_OP_MOV(MultiDimContainer);
    MultiDimAdressable::operator=(std::forward< MultiDimAdressable >(from));
    return *this;
  }

References MultiDimContainer(), and gum::MultiDimAdressable::operator=().

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

p	The MultiDimContainer to test for equality.

Returns: Returns true if this MultiDimContainer is equal to p.

Definition at line 146 of file multiDimContainer_tpl.h.

                                                                                               {
    if ((nbrDim() == p.nbrDim()) && (domainSize() == p.domainSize())) {
      if (nbrDim() == 0) return true;
 
      for (auto iter = variablesSequence().beginSafe(); iter != variablesSequence().endSafe();
           ++iter) {
        if (!p.variablesSequence().exists(*iter)) { return false; }
      }
    } else {
      return false;
    }
 
    Instantiation                 i(*this);
    AlmostDifferent< GUM_SCALAR > cmp;
    for (i.setFirst(); !i.end(); ++i) {
      if (cmp(get(i), p.get(i))) { return false; }
    }
 
    return true;
  }

References MultiDimContainer(), gum::MultiDimInterface::domainSize(), gum::MultiDimInterface::nbrDim(), and gum::MultiDimInterface::variablesSequence().

Here is the call 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

i	An Instantiation.

Returns: Returns the adressed (GUM_SCALAR) value.

Definition at line 101 of file multiDimContainer_tpl.h.

                                                                                            {
    return get(i);
  }

References get().

Here is the call 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

v	Vector of values.

Exceptions

SizeError Raised if v size's does not matches this MultiDimContainer domain size.

Definition at line 177 of file multiDimContainer_tpl.h.

                                                                                       {
    if (domainSize() != v.size()) {
      GUM_ERROR(SizeError, "Sizes do not match : " << domainSize() << "!=" << v.size())
    }
 
    Size cpt = 0;
 
    Instantiation i(*this);
 
    for (i.setFirst(); !i.end(); ++i, ++cpt)
      set(i, v[cpt]);
  }

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

Referenced by gum::prm::PRMFactory< GUM_SCALAR >::setRawCPFByLines().

Here is the call graph for this function:

Here is the caller 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

l	contains the data.

Exceptions

SizeError Raised if l size's does not matches this MultiDimContainer domain size.

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

Definition at line 191 of file multiDimContainer_tpl.h.

                                                                                          {
    if (domainSize() != l.size()) {
      GUM_ERROR(SizeError, "Sizes do not match : " << domainSize() << "!=" << l.size())
    }
 
    Instantiation i(*this);
    // insert all the elements
    for (const auto& elt: l) {
      set(i, elt);
      ++i;
    }
  }

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

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

v	The variable for which the index is returned.

Returns: Returns the index of a variable.

Exceptions

NotFound Raised if v is not in this multidimensional matrix.

◆ 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

f	the function to apply
base	the initial value

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

Definition at line 214 of file multiDimContainer_tpl.h.

                                                                     {
    GUM_SCALAR    tmp = base;
    Instantiation i(*this);
    for (i.setFirst(); !i.end(); ++i) {
      tmp = f(tmp, get(i));
    }
    return tmp;
  }

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

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

i	The Instantiation to enslave.

Returns: Returns true if i becomes a slave of this MultiDimAdressable.

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

x	The variable in this which will be replaced.
y	The variable replacing y.

Exceptions

NotFound	Raised if x does not belong to this MultiDim.
OperationNotAllowed	If y and x are not interchangeable.
DuplicateElement	If y is already in this MultiDim.

Definition at line 56 of file multiDimInterface_inl.h.

                                                                                      {
    if (!contains(x)) { GUM_ERROR(NotFound, "could not find the variable") }
 
    if (contains(y)) { GUM_ERROR(DuplicateElement, "variable " << y << " already in MultiDim") }
 
    if (x.domainSize() != y.domainSize()) {
      GUM_ERROR(OperationNotAllowed, "incompatible variables")
    }
 
    replace_(&x, &y);
  }

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

Here is the call graph for this function:

◆ replace_()

virtual void gum::MultiDimInterface::replace_	(	const DiscreteVariable *	x,
		const DiscreteVariable *	y )

protectedpure virtualinherited

This is called by MultiDimContainer::replace() to proceed with the replacing between x and y.

This is called only when everything have been checked.

Parameters

x	The variable to replace in
y	The second variable to swap.

Referenced by replace().

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

i	An Instantiation of this MultiDimContainer.
value	The new value.

Definition at line 108 of file multiDimContainer_tpl.h.

                                                                                     {
    get_(i) = value;
  }

References get_().

Referenced by apply(), and populate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setChangeNotification()

virtual void gum::MultiDimAdressable::setChangeNotification ( const Instantiation & i )

pure virtualinherited

Listen to an assignment of a value in a Instantiation.

Parameters

i	The Instantiation to listen.

◆ setDecNotification()

virtual void gum::MultiDimAdressable::setDecNotification ( const Instantiation & i )

pure virtualinherited

Listen to increment in each recorded Instantiation.

Parameters

i	The Instantiation to listen.

◆ setFirstNotification()

virtual void gum::MultiDimAdressable::setFirstNotification ( const Instantiation & i )

pure virtualinherited

Listen to setFirst in a given Instantiation.

Parameters

i	The Instantiation to listen.

◆ setIncNotification()

virtual void gum::MultiDimAdressable::setIncNotification ( const Instantiation & i )

pure virtualinherited

Listen to increment in a given Instantiation.

Parameters

i	The Instantiation to listen.

◆ setLastNotification()

virtual void gum::MultiDimAdressable::setLastNotification ( const Instantiation & i )

pure virtualinherited

Listen to setLast in a given Instantiation.

Parameters

i	The Instantiation to listen.

◆ toString() [1/2]

template<typename GUM_SCALAR>

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::aggregator::MultiDimAggregator< GUM_SCALAR >, gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimICIModel< GUM_SCALAR >, gum::MultiDimLogit< GUM_SCALAR >, gum::MultiDimNoisyAND< GUM_SCALAR >, gum::MultiDimNoisyORCompound< GUM_SCALAR >, gum::MultiDimNoisyORNet< GUM_SCALAR >, and gum::Tensor< GUM_SCALAR >.

Definition at line 123 of file multiDimContainer_tpl.h.

                                                            {
    // we create a new instantiation and iterate over it to display the whole
    // content of the array
    if (this->nbrDim() == 0) { return "[]"; }
 
    std::stringstream ss;
    Instantiation     inst(const_cast< MultiDimContainer* >(this));
 
    bool first = true;
 
    for (inst.setFirst(); !inst.end(); ++inst) {
      if (!first) { ss << " /"; }
      first = false;
 
      ss << inst << " :: " << get(inst);
    }
 
    return ss.str();
  }

Referenced by gum::operator<<().

Here is the caller graph for this function:

◆ toString() [2/2]

template<typename GUM_SCALAR>

virtual std::string gum::MultiDimContainer< GUM_SCALAR >::toString ( const Instantiation * i ) const

pure virtual

Display the internal representation of i.

Returns: Returns an internal representation of i.

Implements gum::MultiDimAdressable.

Implemented in gum::aggregator::MultiDimAggregator< GUM_SCALAR >, gum::MultiDimBucket< GUM_SCALAR >, gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimFunctionGraph< GUM_SCALAR, TerminalNodePolicy >, gum::MultiDimFunctionGraph< GUM_SCALAR, ExactTerminalNodePolicy >, gum::MultiDimICIModel< GUM_SCALAR >, and gum::MultiDimWithOffset< GUM_SCALAR >.

References MultiDimContainer().

Here is the call graph for this function:

◆ unregisterSlave()

virtual bool gum::MultiDimAdressable::unregisterSlave ( Instantiation & i )

pure virtualinherited

Unregister i as a slave of this MultiDimAdressable.

Parameters

i	The Instantiation to free.

Returns: Returns true, whatever happens.

Referenced by gum::MultiDimBucket< GUM_SCALAR >::unregisterSlave().

Here is the caller graph for this function:

◆ variable() [1/2]

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

pure virtualinherited

Returns the variable with the name.

Parameters

name	The index of the variable

Returns: Returns the variable qith the name in the tuple. @warging This function is not O(1)

Exceptions

NotFound Raised if the element cannot be found.

Implemented in gum::Instantiation, gum::MultiDimDecorator< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR >, gum::MultiDimImplementation< GUM_SCALAR > *(*)(const MultiDimImplementation< GUM_SCALAR > *, const HashTable< const DiscreteVariable *, Idx > &), gum::MultiDimImplementation< GUM_SCALAR > *(*)(const MultiDimImplementation< GUM_SCALAR > *, const MultiDimImplementation< GUM_SCALAR > *), and gum::VariableSet &)< GUM_SCALAR >.

◆ variable() [2/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

NotFound Raised if i does not reference a variable in this multidimensional matrix.

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

Here is the caller graph for this function:

◆ 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*.

Referenced by gum::Tensor< GUM_SCALAR >::Tensor(), gum::Instantiation::_init_(), gum::MultiDimBucket< GUM_SCALAR >::add(), gum::MultiDimBucket< GUM_SCALAR >::erase(), and gum::MultiDimContainer< GUM_SCALAR >::operator==().

Here is the caller graph for this function:

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

agrum/base/multidim/implementations/multiDimContainer.h
agrum/base/multidim/implementations/multiDimContainer_tpl.h

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ MultiDimContainer() [1/3]

◆ MultiDimContainer() [2/3]

◆ MultiDimContainer() [3/3]

◆ ~MultiDimContainer()

Member Function Documentation

◆ add()

◆ apply()

◆ beginMultipleChanges()

◆ changeNotification()

◆ contains()

◆ content() [1/2]

◆ content() [2/2]

◆ copy()

◆ copyFrom() [1/2]

◆ copyFrom() [2/2]

◆ domainSize()

◆ empty()

◆ endMultipleChanges() [1/2]

◆ endMultipleChanges() [2/2]

◆ erase()

◆ extractFrom()

◆ fill()

◆ get()

◆ get_()

◆ getMasterRef() [1/2]

◆ getMasterRef() [2/2]

◆ nbrDim()

◆ newFactory()

◆ operator!=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ operator[]()

◆ populate() [1/2]

◆ populate() [2/2]

◆ pos()

◆ reduce()

◆ registerSlave()

◆ replace()

◆ replace_()

◆ set()

◆ setChangeNotification()

◆ setDecNotification()

◆ setFirstNotification()

◆ setIncNotification()

◆ setLastNotification()

◆ toString() [1/2]

◆ toString() [2/2]

◆ unregisterSlave()

◆ variable() [1/2]

◆ variable() [2/2]

◆ variablesSequence()