An PRMInstance is a Bayesian network fragment defined by a Class and used in a PRMSystem. More...

#include <PRMInstance.h>

Inheritance diagram for gum::prm::PRMInstance< GUM_SCALAR >:

Collaboration diagram for gum::prm::PRMInstance< GUM_SCALAR >:

Classes
class	RefIterator
	Nested class to iterate over PRMReferenceSlot and PRMSlotChain<GUM_SCALAR> instantiations. More...
class	RefConstIterator
	Nested class to iterate over PRMReferenceSlot and PRMSlotChain<GUM_SCALAR> instantiations. More...

Public Member Functions
Constructors & private operators.
	PRMInstance (const std::string &name, PRMClass< GUM_SCALAR > &type)
	Default constructor of an PRMInstance<GUM_SCALAR>.
virtual	~PRMInstance ()
	Destructor.
Getters & setters.
virtual prm_type	obj_type () const
	Returns the PRM type of this object.
PRMClass< GUM_SCALAR > &	type ()
	Returns the type of this instance.
const PRMClass< GUM_SCALAR > &	type () const
	Returns the type of this instance.
bool	exists (NodeId id) const
	Returns true if id matches an PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
bool	exists (const std::string &name) const
	Returns true if name matches an PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
PRMAttribute< GUM_SCALAR > &	get (NodeId id)
	Getter on an PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.
PRMAttribute< GUM_SCALAR > &	get (const std::string &name)
	Given a name returns the related PRMAttribute<GUM_SCALAR>.
const PRMAttribute< GUM_SCALAR > &	get (NodeId id) const
	Getter on an PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.
const PRMAttribute< GUM_SCALAR > &	get (const std::string &name) const
	Given a name returns the related PRMClassElement.
Size	size () const
	Returns the number of attributes in this PRMInstance<GUM_SCALAR>.
Instantiation methods.
void	instantiate ()
	Instantiate all nodes which requires it.
const Bijection< const DiscreteVariable , const DiscreteVariable > &	bijection () const
	Returns a mapping between DiscreteVariable used in this and the ones used in this PRMInstance<GUM_SCALAR>'s Class<GUM_SCALAR>.
Reference handling.
void	add (NodeId id, PRMInstance< GUM_SCALAR > &instance)
	Add an PRMInstance<GUM_SCALAR> to a given PRMReferenceSlot, PRMSlotChain<GUM_SCALAR> or output node.
const PRMInstance< GUM_SCALAR > &	getInstance (NodeId id) const
	Fast access to the first instance in a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>.
const Set< PRMInstance< GUM_SCALAR > * > &	getInstances (NodeId id) const
	Returns the Set of PRMInstance<GUM_SCALAR> referenced by id.
bool	hasRefAttr (NodeId id) const
	Returns true if id has at least one referring PRMAttribute<GUM_SCALAR>.
std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > &	getRefAttr (NodeId id)
	Returns a vector of pairs of refering attributes of id.
const std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > &	getRefAttr (NodeId id) const
	Returns a vector of pairs of refering attributes of id.
Getters & setters.
const std::string &	name () const
	Returns the name of this object.
void	name (const std::string &name)
	Change the name of the PRM Object.
Operators
bool	operator== (const PRMObject &obj) const
	To PRMObject are equal if they have the same name (which is unique).
bool	operator!= (const PRMObject &obj) const
	To PRMObject are equal if they have the same name (which is unique).

Private Member Functions
	PRMInstance (const PRMInstance< GUM_SCALAR > &source)
	Copy constructor.
PRMInstance< GUM_SCALAR > &	operator= (const PRMClass< GUM_SCALAR > &from)
	Copy operator. Don't use it.
Private instantiation methods.
void	_copyAggregates_ (PRMAggregate< GUM_SCALAR > *source)
	Used at construction to instantiate aggregates.
void	_copyAttribute_ (PRMAttribute< GUM_SCALAR > *source)
	Used at construction to instantiate attributes.
void	_doInstantiate_ ()
	Starts this instance instantiations.
void	_instantiateSlotChain_ (PRMSlotChain< GUM_SCALAR > *sc)
	Retrieve all instances referred by sc.
void	_copyAttributeCPF_ (PRMAttribute< GUM_SCALAR > *attr)
	Copy the content of an PRMAttribute<GUM_SCALAR> from its Class<GUM_SCALAR> counterpart.
void	_addReferingInstance_ (PRMSlotChain< GUM_SCALAR > sc, PRMInstance< GUM_SCALAR > i)
	Add this as a referring instance over the attribute pointed by sc in i.

Private Attributes
Private members.
std::string	_name_

Iterators
using	iterator = typename NodeProperty< PRMAttribute< GUM_SCALAR >* >::iterator
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
using	const_iterator = typename NodeProperty< PRMAttribute< GUM_SCALAR >* >::const_iterator
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
using	InvRefIterator
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
using	InvRefConstIterator
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
iterator	begin ()
	Returns an iterator at the begining of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
const iterator &	end ()
	Returns a reference over the iterator at the end of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
const_iterator	begin () const
	Returns an iterator at the beginning of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
const const_iterator &	end () const
	Returns a reference over the iterator at the end of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
RefIterator	begin (NodeId id)
	Returns an iterator at the beginning of the set of PRMInstance<GUM_SCALAR> associated to a given gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR>.
RefConstIterator	begin (NodeId id) const
	Returns an iterator at the beginning of the set of PRMInstance<GUM_SCALAR> associated to a given gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR>.
InvRefIterator	beginInvRef ()
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
const InvRefIterator &	endInvRef ()
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
InvRefConstIterator	beginInvRef () const
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
const InvRefConstIterator &	endInvRef () const
	Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Built-in types.
enum class	prm_type : char { ALL , CLASS , PRM_INTERFACE , CLASS_ELT , TYPE , SYSTEM , INSTANCE }
	Enumeration of the different types of objects handled by a PRM. More...
static std::string	LEFT_CAST ()
	Enumeration of the different types of objects handled by a PRM.
static std::string	RIGHT_CAST ()
	Enumeration of the different types of objects handled by a PRM.
static std::string	enum2str (prm_type type)
	Returns the string representation of a PRMObject.
static INLINE bool	isClass (const PRMObject &obj)
	Returns true if obj_ptr is of type Class.
static INLINE bool	isInterface (const PRMObject &obj)
	Returns true if obj_ptr is of type PRMInterface.
static INLINE bool	isInstance (const PRMObject &obj)
	Returns true if obj_ptr is of type PRMInstance.

Private members.
using	pair = std::pair< PRMInstance< GUM_SCALAR >*, std::string >
	Code alias.
bool	_instantiated_
	True if this instance has been instantiated.
PRMClass< GUM_SCALAR > *	_type_
	The type of this PRMInstance<GUM_SCALAR>.
NodeProperty< PRMAttribute< GUM_SCALAR > * >	_nodeIdMap_
	The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.
NodeProperty< Set< PRMInstance< GUM_SCALAR > * > * >	_referenceMap_
	Mapping between the gum::prm::PRMReferenceSlot and gum::prm::PRMSlotChain<GUM_SCALAR> in type / and the PRMInstance<GUM_SCALAR> associated with it.
