aGrUM  0.20.2
a C++ library for (probabilistic) graphical models
gum::prm::PRMInstance< GUM_SCALAR > Class Template Reference

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 >:

Public Member Functions

Constructors & private operators.
 PRMInstance (const std::string &name, PRMClass< GUM_SCALAR > &type)
 Default constructor of an PRMInstance<GUM_SCALAR>. More...
 
virtual ~PRMInstance ()
 Destructor. More...
 
Getters & setters.
virtual prm_type obj_type () const
 Returns the PRM type of this object. More...
 
PRMClass< GUM_SCALAR > & type ()
 Returns the type of this instance. More...
 
const PRMClass< GUM_SCALAR > & type () const
 Returns the type of this instance. More...
 
bool exists (NodeId id) const
 Returns true if id matches an PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
bool exists (const std::string &name) const
 Returns true if name matches an PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
PRMAttribute< GUM_SCALAR > & get (NodeId id)
 Getter on an PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>. More...
 
PRMAttribute< GUM_SCALAR > & get (const std::string &name)
 Given a name returns the related PRMAttribute<GUM_SCALAR>. More...
 
const PRMAttribute< GUM_SCALAR > & get (NodeId id) const
 Getter on an PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>. More...
 
const PRMAttribute< GUM_SCALAR > & get (const std::string &name) const
 Given a name returns the related PRMClassElement. More...
 
Size size () const
 Returns the number of attributes in this PRMInstance<GUM_SCALAR>. More...
 
Instantiation methods.
void instantiate ()
 Instantiate all nodes which requires it. More...
 
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>. More...
 
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. More...
 
const PRMInstance< GUM_SCALAR > & getInstance (NodeId id) const
 Fast access to the first instance in a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>. More...
 
const Set< PRMInstance< GUM_SCALAR > *> & getInstances (NodeId id) const
 Returns the Set of PRMInstance<GUM_SCALAR> referenced by id. More...
 
bool hasRefAttr (NodeId id) const
 Returns true if id has at least one referring PRMAttribute<GUM_SCALAR>. More...
 
std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > & getRefAttr (NodeId id)
 Returns a vector of pairs of refering attributes of id. More...
 
const std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > & getRefAttr (NodeId id) const
 Returns a vector of pairs of refering attributes of id. More...
 
Getters & setters.
const std::string & name () const
 Returns the name of this object. More...
 
void name (const std::string &name)
 Change the name of the PRM Object. More...
 
Operators
bool operator== (const PRMObject &obj) const
 To PRMObject are equal if they have the same name (which is unique). More...
 
bool operator!= (const PRMObject &obj) const
 To PRMObject are equal if they have the same name (which is unique). More...
 

Classes

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

Iterators

typedef NodeProperty< PRMAttribute< GUM_SCALAR > *>::iterator iterator
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
typedef NodeProperty< PRMAttribute< GUM_SCALAR > *>::const_iterator const_iterator
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
typedef NodeProperty< std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > *>::iterator InvRefIterator
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
typedef NodeProperty< std::vector< std::pair< PRMInstance< GUM_SCALAR > *, std::string > > *>::const_iterator InvRefConstIterator
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
iterator begin ()
 Returns an iterator at the begining of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
const iteratorend ()
 Returns a reference over the iterator at the end of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
const_iterator begin () const
 Returns an iterator at the beginning of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
const const_iteratorend () const
 Returns a reference over the iterator at the end of the list of gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
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>. More...
 
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>. More...
 
InvRefIterator beginInvRef ()
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
const InvRefIteratorendInvRef ()
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
InvRefConstIterator beginInvRef () const
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 
const InvRefConstIteratorendInvRef () const
 Alias to iterate over the gum::prm::PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>. More...
 

Private members.

typedef std::pair< PRMInstance< GUM_SCALAR > *, std::string > pair
 Code alias. More...
 
bool instantiated__
 True if this instance has been instantiated. More...
 
PRMClass< GUM_SCALAR > * type__
 The type of this PRMInstance<GUM_SCALAR>. More...
 
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
 The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>. More...
 
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. More...
 