NodeProperty< std::vector< pair > * >	_referingAttr_
	The set of pair (instance, attribute) referring an attribute of this instance.
Bijection< const DiscreteVariable , const DiscreteVariable >	_bijection_
	A bijection used for MultiDim handling.

Detailed Description

template<typename GUM_SCALAR>
class gum::prm::PRMInstance< GUM_SCALAR >

An PRMInstance is a Bayesian network fragment defined by a Class and used in a PRMSystem.

Before using an PRMInstance for inference YOU MUST call PRMInstance::instantiateSlotChains() and PRMInstance::instantiate() on it before, otherwise DiscreteVariable pointers will be inconsistent and inference will be erroneous. Of course, this must be done once you have set all reference in the current system.

See also: PRMClass PRM PRMClassElement

Definition at line 79 of file PRMInstance.h.

Member Typedef Documentation

◆ const_iterator

template<typename GUM_SCALAR>

using gum::prm::PRMInstance< GUM_SCALAR >::const_iterator = typename NodeProperty< PRMAttribute< GUM_SCALAR >* >::const_iterator

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 340 of file PRMInstance.h.

◆ InvRefConstIterator

template<typename GUM_SCALAR>

using gum::prm::PRMInstance< GUM_SCALAR >::InvRefConstIterator

Initial value:

typename NodeProperty<

std::vector< std::pair< PRMInstance< GUM_SCALAR >*, std::string > >* >::const_iterator

gum::prm::PRMInstance::const_iterator

typename NodeProperty< PRMAttribute< GUM_SCALAR > * >::const_iterator const_iterator

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition PRMInstance.h:340

gum::NodeProperty

HashTable< NodeId, VAL > NodeProperty

Property on graph elements.

Definition graphElements.h:395

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 455 of file PRMInstance.h.

◆ InvRefIterator

template<typename GUM_SCALAR>

using gum::prm::PRMInstance< GUM_SCALAR >::InvRefIterator

Initial value:

typename NodeProperty<

std::vector< std::pair< PRMInstance< GUM_SCALAR >*, std::string > >* >::iterator

gum::prm::PRMInstance::iterator

typename NodeProperty< PRMAttribute< GUM_SCALAR > * >::iterator iterator

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition PRMInstance.h:327

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 453 of file PRMInstance.h.

◆ iterator

template<typename GUM_SCALAR>

using gum::prm::PRMInstance< GUM_SCALAR >::iterator = typename NodeProperty< PRMAttribute< GUM_SCALAR >* >::iterator

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 327 of file PRMInstance.h.

◆ pair

template<typename GUM_SCALAR>

using gum::prm::PRMInstance< GUM_SCALAR >::pair = std::pair< PRMInstance< GUM_SCALAR >*, std::string >

private

Code alias.

Definition at line 531 of file PRMInstance.h.

Member Enumeration Documentation

◆ prm_type

enum class gum::prm::PRMObject::prm_type : char

stronginherited

Enumeration of the different types of objects handled by a PRM.

The "all" type is used to tell that we want any kind of PRMType (useful with iterators for example). No PRMObject will ever have "all" as type.

Enumerator
ALL
CLASS
PRM_INTERFACE
CLASS_ELT
TYPE
SYSTEM
INSTANCE

Definition at line 88 of file PRMObject.h.

88: char { ALL, CLASS, PRM_INTERFACE, CLASS_ELT, TYPE, SYSTEM, INSTANCE };

Constructor & Destructor Documentation

◆ PRMInstance() [1/2]

template<typename GUM_SCALAR>

gum::prm::PRMInstance< GUM_SCALAR >::PRMInstance	(	const std::string &	name,
		PRMClass< GUM_SCALAR > &	type )

Default constructor of an PRMInstance<GUM_SCALAR>.

When you create an PRMInstance<GUM_SCALAR> all gum::prm::PRMAttribute<GUM_SCALAR> in it's type are added, except for gum::prm::PRMAggregate<GUM_SCALAR> and parameters which are instantiated.

However neither of their children or parents are updated (i.e. DiscreteVariable pointers are inconsistent).

Definition at line 56 of file PRMInstance_tpl.h.

                                                                                              :
        PRMObject(name), _instantiated_(false), _type_(&type) {
      GUM_CONSTRUCTOR(PRMInstance);
 
      // First we create attributes for each aggregate in type
      for (const auto agg: _type_->aggregates())
        _copyAggregates_(agg);
 
      // We add attributes in type by reference for inner ones and by copy for
      // output ones
      for (const auto attr: _type_->attributes())
        _copyAttribute_(attr);
    }

References PRMInstance(), gum::prm::PRMObject::PRMObject(), _copyAggregates_(), _copyAttribute_(), _instantiated_, _type_, gum::prm::PRMObject::name(), and type().

Referenced by PRMInstance(), gum::prm::PRMInstance< GUM_SCALAR >::RefIterator::RefIterator(), gum::prm::PRMInstance< GUM_SCALAR >::RefIterator::RefIterator(), ~PRMInstance(), _addReferingInstance_(), add(), gum::prm::PRMInstance< GUM_SCALAR >::RefIterator::operator*(), and gum::prm::PRMInstance< GUM_SCALAR >::RefIterator::operator->().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ~PRMInstance()

template<typename GUM_SCALAR>

gum::prm::PRMInstance< GUM_SCALAR >::~PRMInstance ( )

virtual

Destructor.

Definition at line 71 of file PRMInstance_tpl.h.

                                            {
      GUM_DESTRUCTOR(PRMInstance);
 
      for (const auto& elt: _nodeIdMap_)
        delete elt.second;
 
      for (const auto& elt: _referenceMap_)
        delete elt.second;
 
      for (const auto& elt: _referingAttr_)
        delete elt.second;
    }

References PRMInstance(), _nodeIdMap_, _referenceMap_, and _referingAttr_.

Here is the call graph for this function:

◆ PRMInstance() [2/2]

template<typename GUM_SCALAR>

INLINE gum::prm::PRMInstance< GUM_SCALAR >::PRMInstance ( const PRMInstance< GUM_SCALAR > & source )

private

Copy constructor.

Definition at line 267 of file PRMInstance_tpl.h.

                                                                                         :
        PRMObject(source), _type_(source._type_) {
      GUM_CONS_CPY(PRMInstance);
      GUM_ERROR(FatalError, "do not copy Instance")
    }

Member Function Documentation

◆ _addReferingInstance_()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMInstance< GUM_SCALAR >::_addReferingInstance_	(	PRMSlotChain< GUM_SCALAR > *	sc,
		PRMInstance< GUM_SCALAR > *	i )

private

Add this as a referring instance over the attribute pointed by sc in i.

Parameters

sc	A slot chain pointing over an attribute in i.
i	An instance holding an attribute pointed by sc.

Definition at line 342 of file PRMInstance_tpl.h.

                                                                                                {
      NodeId      id   = i->get(sc->lastElt().safeName()).id();
      std::string name = sc->lastElt().safeName();
 
      try {
        i->_referenceMap_[id]->insert(this);
        i->_referingAttr_[id]->push_back(std::make_pair(this, sc->lastElt().safeName()));
      } catch (NotFound const&) {
        i->_referenceMap_.insert(id, new Set< PRMInstance< GUM_SCALAR >* >());
        i->_referenceMap_[id]->insert(this);
        i->_referingAttr_.insert(id, new std::vector< pair >());
        i->_referingAttr_[id]->push_back(std::make_pair(this, sc->lastElt().safeName()));
      }
    }

References PRMInstance(), _referenceMap_, _referingAttr_, get(), gum::prm::PRMSlotChain< GUM_SCALAR >::lastElt(), and gum::prm::PRMObject::name().

Here is the call graph for this function:

◆ _copyAggregates_()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMInstance< GUM_SCALAR >::_copyAggregates_ ( PRMAggregate< GUM_SCALAR > * source )

private

Used at construction to instantiate aggregates.

Definition at line 245 of file PRMInstance_tpl.h.

                                                                                              {
      auto attr = new PRMScalarAttribute< GUM_SCALAR >(source->name(),
                                                       source->type(),
                                                       source->buildImpl());
      GUM_ASSERT(&(attr->type().variable()) != &(source->type().variable()));
      attr->setId(source->id());
      _nodeIdMap_.insert(attr->id(), attr);
      _bijection_.insert(&(source->type().variable()), &(attr->type().variable()));
    }

References _bijection_, _nodeIdMap_, gum::prm::PRMAggregate< GUM_SCALAR >::buildImpl(), gum::prm::PRMClassElement< GUM_SCALAR >::id(), gum::prm::PRMObject::name(), gum::prm::PRMClassElement< GUM_SCALAR >::setId(), gum::prm::PRMAggregate< GUM_SCALAR >::type(), gum::prm::PRMAttribute< GUM_SCALAR >::type(), and gum::prm::PRMType::variable().

Referenced by PRMInstance().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _copyAttribute_()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMInstance< GUM_SCALAR >::_copyAttribute_ ( PRMAttribute< GUM_SCALAR > * source )

private

Used at construction to instantiate attributes.

Parameters

source An attribute in type.

Definition at line 256 of file PRMInstance_tpl.h.

                                                                                             {
      auto attr = new PRMScalarAttribute< GUM_SCALAR >(source->name(), source->type());
      GUM_ASSERT(&(attr->type().variable()) != &(source->type().variable()));
      // The tensor is copied when instantiate() is called
      attr->cpf().fill((GUM_SCALAR)0);
      attr->setId(source->id());
      _bijection_.insert(&(source->type().variable()), &(attr->type().variable()));
      _nodeIdMap_.insert(attr->id(), attr);
    }

References _bijection_, _nodeIdMap_, gum::prm::PRMAttribute< GUM_SCALAR >::cpf(), gum::prm::PRMClassElement< GUM_SCALAR >::id(), gum::prm::PRMObject::name(), gum::prm::PRMClassElement< GUM_SCALAR >::setId(), gum::prm::PRMAttribute< GUM_SCALAR >::type(), and gum::prm::PRMType::variable().

Referenced by PRMInstance().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _copyAttributeCPF_()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMInstance< GUM_SCALAR >::_copyAttributeCPF_ ( PRMAttribute< GUM_SCALAR > * attr )

private

Copy the content of an PRMAttribute<GUM_SCALAR> from its Class<GUM_SCALAR> counterpart.

Parameters

attr	An PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.

Exceptions

OperationNotAllowed If the MultiDimImplementation is of an unknown type.

Definition at line 588 of file PRMInstance_tpl.h.

                                                                                              {
      const auto& type_attr
          = static_cast< const PRMAttribute< GUM_SCALAR >& >(type().get(attr->safeName()));
      attr->copyCpf(bijection(), type_attr);
      GUM_ASSERT(attr->cpf().contains(attr->type().variable()));
    }

References bijection(), gum::prm::PRMAttribute< GUM_SCALAR >::copyCpf(), gum::prm::PRMAttribute< GUM_SCALAR >::cpf(), gum::prm::PRMClassElement< GUM_SCALAR >::safeName(), gum::prm::PRMAttribute< GUM_SCALAR >::type(), type(), and gum::prm::PRMType::variable().

Here is the call graph for this function:

◆ _doInstantiate_()

template<typename GUM_SCALAR>

void gum::prm::PRMInstance< GUM_SCALAR >::_doInstantiate_ ( )

private

Starts this instance instantiations.

Definition at line 93 of file PRMInstance_tpl.h.

                                                    {
      // First retrieving any referenced instance
      for (const auto chain: type().slotChains()) {
        _instantiateSlotChain_(chain);
      }
 
      // Now we need to add referred instance to each input node
      // For Attributes we first add parents, then we initialize CPF
      for (const auto attr: type().attributes()) {
        _copyAttributeCPF_(_nodeIdMap_[(*attr).id()]);
      }
 
      // For PRMAggregate<GUM_SCALAR> we add parents
      for (const auto agg: type().aggregates()) {
        PRMAttribute< GUM_SCALAR >& attr = get(agg->safeName());
 
        for (const auto node: type().containerDag().parents(agg->id())) {
          try {
            attr.addParent(get(node));
          } catch (NotFound const&) {
            auto elt = &(type().get(node));
            auto sc  = static_cast< PRMSlotChain< GUM_SCALAR >* >(elt);
 
            try {
              const auto& instances = getInstances(sc->id());
 
              for (const auto inst: instances) {
                attr.addParent(inst->get(sc->lastElt().safeName()));
              }
            } catch (NotFound const&) {   // there is no parents for this agg
            }
          }
        }
      }
    }

References _instantiateSlotChain_(), and type().

Referenced by instantiate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _instantiateSlotChain_()

template<typename GUM_SCALAR>

void gum::prm::PRMInstance< GUM_SCALAR >::_instantiateSlotChain_ ( PRMSlotChain< GUM_SCALAR > * sc )

private

Retrieve all instances referred by sc.

Parameters

sc	A slot chain of this instance's type.

Exceptions

NotFound Raised if a reference in sc is not instantiated.

Definition at line 130 of file PRMInstance_tpl.h.

                                                                                         {
      auto first_id = sc->chain()[0]->id();
      if (!_referenceMap_.exists(first_id)) { return; }
      auto set = new Set< PRMInstance< GUM_SCALAR >* >(*(_referenceMap_[first_id]));
      // We proceed with a width-first run of the slot chain
      for (Size idx = 1; idx < sc->chain().size() - 1; ++idx) {
        auto temp = new Set< PRMInstance< GUM_SCALAR >* >();
        for (auto current: *set) {
          auto& ref = current->type().get(sc->chain()[idx]->name());
          for (auto next: *(current->_referenceMap_[ref.id()])) {
            temp->insert(next);
          }
        }
        delete set;
        set = temp;
      }
 
      GUM_ASSERT(set->size() > 0);
      // set contains all the instances references by sc
      if (_referenceMap_.exists(sc->id())) {
        delete _referenceMap_[sc->id()];
        _referenceMap_[sc->id()] = set;
      } else {
        _referenceMap_.insert(sc->id(), set);
      }
 
      // Add refering instances
      for (auto i: *set) {
        _addReferingInstance_(sc, i);
      }
 
      // If sc is not multiple so it can be added as a parent of an attribute
      if (!sc->isMultiple()) {
        // We should have only one instance
        // Less ugly way to get the single instance in set
        for (auto instance: *set) {
          auto& attr = instance->get(sc->lastElt().safeName());
          _bijection_.insert(&(sc->type().variable()), &(attr.type().variable()));
        }
      }
    }