NodeProperty< std::vector< pair > *> referingAttr__
 The set of pair (instance, attribute) referring an attribute of this instance. More...
 
Bijection< const DiscreteVariable *, const DiscreteVariable *> bijection__
 A bijection used for MultiDim handling. More...
 

Built-in types.

enum  prm_type : char {
  prm_type::ALL, prm_type::CLASS, prm_type::PRM_INTERFACE, prm_type::CLASS_ELT,
  prm_type::TYPE, prm_type::SYSTEM, prm_type::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. More...
 
static std::string RIGHT_CAST ()
 Enumeration of the different types of objects handled by a PRM. More...
 
static std::string enum2str (prm_type type)
 Returns the string representation of a PRMObject. More...
 
static INLINE bool isClass (const PRMObject &obj)
 Returns true if obj_ptr is of type Class. More...
 
static INLINE bool isInterface (const PRMObject &obj)
 Returns true if obj_ptr is of type PRMInterface. More...
 
static INLINE bool isInstance (const PRMObject &obj)
 Returns true if obj_ptr is of type PRMInstance. More...
 

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 62 of file PRMInstance.h.

Member Typedef Documentation

◆ const_iterator

template<typename GUM_SCALAR>
typedef NodeProperty< PRMAttribute< GUM_SCALAR >* >::const_iterator gum::prm::PRMInstance< GUM_SCALAR >::const_iterator

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

Definition at line 328 of file PRMInstance.h.

◆ InvRefConstIterator

template<typename GUM_SCALAR>
typedef NodeProperty< std::vector< std::pair< PRMInstance< GUM_SCALAR >*, std::string > >* >::const_iterator gum::prm::PRMInstance< GUM_SCALAR >::InvRefConstIterator

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

Definition at line 446 of file PRMInstance.h.

◆ InvRefIterator

template<typename GUM_SCALAR>
typedef NodeProperty< std::vector< std::pair< PRMInstance< GUM_SCALAR >*, std::string > >* >::iterator gum::prm::PRMInstance< GUM_SCALAR >::InvRefIterator

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

Definition at line 443 of file PRMInstance.h.

◆ iterator

template<typename GUM_SCALAR>
typedef NodeProperty< PRMAttribute< GUM_SCALAR >* >::iterator gum::prm::PRMInstance< GUM_SCALAR >::iterator

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

Definition at line 314 of file PRMInstance.h.

◆ pair

template<typename GUM_SCALAR>
typedef std::pair< PRMInstance< GUM_SCALAR >*, std::string > gum::prm::PRMInstance< GUM_SCALAR >::pair
private

Code alias.

Definition at line 521 of file PRMInstance.h.

Member Enumeration Documentation

◆ prm_type

enum 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 68 of file PRMObject.h.

68  : char
69  {
70  ALL,
71  CLASS,
72  PRM_INTERFACE,
73  CLASS_ELT,
74  TYPE,
75  SYSTEM,
76  INSTANCE
77  };

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 36 of file PRMInstance_tpl.h.

37  :
38  PRMObject(name),
39  instantiated__(false), type__(&type) {
40  GUM_CONSTRUCTOR(PRMInstance);
41 
42  // First we create attributes for each aggregate in type
43  for (const auto agg: type__->aggregates())
44  copyAggregates__(agg);
45 
46  // We add attributes in type by reference for inner ones and by copy for
47  // output ones
48  for (const auto attr: type__->attributes())
49  copyAttribute__(attr);
50  }
void copyAggregates__(PRMAggregate< GUM_SCALAR > *source)
Used at construction to instantiate aggregates.
PRMInstance(const std::string &name, PRMClass< GUM_SCALAR > &type)
Default constructor of an PRMInstance<GUM_SCALAR>.
const std::string & name() const
Returns the name of this object.
Definition: PRMObject_inl.h:34
PRMClass< GUM_SCALAR > & type()
Returns the type of this instance.
bool instantiated__
True if this instance has been instantiated.
Definition: PRMInstance.h:506
PRMClass< GUM_SCALAR > * type__
The type of this PRMInstance<GUM_SCALAR>.
Definition: PRMInstance.h:509
void copyAttribute__(PRMAttribute< GUM_SCALAR > *source)
Used at construction to instantiate attributes.
PRMObject(const std::string &name)
Constructor.
Definition: PRMObject.cpp:42

◆ ~PRMInstance()

template<typename GUM_SCALAR >
gum::prm::PRMInstance< GUM_SCALAR >::~PRMInstance ( )
virtual

Destructor.

Definition at line 53 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

53  {
54  GUM_DESTRUCTOR(PRMInstance);
55 
56  for (const auto& elt: nodeIdMap__)
57  delete elt.second;
58 
59  for (const auto& elt: referenceMap__)
60  delete elt.second;
61 
62  for (const auto& elt: referingAttr__)
63  delete elt.second;
64  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
PRMInstance(const std::string &name, PRMClass< GUM_SCALAR > &type)
Default constructor of an PRMInstance<GUM_SCALAR>.
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
NodeProperty< Set< PRMInstance< GUM_SCALAR > *> *> referenceMap__
Mapping between the gum::prm::PRMReferenceSlot and gum::prm::PRMSlotChain<GUM_SCALAR> in type__ / and...
Definition: PRMInstance.h:518
+ 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 260 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

261  :
262  PRMObject(source),
263  type__(source.type__) {
264  GUM_CONS_CPY(PRMInstance);
265  GUM_ERROR(FatalError, "do not copy Instance");
266  }
PRMInstance(const std::string &name, PRMClass< GUM_SCALAR > &type)
Default constructor of an PRMInstance<GUM_SCALAR>.
PRMClass< GUM_SCALAR > * type__
The type of this PRMInstance<GUM_SCALAR>.
Definition: PRMInstance.h:509
PRMObject(const std::string &name)
Constructor.
Definition: PRMObject.cpp:42
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

Member Function Documentation

◆ 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
idThe NodeId of a PRMReferenceSlot of this PRMInstance<GUM_SCALAR>.
instanceThe instance added as references by id in this PRMInstance<GUM_SCALAR>.
Exceptions
WrongClassElementRaised if id is not a valid PRMClassElement.
OutOfUpperBoundRaised if no more PRMInstance<GUM_SCALAR> can be added to id.
PRMTypeErrorRaised if instance's type isn't compatible with the reference's type.
NotFoundIf there is no PRMClassElement given id.

Definition at line 157 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

158  {
159  PRMClassElement< GUM_SCALAR >* elt = 0;
160 
161  try {
162  elt = &(type().get(id));
163  } catch (NotFound&) {
164  GUM_ERROR(NotFound, "no ClassElement<GUM_SCALAR> matches the given id");
165  }
166 
167  switch (elt->elt_type()) {
169  PRMReferenceSlot< GUM_SCALAR >* ref
170  = static_cast< PRMReferenceSlot< GUM_SCALAR >* >(elt);
171 
172  // Checking if instance's type is legal
173  if (!instance.type().isSubTypeOf(ref->slotType())) {
174  GUM_ERROR(PRMTypeError,
175  "given Instance type is not a proper "
176  "subclass of the ReferenceSlot<GUM_SCALAR> slot type");
177  }
178 
179  // Checking the reference's size limit
180  if (referenceMap__.exists(id)
181  && (!static_cast< PRMReferenceSlot< GUM_SCALAR >& >(type().get(id))
182  .isArray())
183  && (referenceMap__[id]->size() == 1)) {
184  GUM_ERROR(OutOfUpperBound,
185  "ReferenceSlot<GUM_SCALAR> size limit reached");
186  }
187 
188  break;
189  }
190 
192  PRMSlotChain< GUM_SCALAR >& sc
193  = static_cast< PRMSlotChain< GUM_SCALAR >& >(type().get(id));
194 
195  // Checking if instance's type is legal
196  if (!instance.type().isSubTypeOf(sc.end())) {
197  GUM_ERROR(PRMTypeError,
198  "given Instance type is not a proper "
199  "subclass of the ClassElementContainer pointed"
200  " by the SlotChain<GUM_SCALAR>");
201  }
202 
203  // Checking the reference's size limit
204  if (referenceMap__.exists(id)
205  && (!static_cast< PRMSlotChain< GUM_SCALAR >& >(type().get(id))
206  .isMultiple())
207  && (referenceMap__[id]->size() == 1)) {
208  GUM_ERROR(OutOfUpperBound, "SlotChain<GUM_SCALAR> size limit reached");
209  }
210 
211  break;
212  }
213 
214  default: {
215  if (!type().isOutputNode(*elt)) {
216  GUM_ERROR(WrongClassElement,
217  "given ClassElement<GUM_SCALAR> is not an output node");
218  }
219  }
220  }
221 
222  if (!referenceMap__.exists(id)) {
223  referenceMap__.insert(id, new Set< PRMInstance< GUM_SCALAR >* >());
224  }
225 
226  referenceMap__[id]->insert(&instance);
227  }
PRMClass< GUM_SCALAR > & type()
Returns the type of this instance.
Size size() const
Returns the number of attributes in 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...
Definition: PRMInstance.h:518
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ 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
scA slot chain pointing over an attribute in i.
iAn instance holding an attribute pointed by sc.

Definition at line 339 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

341  {
342  NodeId id = i->get(sc->lastElt().safeName()).id();
343  std::string name = sc->lastElt().safeName();
344 
345  try {
346  i->referenceMap__[id]->insert(this);
347  i->referingAttr__[id]->push_back(
348  std::make_pair(this, sc->lastElt().safeName()));
349  } catch (NotFound&) {
350  i->referenceMap__.insert(id, new Set< PRMInstance< GUM_SCALAR >* >());
351  i->referenceMap__[id]->insert(this);
352  i->referingAttr__.insert(id, new std::vector< pair >());
353  i->referingAttr__[id]->push_back(
354  std::make_pair(this, sc->lastElt().safeName()));
355  }
356  }
const std::string & name() const
Returns the name of this object.
Definition: PRMObject_inl.h:34
Size NodeId
Type for node ids.
Definition: graphElements.h:97
+ 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 395 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

395  {
396  return nodeIdMap__.begin();
397  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call 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 407 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

407  {
408  return nodeIdMap__.begin();
409  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call graph for this function:

◆ 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
idA gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR> in this PRMInstance<GUM_SCALAR> type.
Exceptions
NotFoundRaised if no gum::prm::PRMClassElement in this PRMInstance<GUM_SCALAR> type matches id.
WrongClassElementRaised if id is neither a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>.

Definition at line 419 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

419  {
420  try {
421  return PRMInstance< GUM_SCALAR >::RefIterator(*(referenceMap__[id]));
422  } catch (NotFound&) {
423  GUM_ERROR(NotFound, "no referred instances from this NodeId");
424  }
425  }
NodeProperty< Set< PRMInstance< GUM_SCALAR > *> *> referenceMap__
Mapping between the gum::prm::PRMReferenceSlot and gum::prm::PRMSlotChain<GUM_SCALAR> in type__ / and...
Definition: PRMInstance.h:518
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ 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
idA gum::prm::PRMReferenceSlot or gum::prm::PRMSlotChain<GUM_SCALAR> in this PRMInstance<GUM_SCALAR> type.
Exceptions
NotFoundRaised if no gum::prm::PRMClassElement in this PRMInstance<GUM_SCALAR> type matches id.
WrongClassElementRaised if id is neither a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR>.

Definition at line 429 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

429  {
430  try {
431  return PRMInstance< GUM_SCALAR >::RefConstIterator(*(referenceMap__[id]));
432  } catch (NotFound&) {
433  GUM_ERROR(NotFound, "no referred instances from this NodeId");
434  }
435  }
NodeProperty< Set< PRMInstance< GUM_SCALAR > *> *> referenceMap__
Mapping between the gum::prm::PRMReferenceSlot and gum::prm::PRMSlotChain<GUM_SCALAR> in type__ / and...
Definition: PRMInstance.h:518
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ 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 568 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

568  {
569  return referingAttr__.begin();
570  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
+ Here is the call 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 580 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

580  {
581  return referingAttr__.begin();
582  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
+ Here is the call graph for this function:

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

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

360  {
361  return bijection__;
362  }
Bijection< const DiscreteVariable *, const DiscreteVariable *> bijection__
A bijection used for MultiDim handling.
Definition: PRMInstance.h:528
+ 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 235 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

236  {
237  auto attr = new PRMScalarAttribute< GUM_SCALAR >(source->name(),
238  source->type(),
239  source->buildImpl());
240  GUM_ASSERT(&(attr->type().variable()) != &(source->type().variable()));
241  attr->setId(source->id());
242  nodeIdMap__.insert(attr->id(), attr);
243  bijection__.insert(&(source->type().variable()), &(attr->type().variable()));
244  }
Bijection< const DiscreteVariable *, const DiscreteVariable *> bijection__
A bijection used for MultiDim handling.
Definition: PRMInstance.h:528
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call 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
sourceAn attribute in type__.

Definition at line 247 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

248  {
249  auto attr
250  = new PRMScalarAttribute< GUM_SCALAR >(source->name(), source->type());
251  GUM_ASSERT(&(attr->type().variable()) != &(source->type().variable()));
252  // The potential is copied when instantiate() is called
253  attr->cpf().fill((GUM_SCALAR)0);
254  attr->setId(source->id());
255  bijection__.insert(&(source->type().variable()), &(attr->type().variable()));
256  nodeIdMap__.insert(attr->id(), attr);
257  }
Bijection< const DiscreteVariable *, const DiscreteVariable *> bijection__
A bijection used for MultiDim handling.
Definition: PRMInstance.h:528
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call 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
attrAn PRMAttribute<GUM_SCALAR> of this PRMInstance<GUM_SCALAR>.
Exceptions
OperationNotAllowedIf the MultiDimImplementation is of an unknown type.

Definition at line 609 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

610  {
611  const auto& type_attr = static_cast< const PRMAttribute< GUM_SCALAR >& >(
612  type().get(attr->safeName()));
613  attr->copyCpf(bijection(), type_attr);
614  GUM_ASSERT(attr->cpf().contains(attr->type().variable()));
615  }
PRMClass< GUM_SCALAR > & type()
Returns the type of this instance.
const Bijection< const DiscreteVariable *, const DiscreteVariable *> & bijection() const
Returns a mapping between DiscreteVariable used in this and the ones used in this PRMInstance<GUM_SCA...
+ 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 75 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

75  {
76  // First retrieving any referenced instance
77  for (const auto chain: type().slotChains()) {
79  }
80 
81  // Now we need to add referred instance to each input node
82  // For Attributes we first add parents, then we initialize CPF
83  for (const auto attr: type().attributes()) {
84  copyAttributeCPF__(nodeIdMap__[(*attr).id()]);
85  }
86 
87  // For PRMAggregate<GUM_SCALAR> we add parents
88  for (const auto agg: type().aggregates()) {
89  PRMAttribute< GUM_SCALAR >& attr = get(agg->safeName());
90 
91  for (const auto node: type().containerDag().parents(agg->id())) {
92  try {
93  attr.addParent(get(node));
94  } catch (NotFound&) {
95  auto elt = &(type().get(node));
96  auto sc = static_cast< PRMSlotChain< GUM_SCALAR >* >(elt);
97 
98  try {
99  const auto& instances = getInstances(sc->id());
100 
101  for (const auto inst: instances) {
102  attr.addParent(inst->get(sc->lastElt().safeName()));
103  }
104  } catch (NotFound&) { // there is no parents for this agg
105  }
106  }
107  }
108  }
109  }
void instantiateSlotChain__(PRMSlotChain< GUM_SCALAR > *sc)
Retrieve all instances referred by sc.
PRMClass< GUM_SCALAR > & type()
Returns the type of this instance.
void copyAttributeCPF__(PRMAttribute< GUM_SCALAR > *attr)
Copy the content of an PRMAttribute<GUM_SCALAR> from its Class<GUM_SCALAR> counterpart.
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
const Set< PRMInstance< GUM_SCALAR > *> & getInstances(NodeId id) const
Returns the Set of PRMInstance<GUM_SCALAR> referenced by id.
+ Here is the call 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 401 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

401  {
402  return nodeIdMap__.end();
403  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call 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 413 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

413  {
414  return nodeIdMap__.end();
415  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call graph for this function:

◆ 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 574 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

574  {
575  return referingAttr__.end();
576  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
+ Here is the call 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 586 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

586  {
587  return referingAttr__.end();
588  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
+ Here is the call graph for this function:

◆ enum2str()

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

Returns the string representation of a PRMObject.

Definition at line 83 of file PRMObject.h.

83  {
84  switch (type) {
85  case prm_type::CLASS:
86  return "PRMType::CLASS";
87 
89  return "PRMType::CLASS_ELT";
90 
91  case prm_type::TYPE:
92  return "PRMType::TYPE";
93 
94  case prm_type::SYSTEM:
95  return "PRMType::SYSTEM";
96 
97  case prm_type::INSTANCE:
98  return "PRMType::INSTANCE";
99 
101  return "PRMType::PRM_INTERFACE";
102 
103  default:
104  return "unknown";
105  }
106  }

◆ exists() [1/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 290 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

290  {
291  return nodeIdMap__.exists(id);
292  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call graph for this function:

◆ exists() [2/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 295 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

295  {
296  return type__->exists(name) && exists(type__->get(name).id());
297  }
const std::string & name() const
Returns the name of this object.
Definition: PRMObject_inl.h:34
bool exists(NodeId id) const
Returns true if id matches an PRMAttribute<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
PRMClass< GUM_SCALAR > * type__
The type of this PRMInstance<GUM_SCALAR>.
Definition: PRMInstance.h:509
+ Here is the call graph for this function:

◆ get() [1/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
idThe PRMAttribute<GUM_SCALAR> id.
Returns
Returns a constant reference on an PRMAttribute<GUM_SCALAR>.
Exceptions
NotFoundRaised if no PRMAttribute<GUM_SCALAR> matches name.

Definition at line 300 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

300  {
301  try {
302  return *(nodeIdMap__[id]);
303  } catch (NotFound&) {
304  GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given NodeId");
305  }
306  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ get() [2/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
nameThe PRMAttribute<GUM_SCALAR>'s name.
Returns
Returns a reference over the PRMAttribute<GUM_SCALAR>.
Exceptions
NotFoundRaised if there is no PRMAttribute<GUM_SCALAR> named n.

Definition at line 320 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

320  {
321  try {
322  return *(nodeIdMap__[type().get(name).id()]);
323  } catch (NotFound&) {
324  GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given name");
325  }
326  }
const std::string & name() const
Returns the name of this object.
Definition: PRMObject_inl.h:34
PRMClass< GUM_SCALAR > & type()
Returns the type of this instance.
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ get() [3/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
idThe PRMAttribute<GUM_SCALAR> id.
Returns
Returns a constant reference on an PRMAttribute<GUM_SCALAR>.
Exceptions
NotFoundRaised if no PRMAttribute<GUM_SCALAR> matches name.

Definition at line 310 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

310  {
311  try {
312  return *(nodeIdMap__[id]);
313  } catch (NotFound&) {
314  GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given NodeId");
315  }
316  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ get() [4/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
nameThe PRMClassElement's name.
Returns
Returns a constant reference over the PRMClassElement.
Exceptions
NotFoundRaised if there is no PRMClassElement named n.

Definition at line 330 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

330  {
331  try {
332  return *(nodeIdMap__[type().get(name).id()]);
333  } catch (NotFound&) {
334  GUM_ERROR(NotFound, "no PRMAttribute<GUM_SCALAR> with the given name");
335  }
336  }
const std::string & name() const
Returns the name of this object.
Definition: PRMObject_inl.h:34
PRMClass< GUM_SCALAR > & type()
Returns the type of this instance.
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ 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
idThe NodeId of a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR> in this PRMInstance<GUM_SCALAR>.
Exceptions
NotFoundRaised if there is no PRMClassElement given id.
UndefinedElementRaised if no PRMInstance<GUM_SCALAR> are referenced by id.

Definition at line 366 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

366  {
367  try {
368  if (referenceMap__[id]->size() > 0) {
369  return **(referenceMap__[id]->begin());
370  } else {
371  GUM_ERROR(UndefinedElement,
372  "no Instance associated with the given NodeId");
373  }
374  } catch (NotFound&) {
375  GUM_ERROR(NotFound,
376  "no ReferenceSlot<GUM_SCALAR> or SlotChain<GUM_SCALAR> "
377  "matches the given NodeId");
378  }
379  }
Size size() const
Returns the number of attributes in 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...
Definition: PRMInstance.h:518
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ 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
idThe NodeId of a PRMReferenceSlot or PRMSlotChain<GUM_SCALAR> in this.
Returns
Returns the Set of PRMInstance<GUM_SCALAR> referenced by id.
Exceptions
NotFoundIf there is no PRMClassElement given id.

Definition at line 383 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

383  {
384  try {
385  return *(referenceMap__[id]);
386  } catch (NotFound&) {
387  GUM_ERROR(NotFound,
388  "no ReferenceSlot<GUM_SCALAR> or SlotChain<GUM_SCALAR> "
389  "matches the given NodeId");
390  }
391  }
NodeProperty< Set< PRMInstance< GUM_SCALAR > *> *> referenceMap__
Mapping between the gum::prm::PRMReferenceSlot and gum::prm::PRMSlotChain<GUM_SCALAR> in type__ / and...
Definition: PRMInstance.h:518
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call 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 592 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

592  {
593  return *(referingAttr__[id]);
594  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
+ Here is the call 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 599 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

599  {
600  return *(referingAttr__[id]);
601  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
+ Here is the call graph for this function:

◆ 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
idA NodeId.
Returns
returns true if is has at least one referring PRMAttribute<GUM_SCALAR>.

Definition at line 604 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

604  {
605  return referingAttr__.exists(id) && (!referingAttr__[id]->empty());
606  }
NodeProperty< std::vector< pair > *> referingAttr__
The set of pair (instance, attribute) referring an attribute of this instance.
Definition: PRMInstance.h:525
+ Here is the call graph for this function:

◆ 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 67 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

67  {
68  if (!instantiated__) {
69  instantiated__ = true;
71  }
72  }
void doInstantiate__()
Starts this instance instantiations.
bool instantiated__
True if this instance has been instantiated.
Definition: PRMInstance.h:506
+ Here is the call 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
scA slot chain of this instance's type.
Exceptions
NotFoundRaised if a reference in sc is not instantiated.

Definition at line 112 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

113  {
114  auto first_id = sc->chain()[0]->id();
115  if (!referenceMap__.exists(first_id)) { return; }
116  auto set
117  = new Set< PRMInstance< GUM_SCALAR >* >(*(referenceMap__[first_id]));
118  // We proceed with a width-first run of the slot chain
119  for (Size idx = 1; idx < sc->chain().size() - 1; ++idx) {
120  auto temp = new Set< PRMInstance< GUM_SCALAR >* >();
121  for (auto current: *set) {
122  auto& ref = current->type().get(sc->chain()[idx]->name());
123  for (auto next: *(current->referenceMap__[ref.id()])) {
124  temp->insert(next);
125  }
126  }
127  delete set;
128  set = temp;
129  }
130 
131  GUM_ASSERT(set->size() > 0);
132  // set contains all the instances references by sc
133  if (referenceMap__.exists(sc->id())) {
134  delete referenceMap__[sc->id()];
135  referenceMap__[sc->id()] = set;
136  } else {
137  referenceMap__.insert(sc->id(), set);
138  }
139 
140  // Add refering instances
141  for (auto i: *set) {
142  addReferingInstance__(sc, i);
143  }
144 
145  // If sc is not multiple so it can be added as a parent of an attribute
146  if (!sc->isMultiple()) {
147  // We should have only one instance
148  // Less ugly way to get the single instance in set
149  for (auto instance: *set) {
150  auto& attr = instance->get(sc->lastElt().safeName());
151  bijection__.insert(&(sc->type().variable()), &(attr.type().variable()));
152  }
153  }
154  }
Bijection< const DiscreteVariable *, const DiscreteVariable *> bijection__
A bijection used for MultiDim handling.
Definition: PRMInstance.h:528
void addReferingInstance__(PRMSlotChain< GUM_SCALAR > *sc, PRMInstance< GUM_SCALAR > *i)
Add this as a referring instance over the attribute pointed by sc in i.
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition: types.h:47
NodeProperty< Set< PRMInstance< GUM_SCALAR > *> *> referenceMap__
Mapping between the gum::prm::PRMReferenceSlot and gum::prm::PRMSlotChain<GUM_SCALAR> in type__ / and...
Definition: PRMInstance.h:518
+ Here is the call graph for this function:

◆ isClass()

static INLINE bool gum::prm::PRMObject::isClass ( const PRMObject obj)
inlinestaticinherited

Returns true if obj_ptr is of type Class.

Definition at line 109 of file PRMObject.h.

References gum::prm::PRMObject::PRMObject().

109  {
110  return obj.obj_type() == prm_type::CLASS;
111  }
+ Here is the call graph for this function:

◆ isInstance()

static INLINE bool gum::prm::PRMObject::isInstance ( const PRMObject obj)
inlinestaticinherited

Returns true if obj_ptr is of type PRMInstance.

Definition at line 119 of file PRMObject.h.

References gum::prm::PRMObject::PRMObject().

119  {
120  return obj.obj_type() == prm_type::INSTANCE;
121  }
+ Here is the call graph for this function:

◆ isInterface()

static INLINE bool gum::prm::PRMObject::isInterface ( const PRMObject obj)
inlinestaticinherited

Returns true if obj_ptr is of type PRMInterface.

Definition at line 114 of file PRMObject.h.

References gum::prm::PRMObject::PRMObject().

114  {
115  return obj.obj_type() == prm_type::PRM_INTERFACE;
116  }
+ Here is the call graph for this function:

◆ LEFT_CAST()

static 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 79 of file PRMObject.h.

79 { return "("; }

◆ name() [1/2]

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

Returns the name of this object.

Definition at line 34 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

34 { return name__; }
std::string name__
Definition: PRMObject.h:207
+ Here is the call graph for this function:

◆ 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 38 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

38 { name__ = name; }
std::string name__
Definition: PRMObject.h:207
const std::string & name() const
Returns the name of this object.
Definition: PRMObject_inl.h:34
+ 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 275 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

+ Here is the call graph for this function:

◆ 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 48 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

48  {
49  return name__ != obj.name();
50  }
std::string name__
Definition: PRMObject.h:207
+ 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 270 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

270  {
271  GUM_ERROR(FatalError, "do not copy Instance");
272  }
#define GUM_ERROR(type, msg)
Definition: exceptions.h:54
+ Here is the call graph for this function:

◆ 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 42 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

42  {
43  return name__ == obj.name();
44  }
std::string name__
Definition: PRMObject.h:207
+ Here is the call graph for this function:

◆ RIGHT_CAST()

static 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 80 of file PRMObject.h.

80 { return ")"; }

◆ 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 230 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

230  {
231  return nodeIdMap__.size();
232  }
NodeProperty< PRMAttribute< GUM_SCALAR > *> nodeIdMap__
The gum::prm::PRMAttribute<GUM_SCALAR> and gum::prm::PRMAggregate<GUM_SCALAR> of this PRMInstance<GUM...
Definition: PRMInstance.h:513
+ Here is the call 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 280 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

280  {
281  return *type__;
282  }
PRMClass< GUM_SCALAR > * type__
The type of this PRMInstance<GUM_SCALAR>.
Definition: PRMInstance.h:509
+ Here is the call graph for this function:

◆ 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 285 of file PRMInstance_tpl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

285  {
286  return *type__;
287  }
PRMClass< GUM_SCALAR > * type__
The type of this PRMInstance<GUM_SCALAR>.
Definition: PRMInstance.h:509
+ Here is the call graph for this function:

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 528 of file PRMInstance.h.

◆ instantiated__

template<typename GUM_SCALAR>
bool gum::prm::PRMInstance< GUM_SCALAR >::instantiated__
private

True if this instance has been instantiated.

Definition at line 506 of file PRMInstance.h.

◆ 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 513 of file PRMInstance.h.

◆ 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 518 of file PRMInstance.h.

◆ 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 525 of file PRMInstance.h.

◆ 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 509 of file PRMInstance.h.


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