References _referenceMap_, gum::prm::PRMSlotChain< GUM_SCALAR >::chain(), gum::prm::PRMClassElement< GUM_SCALAR >::id(), and size().

Referenced by _doInstantiate_().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ add()

template<typename GUM_SCALAR>

void gum::prm::PRMInstance< GUM_SCALAR >::add	(	NodeId	id,
		PRMInstance< GUM_SCALAR > &	instance )

Add an PRMInstance<GUM_SCALAR> to a given PRMReferenceSlot, PRMSlotChain<GUM_SCALAR> or output node.

Three type of nodes can be associated with an PRMInstance<GUM_SCALAR>. When an PRMInstance<GUM_SCALAR> is associated with a PRMReferenceSlot, it represents an arc in the relational skeleton. For a PRMSlotChain<GUM_SCALAR>, it is a placeholder of referenced PRMClassElement by this PRMInstance<GUM_SCALAR>. Finally, for an output node it indicates that an PRMInstance<GUM_SCALAR> has an PRMClassElement referring it.

Parameters

id	The NodeId of a PRMReferenceSlot of this PRMInstance<GUM_SCALAR>.
instance	The instance added as references by id in this PRMInstance<GUM_SCALAR>.

Exceptions

WrongClassElement	Raised if id is not a valid PRMClassElement.
OutOfBounds	Raised if no more PRMInstance<GUM_SCALAR> can be added to id.
PRMTypeError	Raised if instance's type isn't compatible with the reference's type.
NotFound	If there is no PRMClassElement given id.

Definition at line 173 of file PRMInstance_tpl.h.

                                                                                      {
      PRMClassElement< GUM_SCALAR >* elt = 0;
 
      try {
        elt = &(type().get(id));
      } catch (NotFound const&) {
        GUM_ERROR(NotFound, "no ClassElement<GUM_SCALAR> matches the given id")
      }
 
      switch (elt->elt_type()) {
        case PRMClassElement< GUM_SCALAR >::prm_refslot : {
          PRMReferenceSlot< GUM_SCALAR >* ref = static_cast< PRMReferenceSlot< GUM_SCALAR >* >(elt);
 
          // Checking if instance's type is legal
          if (!instance.type().isSubTypeOf(ref->slotType())) {
            GUM_ERROR(PRMTypeError,
                      "given Instance type is not a proper "
                      "subclass of the ReferenceSlot<GUM_SCALAR> slot type");
          }
 
          // Checking the reference's size limit
          if (_referenceMap_.exists(id)
              && (!static_cast< PRMReferenceSlot< GUM_SCALAR >& >(type().get(id)).isArray())
              && (_referenceMap_[id]->size() == 1)) {
            GUM_ERROR(OutOfBounds, "ReferenceSlot<GUM_SCALAR> size limit reached")
          }
 
          break;
        }
 
        case PRMClassElement< GUM_SCALAR >::prm_slotchain : {
          PRMSlotChain< GUM_SCALAR >& sc
              = static_cast< PRMSlotChain< GUM_SCALAR >& >(type().get(id));
 
          // Checking if instance's type is legal
          if (!instance.type().isSubTypeOf(sc.end())) {
            GUM_ERROR(PRMTypeError,
                      "given Instance type is not a proper "
                      "subclass of the ClassElementContainer pointed"
                      " by the SlotChain<GUM_SCALAR>");
          }
 
          // Checking the reference's size limit
          if (_referenceMap_.exists(id)
              && (!static_cast< PRMSlotChain< GUM_SCALAR >& >(type().get(id)).isMultiple())
              && (_referenceMap_[id]->size() == 1)) {
            GUM_ERROR(OutOfBounds, "SlotChain<GUM_SCALAR> size limit reached")
          }
 
          break;
        }
 
        default : {
          if (!type().isOutputNode(*elt)) {
            GUM_ERROR(WrongClassElement, "given ClassElement<GUM_SCALAR> is not an output node")
          }
        }
      }
 
      if (!_referenceMap_.exists(id)) {
        _referenceMap_.insert(id, new Set< PRMInstance< GUM_SCALAR >* >());
      }
 
      _referenceMap_[id]->insert(&instance);
    }

References PRMInstance(), _referenceMap_, gum::prm::PRMClassElement< GUM_SCALAR >::elt_type(), get(), GUM_ERROR, gum::prm::PRMClassElement< GUM_SCALAR >::prm_refslot, size(), gum::prm::PRMReferenceSlot< GUM_SCALAR >::slotType(), and type().

Here is the call graph for this function:

◆ begin() [1/4]

template<typename GUM_SCALAR>

INLINE PRMInstance< GUM_SCALAR >::iterator gum::prm::PRMInstance< GUM_SCALAR >::begin ( )

Returns an iterator at the begining of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 393 of file PRMInstance_tpl.h.

                                                                                       {
      return _nodeIdMap_.begin();
    }

References _nodeIdMap_.

Referenced by gum::prm::PRMInstance< GUM_SCALAR >::RefIterator::RefIterator(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodes_(), gum::prm::StructuredInference< GUM_SCALAR >::_reduceAloneInstances_(), and gum::prm::StructuredInference< GUM_SCALAR >::searchPatterns().

Here is the caller graph for this function:

◆ begin() [2/4]

template<typename GUM_SCALAR>

INLINE PRMInstance< GUM_SCALAR >::const_iterator gum::prm::PRMInstance< GUM_SCALAR >::begin ( ) const

Returns an iterator at the beginning of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 404 of file PRMInstance_tpl.h.

                                               {
      return _nodeIdMap_.begin();
    }

References _nodeIdMap_.

◆ begin() [3/4]

template<typename GUM_SCALAR>

INLINE PRMInstance< GUM_SCALAR >::RefIterator gum::prm::PRMInstance< GUM_SCALAR >::begin ( NodeId id )

Returns an iterator at the beginning of the set of PRMInstance<GUM_SCALAR> associated to a given gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR>.

Parameters

id	A gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR> in this PRMInstance<GUM_SCALAR> type.

Exceptions

NotFound	Raised if no gum::prm::PRMClassElement in this PRMInstance<GUM_SCALAR> type matches id.
WrongClassElement	Raised if id is neither a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>.

Definition at line 416 of file PRMInstance_tpl.h.

                                                  {
      try {
        return PRMInstance< GUM_SCALAR >::RefIterator(*(_referenceMap_[id]));
      } catch (NotFound const&) { GUM_ERROR(NotFound, "no referred instances from this NodeId") }
    }

◆ begin() [4/4]

template<typename GUM_SCALAR>

INLINE PRMInstance< GUM_SCALAR >::RefConstIterator gum::prm::PRMInstance< GUM_SCALAR >::begin ( NodeId id ) const

Returns an iterator at the beginning of the set of PRMInstance<GUM_SCALAR> associated to a given gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR>.

Parameters

id	A gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR> in this PRMInstance<GUM_SCALAR> type.

Exceptions

NotFound	Raised if no gum::prm::PRMClassElement in this PRMInstance<GUM_SCALAR> type matches id.
WrongClassElement	Raised if id is neither a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>.

Definition at line 424 of file PRMInstance_tpl.h.

                                                        {
      try {
        return PRMInstance< GUM_SCALAR >::RefConstIterator(*(_referenceMap_[id]));
      } catch (NotFound const&) { GUM_ERROR(NotFound, "no referred instances from this NodeId") }
    }

◆ beginInvRef() [1/2]

template<typename GUM_SCALAR>

INLINE PRMInstance< GUM_SCALAR >::InvRefIterator gum::prm::PRMInstance< GUM_SCALAR >::beginInvRef ( )

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 548 of file PRMInstance_tpl.h.

                                               {
      return _referingAttr_.begin();
    }

References _referingAttr_.

Referenced by gum::prm::SVE< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesDownward_(), and gum::prm::SVE< GUM_SCALAR >::_eliminateNodesUpward_().

Here is the caller graph for this function:

◆ beginInvRef() [2/2]

template<typename GUM_SCALAR>

INLINE PRMInstance< GUM_SCALAR >::InvRefConstIterator gum::prm::PRMInstance< GUM_SCALAR >::beginInvRef ( ) const

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 560 of file PRMInstance_tpl.h.

                                                     {
      return _referingAttr_.begin();
    }

References _referingAttr_.

◆ bijection()

template<typename GUM_SCALAR>

INLINE const Bijection< const DiscreteVariable *, const DiscreteVariable * > & gum::prm::PRMInstance< GUM_SCALAR >::bijection ( ) const

Returns a mapping between DiscreteVariable used in this and the ones used in this PRMInstance<GUM_SCALAR>'s Class<GUM_SCALAR>.

MultiDims require distinctive DiscreteVariable pointers, thus interface attributes are always instantiated to prevent multiple insertion of the same DiscreteVariable pointer in a MultiDim.

Returns: Returns a bijection in which first elements are DiscreteVariable in this->type() and the second are in this.

Definition at line 360 of file PRMInstance_tpl.h.

                                                            {
      return _bijection_;
    }

References _bijection_.

Referenced by _copyAttributeCPF_(), gum::prm::SVE< GUM_SCALAR >::_insertLiftedNodes_(), gum::prm::SVED< GUM_SCALAR >::_insertLiftedNodes_(), and gum::prm::StructuredInference< GUM_SCALAR >::_reduceAloneInstances_().

Here is the caller graph for this function:

◆ end() [1/2]

template<typename GUM_SCALAR>

INLINE const PRMInstance< GUM_SCALAR >::iterator & gum::prm::PRMInstance< GUM_SCALAR >::end ( )

Returns a reference over the iterator at the end of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 398 of file PRMInstance_tpl.h.

                                                                                            {
      return _nodeIdMap_.end();
    }

References _nodeIdMap_.

Referenced by gum::prm::SVE< GUM_SCALAR >::_eliminateNodes_(), gum::prm::StructuredInference< GUM_SCALAR >::_reduceAloneInstances_(), and gum::prm::PRMInference< GUM_SCALAR >::posterior().

Here is the caller graph for this function:

◆ end() [2/2]

template<typename GUM_SCALAR>

INLINE const PRMInstance< GUM_SCALAR >::const_iterator & gum::prm::PRMInstance< GUM_SCALAR >::end ( ) const

Returns a reference over the iterator at the end of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 410 of file PRMInstance_tpl.h.

                                             {
      return _nodeIdMap_.end();
    }

References _nodeIdMap_.

◆ endInvRef() [1/2]

template<typename GUM_SCALAR>

INLINE const PRMInstance< GUM_SCALAR >::InvRefIterator & gum::prm::PRMInstance< GUM_SCALAR >::endInvRef ( )

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 554 of file PRMInstance_tpl.h.

                                             {
      return _referingAttr_.end();
    }

References _referingAttr_.

Referenced by gum::prm::SVE< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesDownward_(), and gum::prm::SVE< GUM_SCALAR >::_eliminateNodesUpward_().

Here is the caller graph for this function:

◆ endInvRef() [2/2]

template<typename GUM_SCALAR>

INLINE const PRMInstance< GUM_SCALAR >::InvRefConstIterator & gum::prm::PRMInstance< GUM_SCALAR >::endInvRef ( ) const

Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 566 of file PRMInstance_tpl.h.

                                                   {
      return _referingAttr_.end();
    }

References _referingAttr_.

◆ enum2str()

std::string gum::prm::PRMObject::enum2str ( prm_type type )

inlinestaticinherited

Returns the string representation of a PRMObject.

Definition at line 95 of file PRMObject.h.

                                               {
        switch (type) {
          case prm_type::CLASS : return "PRMType::CLASS";
 
          case prm_type::CLASS_ELT : return "PRMType::CLASS_ELT";
 
          case prm_type::TYPE : return "PRMType::TYPE";
 
          case prm_type::SYSTEM : return "PRMType::SYSTEM";
 
          case prm_type::INSTANCE : return "PRMType::INSTANCE";
 
          case prm_type::PRM_INTERFACE : return "PRMType::PRM_INTERFACE";
 
          default : return "unknown";
        }
      }

References CLASS, CLASS_ELT, INSTANCE, PRM_INTERFACE, SYSTEM, and TYPE.

Referenced by gum::prm::operator<<().

Here is the caller graph for this function:

◆ exists() [1/2]

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMInstance< GUM_SCALAR >::exists ( const std::string & name ) const

Returns true if name matches an PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 300 of file PRMInstance_tpl.h.

                                                                             {
      return _type_->exists(name) && exists(_type_->get(name).id());
    }

References _type_, exists(), and gum::prm::PRMObject::name().

Here is the call graph for this function:

◆ exists() [2/2]

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMInstance< GUM_SCALAR >::exists ( NodeId id ) const

Returns true if id matches an PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Definition at line 295 of file PRMInstance_tpl.h.

                                                                 {
      return _nodeIdMap_.exists(id);
    }

References _nodeIdMap_.

Referenced by exists(), and gum::prm::o3prmr::O3prmrInterpreter::findAttributeName().

Here is the caller graph for this function:

◆ get() [1/4]

template<typename GUM_SCALAR>

INLINE PRMAttribute< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::get ( const std::string & name )

Given a name returns the related PRMAttribute<GUM_SCALAR>.

Parameters

name	The PRMAttribute<GUM_SCALAR>'s name.

Returns: Returns a reference over the PRMAttribute<GUM_SCALAR>.

Exceptions

NotFound Raised if there is no PRMAttribute<GUM_SCALAR> named n.

Definition at line 323 of file PRMInstance_tpl.h.

                                                                                           {
      try {
        return *(_nodeIdMap_[type().get(name).id()]);
      } catch (NotFound const&) {
        GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given name")
      }
    }

References _nodeIdMap_, GUM_ERROR, gum::prm::PRMObject::name(), and type().

Here is the call graph for this function:

◆ get() [2/4]

template<typename GUM_SCALAR>

INLINE const PRMAttribute< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::get ( const std::string & name ) const

Given a name returns the related PRMClassElement.

Parameters

name	The PRMClassElement's name.

Returns: Returns a constant reference over the PRMClassElement.

Exceptions

NotFound Raised if there is no PRMClassElement named n.

Definition at line 333 of file PRMInstance_tpl.h.

                                                                           {
      try {
        return *(_nodeIdMap_[type().get(name).id()]);
      } catch (NotFound const&) {
        GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given name")
      }
    }

References _nodeIdMap_, gum::prm::PRMObject::name(), and type().

Here is the call graph for this function:

◆ get() [3/4]

template<typename GUM_SCALAR>

INLINE PRMAttribute< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::get ( NodeId id )

Getter on an PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.

Recall that PRMAggregate<GUM_SCALAR> are instantiated as PRMAttribute<GUM_SCALAR> when an PRMInstance<GUM_SCALAR> is created. Thus any random variable contained in this PRMInstance<GUM_SCALAR> is mapped to an PRMAttribute<GUM_SCALAR>.

Parameters

id	The PRMAttribute<GUM_SCALAR> id.

Returns: Returns a constant reference on an PRMAttribute<GUM_SCALAR>.

Exceptions

NotFound Raised if no PRMAttribute<GUM_SCALAR> matches name.

Definition at line 305 of file PRMInstance_tpl.h.

                                                                               {
      try {
        return *(_nodeIdMap_[id]);
      } catch (NotFound const&) {
        GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given NodeId")
      }
    }

Referenced by gum::prm::SVE< GUM_SCALAR >::_addDelayedVariable_(), _addReferingInstance_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesWithEvidence_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesWithEvidence_(), gum::prm::SVE< GUM_SCALAR >::_getAggTensor_(), gum::prm::SVED< GUM_SCALAR >::_getAggTensor_(), gum::prm::PRMSystem< double >::_groundAgg_(), gum::prm::PRMSystem< GUM_SCALAR >::_groundRef_(), gum::prm::InstanceBayesNet< GUM_SCALAR >::_init_(), gum::prm::StructuredInference< GUM_SCALAR >::_insertNodeInElimLists_(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_isHardEvidence_(), gum::prm::StructuredInference< GUM_SCALAR >::_reduceAloneInstances_(), add(), gum::prm::o3prmr::O3prmrInterpreter::checkObserve(), gum::prm::o3prmr::O3prmrInterpreter::checkQuery(), and gum::prm::o3prmr::O3prmrInterpreter::checkUnobserve().

Here is the caller graph for this function:

◆ get() [4/4]

template<typename GUM_SCALAR>

INLINE const PRMAttribute< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::get ( NodeId id ) const

Getter on an PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.

Recall that PRMAggregate<GUM_SCALAR> are instantiated has PRMAttribute<GUM_SCALAR> when an PRMInstance<GUM_SCALAR> is created. Thus any random variable contained in this PRMInstance<GUM_SCALAR> is mapped to an PRMAttribute<GUM_SCALAR>.

Parameters

id	The PRMAttribute<GUM_SCALAR> id.

Returns: Returns a constant reference on an PRMAttribute<GUM_SCALAR>.

Exceptions

NotFound Raised if no PRMAttribute<GUM_SCALAR> matches name.

Definition at line 314 of file PRMInstance_tpl.h.

                                                                                           {
      try {
        return *(_nodeIdMap_[id]);
      } catch (NotFound const&) {
        GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given NodeId")
      }
    }

References _nodeIdMap_, and GUM_ERROR.

◆ getInstance()

template<typename GUM_SCALAR>

INLINE const PRMInstance< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::getInstance ( NodeId id ) const

Fast access to the first instance in a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>.

This is equivalent to **(this->getInstance(id).begin()) and should be use when dealing with non multiple PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>.

Parameters

id	The NodeId of a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.

Exceptions

NotFound	Raised if there is no PRMClassElement given id.
UndefinedElement	Raised if no PRMInstance<GUM_SCALAR> are referenced by id.

Definition at line 366 of file PRMInstance_tpl.h.

                                                                       {
      try {
        if (_referenceMap_[id]->size() > 0) {
          return **(_referenceMap_[id]->begin());
        } else {
          GUM_ERROR(UndefinedElement, "no Instance associated with the given NodeId")
        }
      } catch (NotFound const&) {
        GUM_ERROR(NotFound,
                  "no ReferenceSlot<GUM_SCALAR> or SlotChain<GUM_SCALAR> "
                           "matches the given NodeId");
      }
    }

◆ getInstances()

template<typename GUM_SCALAR>

INLINE const Set< PRMInstance< GUM_SCALAR > * > & gum::prm::PRMInstance< GUM_SCALAR >::getInstances ( NodeId id ) const

Returns the Set of PRMInstance<GUM_SCALAR> referenced by id.

Parameters

id	The NodeId of a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR> in this.

Returns: Returns the Set of PRMInstance<GUM_SCALAR> referenced by id.

Exceptions

NotFound If there is no PRMClassElement given id.

Definition at line 382 of file PRMInstance_tpl.h.

                                                                        {
      try {
        return *(_referenceMap_[id]);
      } catch (NotFound const&) {
        GUM_ERROR(NotFound,
                  "no ReferenceSlot<GUM_SCALAR> or SlotChain<GUM_SCALAR> "
                           "matches the given NodeId");
      }
    }

References _referenceMap_, and GUM_ERROR.

Referenced by gum::prm::SVE< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesDownward_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesDownward_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesUpward_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesUpward_(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_fromChild_(), and gum::prm::PRMSystem< GUM_SCALAR >::_groundRef_().

Here is the caller graph for this function:

◆ getRefAttr() [1/2]

template<typename GUM_SCALAR>

INLINE std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > & gum::prm::PRMInstance< GUM_SCALAR >::getRefAttr ( NodeId id )

Returns a vector of pairs of refering attributes of id.

Definition at line 572 of file PRMInstance_tpl.h.

                                                          {
      return *(_referingAttr_[id]);
    }

References _referingAttr_.

Referenced by gum::prm::SVED< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesDownward_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesUpward_(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_fromChild_(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_fromParent_(), and gum::prm::StructuredInference< GUM_SCALAR >::_insertNodeInElimLists_().

Here is the caller graph for this function:

◆ getRefAttr() [2/2]

template<typename GUM_SCALAR>

INLINE const std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > & gum::prm::PRMInstance< GUM_SCALAR >::getRefAttr ( NodeId id ) const

Returns a vector of pairs of refering attributes of id.

Definition at line 578 of file PRMInstance_tpl.h.

                                                                      {
      return *(_referingAttr_[id]);
    }

References _referingAttr_.

◆ hasRefAttr()

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMInstance< GUM_SCALAR >::hasRefAttr ( NodeId id ) const

Returns true if id has at least one referring PRMAttribute<GUM_SCALAR>.

Parameters

id A NodeId.

Returns: returns true if is has at least one referring PRMAttribute<GUM_SCALAR>.

Definition at line 583 of file PRMInstance_tpl.h.

                                                                     {
      return _referingAttr_.exists(id) && (!_referingAttr_[id]->empty());
    }

References _referingAttr_.

◆ instantiate()

template<typename GUM_SCALAR>

void gum::prm::PRMInstance< GUM_SCALAR >::instantiate ( )

Instantiate all nodes which requires it.

All attributes are now instantiated, which means they have a different DiscreteVariable pointer. This methods however still connects attributes of different instance together.

Warning: Be aware that this method will delete a large part of this instance attribute's CPF. Furthermore, the instantiated attribute's type will change (but will not be deleted).

Definition at line 85 of file PRMInstance_tpl.h.

                                                {
      if (!_instantiated_) {
        _instantiated_ = true;
        _doInstantiate_();
      }
    }

References _doInstantiate_(), and _instantiated_.

Here is the call graph for this function:

◆ isClass()

INLINE bool gum::prm::PRMObject::isClass ( const PRMObject & obj )

inlinestaticinherited

Returns true if obj_ptr is of type Class.

Definition at line 114 of file PRMObject.h.

114{ return obj.obj_type() == prm_type::CLASS; }

References PRMObject(), CLASS, and obj_type().

Referenced by gum::prm::PRMClass< GUM_SCALAR >::scope(), and gum::prm::PRMFactory< GUM_SCALAR >::startAttribute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isInstance()

INLINE bool gum::prm::PRMObject::isInstance ( const PRMObject & obj )

inlinestaticinherited

Returns true if obj_ptr is of type PRMInstance.

Definition at line 122 of file PRMObject.h.

                                                          {
        return obj.obj_type() == prm_type::INSTANCE;
      }

References PRMObject(), INSTANCE, and obj_type().

Here is the call graph for this function:

◆ isInterface()

INLINE bool gum::prm::PRMObject::isInterface ( const PRMObject & obj )

inlinestaticinherited

Returns true if obj_ptr is of type PRMInterface.

Definition at line 117 of file PRMObject.h.

                                                           {
        return obj.obj_type() == prm_type::PRM_INTERFACE;
      }

References PRMObject(), obj_type(), and PRM_INTERFACE.

Here is the call graph for this function:

◆ LEFT_CAST()

std::string gum::prm::PRMObject::LEFT_CAST ( )

inlinestaticinherited

Enumeration of the different types of objects handled by a PRM.

The "all" type is used to tell that we want any kind of PRMType (useful with iterators for example). No PRMObject will ever have "all" as type.

Definition at line 90 of file PRMObject.h.

90{ return "("; }

Referenced by gum::prm::PRMAggregate< GUM_SCALAR >::PRMAggregate(), gum::prm::PRMAggregate< GUM_SCALAR >::PRMAggregate(), gum::prm::PRMFormAttribute< GUM_SCALAR >::PRMFormAttribute(), gum::prm::PRMReferenceSlot< GUM_SCALAR >::PRMReferenceSlot(), gum::prm::PRMScalarAttribute< GUM_SCALAR >::PRMScalarAttribute(), gum::prm::PRMSlotChain< GUM_SCALAR >::PRMSlotChain(), gum::prm::PRMClassElement< GUM_SCALAR >::cast(), and gum::prm::decomposePath().

Here is the caller graph for this function:

◆ name() [1/2]

INLINE const std::string & gum::prm::PRMObject::name ( ) const

inherited

Returns the name of this object.

Definition at line 54 of file PRMObject_inl.h.

54{ return _name_; }

gum::prm::PRMObject::_name_

std::string _name_

Definition PRMObject.h:211

References _name_.

◆ name() [2/2]

INLINE void gum::prm::PRMObject::name ( const std::string & name )

inherited

Change the name of the PRM Object.

Warning: Don't do this unless you know what you are doing !

Definition at line 58 of file PRMObject_inl.h.

58{ _name_ = name; }

References _name_, and name().

Here is the call graph for this function:

◆ obj_type()

template<typename GUM_SCALAR>

INLINE PRMObject::prm_type gum::prm::PRMInstance< GUM_SCALAR >::obj_type ( ) const

virtual

Returns the PRM type of this object.

Implements gum::prm::PRMObject.

Definition at line 280 of file PRMInstance_tpl.h.

                                                                       {
      return PRMObject::prm_type::INSTANCE;
    }

References gum::prm::PRMObject::INSTANCE.

◆ operator!=()

INLINE bool gum::prm::PRMObject::operator!= ( const PRMObject & obj ) const

inherited

To PRMObject are equal if they have the same name (which is unique).

Definition at line 66 of file PRMObject_inl.h.

66{ return _name_ != obj.name(); }

References PRMObject(), _name_, and name().

Here is the call graph for this function:

◆ operator=()

template<typename GUM_SCALAR>

INLINE PRMInstance< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::operator= ( const PRMClass< GUM_SCALAR > & from )

private

Copy operator. Don't use it.

Definition at line 275 of file PRMInstance_tpl.h.

                                                                                {
      GUM_ERROR(FatalError, "do not copy Instance")
    }

References GUM_ERROR.

◆ operator==()

INLINE bool gum::prm::PRMObject::operator== ( const PRMObject & obj ) const

inherited

To PRMObject are equal if they have the same name (which is unique).

Definition at line 62 of file PRMObject_inl.h.

62{ return _name_ == obj.name(); }

References PRMObject(), _name_, and name().

Here is the call graph for this function:

◆ RIGHT_CAST()

std::string gum::prm::PRMObject::RIGHT_CAST ( )

inlinestaticinherited

Enumeration of the different types of objects handled by a PRM.

The "all" type is used to tell that we want any kind of PRMType (useful with iterators for example). No PRMObject will ever have "all" as type.

Definition at line 92 of file PRMObject.h.

92{ return ")"; }

Referenced by gum::prm::PRMAggregate< GUM_SCALAR >::PRMAggregate(), gum::prm::PRMAggregate< GUM_SCALAR >::PRMAggregate(), gum::prm::PRMFormAttribute< GUM_SCALAR >::PRMFormAttribute(), gum::prm::PRMReferenceSlot< GUM_SCALAR >::PRMReferenceSlot(), gum::prm::PRMScalarAttribute< GUM_SCALAR >::PRMScalarAttribute(), gum::prm::PRMSlotChain< GUM_SCALAR >::PRMSlotChain(), gum::prm::PRMClassElement< GUM_SCALAR >::cast(), and gum::prm::decomposePath().

Here is the caller graph for this function:

◆ size()

template<typename GUM_SCALAR>

INLINE Size gum::prm::PRMInstance< GUM_SCALAR >::size ( ) const

Returns the number of attributes in this PRMInstance<GUM_SCALAR>.

Returns: the number of attributes in this PRMInstance<GUM_SCALAR>.

Definition at line 240 of file PRMInstance_tpl.h.

                                                      {
      return _nodeIdMap_.size();
    }

References _nodeIdMap_.

Referenced by _instantiateSlotChain_(), gum::prm::StructuredInference< GUM_SCALAR >::_reduceAloneInstances_(), and add().

Here is the caller graph for this function:

◆ type() [1/2]

template<typename GUM_SCALAR>

INLINE PRMClass< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::type ( )

Returns the type of this instance.

Definition at line 285 of file PRMInstance_tpl.h.

                                                                   {
      return *_type_;
    }

Referenced by PRMInstance(), gum::prm::__print_attribute__(), gum::prm::__print_instance__(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_buildHashKey_(), gum::prm::SVE< GUM_SCALAR >::_checkElimOrder_(), gum::prm::SVED< GUM_SCALAR >::_checkElimOrder_(), _copyAttributeCPF_(), _doInstantiate_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesDownward_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesDownward_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesUpward_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesUpward_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesWithEvidence_(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_fromChild_(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_fromParent_(), gum::prm::StructuredBayesBall< GUM_SCALAR >::_getSC_(), gum::prm::PRMSystem< GUM_SCALAR >::_groundAttr_(), gum::prm::PRMSystem< GUM_SCALAR >::_groundRef_(), gum::prm::PRMSystem< double >::_groundTensor_(), gum::prm::InstanceBayesNet< GUM_SCALAR >::_init_(), gum::prm::SVED< GUM_SCALAR >::_initLiftedNodes_(), gum::prm::SVED< GUM_SCALAR >::_initReqSets_(), gum::prm::SVE< GUM_SCALAR >::_insertLiftedNodes_(), gum::prm::StructuredInference< GUM_SCALAR >::_insertNodeInElimLists_(), gum::prm::StructuredInference< GUM_SCALAR >::_reduceAloneInstances_(), gum::prm::SVE< GUM_SCALAR >::_variableElimination_(), add(), gum::prm::PRMSystem< GUM_SCALAR >::add(), get(), get(), and gum::prm::PRMSystem< double >::instantiate().

◆ type() [2/2]

template<typename GUM_SCALAR>

INLINE const PRMClass< GUM_SCALAR > & gum::prm::PRMInstance< GUM_SCALAR >::type ( ) const

Returns the type of this instance.

Definition at line 290 of file PRMInstance_tpl.h.

                                                                               {
      return *_type_;
    }

References _type_.

Member Data Documentation

◆ _bijection_

template<typename GUM_SCALAR>

Bijection< const DiscreteVariable*, const DiscreteVariable* > gum::prm::PRMInstance< GUM_SCALAR >::_bijection_

private

A bijection used for MultiDim handling.

Definition at line 538 of file PRMInstance.h.

Referenced by _copyAggregates_(), _copyAttribute_(), and bijection().

◆ _instantiated_

template<typename GUM_SCALAR>

bool gum::prm::PRMInstance< GUM_SCALAR >::_instantiated_

private

True if this instance has been instantiated.

Definition at line 516 of file PRMInstance.h.

Referenced by PRMInstance(), and instantiate().

◆ _name_

std::string gum::prm::PRMObject::_name_

privateinherited

Definition at line 211 of file PRMObject.h.

Referenced by PRMObject(), PRMObject(), PRMObject(), name(), name(), operator!=(), operator=(), operator=(), and operator==().

◆ _nodeIdMap_

template<typename GUM_SCALAR>

NodeProperty< PRMAttribute< GUM_SCALAR >* > gum::prm::PRMInstance< GUM_SCALAR >::_nodeIdMap_

private

The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.

Definition at line 523 of file PRMInstance.h.

Referenced by ~PRMInstance(), _copyAggregates_(), _copyAttribute_(), begin(), begin(), end(), end(), exists(), get(), get(), get(), and size().

◆ _referenceMap_

template<typename GUM_SCALAR>

NodeProperty< Set< PRMInstance< GUM_SCALAR >* >* > gum::prm::PRMInstance< GUM_SCALAR >::_referenceMap_

private

Mapping between the gum::prm::PRMReferenceSlot and gum::prm::PRMSlotChain<GUM_SCALAR> in type / and the PRMInstance<GUM_SCALAR> associated with it.

Definition at line 528 of file PRMInstance.h.

Referenced by ~PRMInstance(), _addReferingInstance_(), _instantiateSlotChain_(), add(), and getInstances().

◆ _referingAttr_

template<typename GUM_SCALAR>

NodeProperty< std::vector< pair >* > gum::prm::PRMInstance< GUM_SCALAR >::_referingAttr_

private

The set of pair (instance, attribute) referring an attribute of this instance.

Definition at line 535 of file PRMInstance.h.

Referenced by ~PRMInstance(), _addReferingInstance_(), beginInvRef(), beginInvRef(), endInvRef(), endInvRef(), getRefAttr(), getRefAttr(), and hasRefAttr().

◆ _type_

template<typename GUM_SCALAR>

PRMClass< GUM_SCALAR >* gum::prm::PRMInstance< GUM_SCALAR >::_type_

private

The type of this PRMInstance<GUM_SCALAR>.

Definition at line 519 of file PRMInstance.h.

Referenced by PRMInstance(), exists(), and type().

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

agrum/PRM/elements/PRMInstance.h
agrum/PRM/elements/PRMInstance_tpl.h

Classes

Public Member Functions

Private Member Functions

Private Attributes

Iterators

Built-in types.

Private members.

Detailed Description

Member Typedef Documentation

◆ const_iterator

◆ InvRefConstIterator

◆ InvRefIterator

◆ iterator

◆ pair

Member Enumeration Documentation

◆ prm_type

Constructor & Destructor Documentation

◆ PRMInstance() [1/2]

◆ ~PRMInstance()

◆ PRMInstance() [2/2]

Member Function Documentation

◆ _addReferingInstance_()

◆ _copyAggregates_()

◆ _copyAttribute_()

◆ _copyAttributeCPF_()

◆ _doInstantiate_()

◆ _instantiateSlotChain_()

◆ add()

◆ begin() [1/4]

◆ begin() [2/4]

◆ begin() [3/4]

◆ begin() [4/4]

◆ beginInvRef() [1/2]

◆ beginInvRef() [2/2]

◆ bijection()

◆ end() [1/2]

◆ end() [2/2]

◆ endInvRef() [1/2]

◆ endInvRef() [2/2]

◆ enum2str()

◆ exists() [1/2]

◆ exists() [2/2]

◆ get() [1/4]

◆ get() [2/4]

◆ get() [3/4]

◆ get() [4/4]

◆ getInstance()

◆ getInstances()

◆ getRefAttr() [1/2]

◆ getRefAttr() [2/2]

◆ hasRefAttr()

◆ instantiate()

◆ isClass()

◆ isInstance()

◆ isInterface()

◆ LEFT_CAST()

◆ name() [1/2]

◆ name() [2/2]

◆ obj_type()

◆ operator!=()

◆ operator=()

◆ operator==()

◆ RIGHT_CAST()

◆ size()

◆ type() [1/2]

◆ type() [2/2]

Member Data Documentation

◆ _bijection_

◆ _instantiated_

◆ _name_

◆ _nodeIdMap_

◆ _referenceMap_

◆ _referingAttr_

◆ _type_