aGrUM 3.0.0
a C++ library for (probabilistic) graphical models
gum::BayesNet< GUM_SCALAR > Class Template Reference

Class representing a Bayesian network. More...

#include <agrum/BN/BayesNet.h>

Inheritance diagram for gum::BayesNet< GUM_SCALAR >:
Collaboration diagram for gum::BayesNet< GUM_SCALAR >:

Public Member Functions

NodeId addNoisyAND (const DiscreteVariable &var, GUM_SCALAR external_weight, NodeId id)
 Add a variable, its associate node and a noisyAND implementation.
NodeId addNoisyAND (const DiscreteVariable &var, GUM_SCALAR external_weight)
 Add a variable, its associate node and a noisyAND implementation.
NodeId addLogit (const DiscreteVariable &var, GUM_SCALAR external_weight, NodeId id)
 Add a variable, its associate node and a Logit implementation.
NodeId addLogit (const DiscreteVariable &var, GUM_SCALAR external_weight)
 Add a variable, its associate node and a Logit implementation.
NodeId addOR (const DiscreteVariable &var)
 Add a variable, it's associate node and an OR implementation.
NodeId addAND (const DiscreteVariable &var)
 Add a variable, it's associate node and an AND implementation.
void addWeightedArc (NodeId tail, NodeId head, GUM_SCALAR causalWeight)
 Add an arc in the BN, and update arc.head's CPT.
void addWeightedArc (std::string_view tail, std::string_view head, GUM_SCALAR causalWeight)
 Add an arc in the BN, and update arc.head's CPT.
void generateCPTs () const
 randomly generates CPTs for a given structure
void generateCPT (NodeId node) const
 randomly generate CPT for a given node in a given structure
void generateCPT (std::string_view name) const
void changeTensor (NodeId id, Tensor< GUM_SCALAR > *newPot)
 change the CPT associated to nodeId to newPot delete the old CPT associated to nodeId.
void changeTensor (std::string_view name, Tensor< GUM_SCALAR > *newPot)
BayesNet< GUM_SCALAR > contextualize (const gum::Instantiation &observations, const gum::Instantiation &interventions) const
 create a contextual BN from this and a set of hard observations and hard interventions.
NodeId idFromName (std::string_view name) const override
 Returns the NodeId of a variable given its name.
const VariableNodeMapvariableNodeMap () const override
 Returns a constant reference to the VariableNodeMap of this model.
const DiscreteVariablevariable (NodeId id) const override
 Returns a constant reference over a variable given its node id.
NodeId nodeId (const DiscreteVariable &var) const override
 Returns the NodeId of a variable.
const DiscreteVariablevariableFromName (std::string_view name) const override
 Returns a constant reference over a variable given its name.
std::vector< std::string > check () const
 Check if the BayesNet is consistent (variables, CPT).
bool operator== (const IBayesNet< GUM_SCALAR > &from) const
 This operator compares 2 BNs !
Size dim () const
 Returns the dimension (the number of free parameters) in this bayes net.
Size maxVarDomainSize () const
GUM_SCALAR minParam () const
GUM_SCALAR maxParam () const
GUM_SCALAR minNonZeroParam () const
GUM_SCALAR maxNonOneParam () const
virtual std::string toDot () const
std::string toString () const
Tensor< GUM_SCALAR > evEq (std::string_view name, double value) const
Tensor< GUM_SCALAR > evIn (std::string_view name, double val1, double val2) const
Tensor< GUM_SCALAR > evLt (std::string_view name, double value) const
Tensor< GUM_SCALAR > evGt (std::string_view name, double value) const
Size memoryFootprint () const
 compute the (approximated) footprint in memory of the model (the footprints of CPTs)
bool hasSameStructure (const DAGmodel &other) const
NodeSet minimalCondSet (NodeId target, const NodeSet &soids) const
NodeSet minimalCondSet (const NodeSet &targets, const NodeSet &soids) const
NodeSet minimalCondSet (std::string_view target, const std::vector< std::string > &soids) const
NodeSet minimalCondSet (const std::vector< std::string > &targets, const std::vector< std::string > &soids) const
const DAGinternalDag () const
 Returns a const reference to the internal (unnamed) DAG. O(1), no copy. Use for stable references or pointers (e.g. graph listeners). For named node access, use dag() instead.
double log10DomainSize () const
Constructors and Destructor
 BayesNet ()
 Default constructor.
 BayesNet (std::string_view name)
 Default constructor.
 ~BayesNet () override
 Destructor.
 BayesNet (const BayesNet< GUM_SCALAR > &source)
 Copy constructor.
 BayesNet (BayesNet< GUM_SCALAR > &&source)
 Move constructor.
Operators
BayesNet< GUM_SCALAR > & operator= (const BayesNet< GUM_SCALAR > &source)
 Copy operator.
BayesNet< GUM_SCALAR > & operator= (BayesNet< GUM_SCALAR > &&source)
 Move operator.
Variable manipulation methods
const Tensor< GUM_SCALAR > & cpt (NodeId varId) const final
 Returns the CPT of a variable.
const Tensor< GUM_SCALAR > & cpt (std::string_view name) const
 Returns the CPT of a variable.
NodeId add (const DiscreteVariable &var)
 Add a variable to the gum::BayesNet.
NodeId add (std::string_view fast_description, unsigned int default_nbrmod=2)
 Use "fast" syntax to add a variable in the BayesNet.
NodeId add (const DiscreteVariable &var, MultiDimImplementation< GUM_SCALAR > *aContent)
 Add a variable to the gum::BayesNet.
NodeId add (const DiscreteVariable &var, NodeId id)
 Add a variable to the gum::BayesNet.
NodeId add (const DiscreteVariable &var, MultiDimImplementation< GUM_SCALAR > *aContent, NodeId id)
 Add a variable to the gum::BayesNet.
void clear ()
 clear the whole Bayes net *
void erase (NodeId varId)
 Remove a variable from the gum::BayesNet.
void erase (std::string_view name)
 Removes a variable from the gum::BayesNet.
void erase (const DiscreteVariable &var)
 Remove a variable from the gum::BayesNet.
const DiscreteVariablevariable (std::string_view name) const
 Returns a gum::DiscreteVariable given its name in the gum::BayesNet.
void changeVariableName (NodeId id, std::string_view new_name)
 Changes a variable's name in the gum::BayesNet.
void changeVariableName (std::string_view name, std::string_view new_name)
 Changes a variable's name.
void changeVariableLabel (NodeId id, std::string_view old_label, std::string_view new_label)
 Changes a variable's label in the gum::BayesNet.
void changeVariableLabel (std::string_view name, std::string_view old_label, std::string_view new_label)
 Changes a variable's name.
Arc manipulation methods.
void addArc (NodeId tail, NodeId head)
 Add an arc in the BN, and update arc.head's CPT.
void addArc (std::string_view tail, std::string_view head)
 Add an arc in the BN, and update arc.head's CPT.
void eraseArc (const Arc &arc)
 Removes an arc in the BN, and update head's CTP.
void eraseArc (NodeId tail, NodeId head)
 Removes an arc in the BN, and update head's CTP.
void eraseArc (std::string_view tail, std::string_view head)
 Removes an arc in the BN, and update head's CTP.
void beginTopologyTransformation ()
 When inserting/removing arcs, node CPTs change their dimension with a cost in time.
void endTopologyTransformation ()
 terminates a sequence of insertions/deletions of arcs by adjusting all CPTs dimensions.
void reverseArc (NodeId tail, NodeId head)
 Reverses an arc while preserving the same joint distribution.
void reverseArc (std::string_view tail, std::string_view head)
 Reverses an arc while preserving the same joint distribution.
void reverseArc (const Arc &arc)
 Reverses an arc while preserving the same joint distribution.
Accessors for nodes with CI or logical implementation
NodeId addNoisyOR (const DiscreteVariable &var, GUM_SCALAR external_weight)
 Add a variable, it's associate node and a gum::noisyOR implementation.
NodeId addNoisyORNet (const DiscreteVariable &var, GUM_SCALAR external_weight)
 Add a variable, it's associate node and a gum::noisyOR implementation.
NodeId addNoisyORCompound (const DiscreteVariable &var, GUM_SCALAR external_weight)
 Add a variable, it's associate node and a gum::noisyOR implementation.
NodeId addNoisyOR (const DiscreteVariable &var, GUM_SCALAR external_weight, NodeId id)
 Add a variable, its associate node and a noisyOR implementation.
NodeId addNoisyORNet (const DiscreteVariable &var, GUM_SCALAR external_weight, NodeId id)
 Add a variable, its associate node and a noisyOR implementation.
NodeId addNoisyORCompound (const DiscreteVariable &var, GUM_SCALAR external_weight, NodeId id)
 Add a variable, its associate node and a noisyOR implementation.
NodeId addAMPLITUDE (const DiscreteVariable &var)
 Others aggregators.
NodeId addCOUNT (const DiscreteVariable &var, Idx value=1)
 Others aggregators.
NodeId addEXISTS (const DiscreteVariable &var, Idx value=1)
 Others aggregators.
NodeId addFORALL (const DiscreteVariable &var, Idx value=1)
 Others aggregators.
NodeId addMAX (const DiscreteVariable &var)
 Others aggregators.
NodeId addMEDIAN (const DiscreteVariable &var)
 Others aggregators.
NodeId addMIN (const DiscreteVariable &var)
 Others aggregators.
NodeId addSUM (const DiscreteVariable &var)
 Others aggregators.
Joint Probability manipulation methods
GUM_SCALAR jointProbability (const Instantiation &i) const
 Compute a parameter of the joint probability for the BN (given an instantiation of the vars).
GUM_SCALAR log2JointProbability (const Instantiation &i) const
 Compute a parameter of the log joint probability for the BN (given an instantiation of the vars).
Variable manipulation methods.
DAG dag () const
 Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding variable.
Size size () const final
 Returns the number of variables in this Directed Graphical Model.
Size sizeArcs () const
 Returns the number of arcs in this Directed Graphical Model.
const NodeGraphPartnodes () const final
 Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding variable.
bool exists (NodeId node) const final
 Return true if this node exists in this graphical model.
bool exists (std::string_view name) const final
 Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding variable.
Arc manipulation methods.
const ArcSetarcs () const
 return true if the arc tail->head exists in the DAGmodel
bool existsArc (const NodeId tail, const NodeId head) const
 return true if the arc tail->head exists in the DAGmodel
bool existsArc (std::string_view nametail, std::string_view namehead) const
 return true if the arc tail->head exists in the DAGmodel
const NodeSetparents (const NodeId id) const
 returns the set of nodes with arc ingoing to a given node
const NodeSetparents (std::string_view name) const
 return true if the arc tail->head exists in the DAGmodel
NodeSet parents (const NodeSet &ids) const
 returns the parents of a set of nodes
NodeSet parents (const std::vector< std::string > &names) const
 return true if the arc tail->head exists in the DAGmodel
NodeSet family (const NodeId id) const final
 returns the parents of a node and the node
NodeSet family (std::string_view name) const final
 return true if the arc tail->head exists in the DAGmodel
const NodeSetchildren (const NodeId id) const
 returns the set of nodes with arc outgoing from a given node
const NodeSetchildren (std::string_view name) const
 return true if the arc tail->head exists in the DAGmodel
NodeSet children (const NodeSet &ids) const
 returns the children of a set of nodes
NodeSet children (const std::vector< std::string > &names) const
 return true if the arc tail->head exists in the DAGmodel
NodeSet descendants (const NodeId id) const
 returns the set of nodes with directed path outgoing from a given node
NodeSet descendants (std::string_view name) const
 return true if the arc tail->head exists in the DAGmodel
NodeSet ancestors (const NodeId id) const
 returns the set of nodes with directed path ingoing to a given node
NodeSet ancestors (std::string_view name) const
 return true if the arc tail->head exists in the DAGmodel
Graphical methods
UndiGraph moralizedAncestralGraph (const NodeSet &nodes) const
 build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes
UndiGraph moralizedAncestralGraph (const std::vector< std::string > &nodenames) const
 build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes
bool isIndependent (NodeId X, NodeId Y, const NodeSet &Z) const final
 check if node X and node Y are independent given nodes Z
bool isIndependent (const NodeSet &X, const NodeSet &Y, const NodeSet &Z) const final
 check if nodes X and nodes Y are independent given nodes Z
bool isIndependent (std::string_view Xname, std::string_view Yname, const std::vector< std::string > &Znames) const
 build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes
bool isIndependent (const std::vector< std::string > &Xnames, const std::vector< std::string > &Ynames, const std::vector< std::string > &Znames) const
 build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes
UndiGraph moralGraph () const
 The node's id are coherent with the variables and nodes of the topology.
Sequence< NodeIdtopologicalOrder () const
 The topological order stays the same as long as no variable or arcs are added or erased src the topology.
NodeProperty< NodeIdconnectedComponents () const
 Returns the weakly connected components of the underlying DAG. Each node maps to the id of its component root.
Getter and setters
const std::string & property (std::string_view name) const
 Return the value of the property name of this GraphicalModel.
const std::string & propertyWithDefault (std::string_view name, const std::string &byDefault) const
 Return the value of the property name of this GraphicalModel.
void setProperty (std::string_view name, std::string_view value)
 Add or change a property of this GraphicalModel.
std::vector< std::string > properties () const
 List of all the names of property in the Graphical model.
bool existsProperty (std::string_view name) const
 check wether a property exists in this GraphicalModel
void updateMetaData ()
 update the meta data of this Graphical Model (version, creation date, last modification date) This method is called by the writers ONLY before writing the model to a file.
Variable manipulation methods.
virtual bool empty () const
 Return true if this graphical model is empty.
std::vector< std::string > names (const std::vector< NodeId > &ids) const
 transform a vector of NodeId in a vector of names
std::vector< std::string > names (const NodeSet &ids) const
 transform a NodeSet in a vector of names
std::vector< NodeIdids (const std::vector< std::string > &names) const
 transform a vector of names into a vector of nodeId
NodeSet nodeset (const std::vector< std::string > &names) const
 transform a vector of names into a NodeSet
gum::VariableSet variables (const std::vector< std::string > &l) const
 transform a vector of names into a VariableeSet
gum::VariableSet variables (const NodeSet &ids) const
 transform a vector of NodeId into a VariableeSet
Instantiation completeInstantiation () const
 Get an instantiation over all the variables of the model.

Static Public Member Functions

static BayesNet< GUM_SCALAR > fastPrototype (std::string_view dotlike, Size domainSize)
 Create a Bayesian network with a dot-like syntax which specifies:
static BayesNet< GUM_SCALAR > fastPrototype (std::string_view dotlike, std::string_view domainSize="[2]")
static std::string spaceCplxToString (double dSize, int dim, Size usedMem)
 send to the stream the space complexity with 3 parametrs

Protected Member Functions

void _nameNodes_ (NodeGraphPart &g) const
 Names every node of g using variable(id).name() for each node id in g.

Protected Attributes

DAG dag_
 The DAG of this Directed Graphical Model.
VariableNodeMap varMap_
 Mapping between NodeIds and discrete variables.

Private Member Functions

void _clearTensors_ ()
 clear all tensors
void _copyTensors_ (const BayesNet< GUM_SCALAR > &source)
 copy of tensors from a BN to another, using names of vars as ref.
void _unsafeChangeTensor_ (NodeId id, Tensor< GUM_SCALAR > *newPot)
 change the CPT associated to nodeId to newPot delete the old CPT associated to nodeId.
const HashTable< std::string, std::string > & _properties_ () const
 Return the properties of this Directed Graphical Model.

Private Attributes

NodeProperty< Tensor< GUM_SCALAR > * > _probaMap_
 Mapping between the variable's id and their CPT.
HashTable< std::string, std::string > _propertiesMap_
 The properties of this Directed Graphical Model.

Friends

class BayesNetFactory< GUM_SCALAR >

Detailed Description

template<GUM_Numeric GUM_SCALAR>
class gum::BayesNet< GUM_SCALAR >

Class representing a Bayesian network.

Bayesian networks are a probabilistic graphical model in which nodes are random variables and the probability distribution is defined by the product:

\(P(X_1, \ldots, X_n) = \prod_{i=1}^{n} P(X_i | \pi(X_i))\),

where \(\pi(X_i)\) is the parent of \(X_i\).

The probability distribution can be represented as a directed acyclic graph (DAG) where:

  • Nodes are discrete random variables.
  • An arc A -> B represent a dependency between variables A and B, i.e. B conditional probability distribution is defined as \(P(B| \pi(B)\).

After a variable is added to the BN, it's domain cannot change. But it arcs are added, the data in its CPT are lost.

You should look a the gum::BayesNetFactory class which can help build Bayesian networks.

You can print a BayesNet using gum::operator<<(std::ostream&, const BayesNet<GUM_SCALAR>&).

Definition at line 93 of file BayesNet.h.

Constructor & Destructor Documentation

◆ BayesNet() [1/4]

template<GUM_Numeric GUM_SCALAR>
gum::BayesNet< GUM_SCALAR >::BayesNet ( )

Default constructor.

Definition at line 128 of file BayesNet_tpl.h.

130 }
Class representing a Bayesian network.
Definition BayesNet.h:93
BayesNet()
Default constructor.
IBayesNet()
Default constructor.

References BayesNet(), and gum::IBayesNet< GUM_SCALAR >::IBayesNet().

Referenced by BayesNet(), BayesNet(), BayesNet(), BayesNet(), ~BayesNet(), addMAX(), and operator=().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ BayesNet() [2/4]

template<GUM_Numeric GUM_SCALAR>
gum::BayesNet< GUM_SCALAR >::BayesNet ( std::string_view name)
explicit

Default constructor.

Parameters
nameThe BayesNet's name.

Definition at line 133 of file BayesNet_tpl.h.

References BayesNet(), and gum::IBayesNet< GUM_SCALAR >::IBayesNet().

Here is the call graph for this function:

◆ ~BayesNet()

template<GUM_Numeric GUM_SCALAR>
gum::BayesNet< GUM_SCALAR >::~BayesNet ( )
override

Destructor.

Definition at line 175 of file BayesNet_tpl.h.

175 {
177 for (const auto& p: _probaMap_) {
178 delete p.second;
179 }
180 }
NodeProperty< Tensor< GUM_SCALAR > * > _probaMap_
Mapping between the variable's id and their CPT.
Definition BayesNet.h:639

References BayesNet(), and _probaMap_.

Here is the call graph for this function:

◆ BayesNet() [3/4]

template<GUM_Numeric GUM_SCALAR>
gum::BayesNet< GUM_SCALAR >::BayesNet ( const BayesNet< GUM_SCALAR > & source)

Copy constructor.

Definition at line 138 of file BayesNet_tpl.h.

138 :
141
143 }
void _copyTensors_(const BayesNet< GUM_SCALAR > &source)
copy of tensors from a BN to another, using names of vars as ref.

References BayesNet(), gum::IBayesNet< GUM_SCALAR >::IBayesNet(), and _copyTensors_().

Here is the call graph for this function:

◆ BayesNet() [4/4]

template<GUM_Numeric GUM_SCALAR>
gum::BayesNet< GUM_SCALAR >::BayesNet ( BayesNet< GUM_SCALAR > && source)

Move constructor.

Definition at line 146 of file BayesNet_tpl.h.

References BayesNet(), gum::IBayesNet< GUM_SCALAR >::IBayesNet(), and _probaMap_.

Here is the call graph for this function:

Member Function Documentation

◆ _clearTensors_()

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::_clearTensors_ ( )
private

clear all tensors

Definition at line 557 of file BayesNet_tpl.h.

557 {
558 // Removing previous tensors
559 for (const auto& elt: _probaMap_) {
560 delete elt.second;
561 }
562
563 _probaMap_.clear();
564 }

References _probaMap_.

Referenced by operator=().

Here is the caller graph for this function:

◆ _copyTensors_()

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::_copyTensors_ ( const BayesNet< GUM_SCALAR > & source)
private

copy of tensors from a BN to another, using names of vars as ref.

Definition at line 568 of file BayesNet_tpl.h.

568 {
569 // Copying tensors
570
571 for (const auto& src: source._probaMap_) {
572 // First we build the node's CPT
573 auto copy_array = new Tensor< GUM_SCALAR >();
574 copy_array->beginMultipleChanges();
575 for (gum::Idx i = 0; i < src.second->nbrDim(); i++) {
576 (*copy_array) << variableFromName(src.second->variable(i).name());
577 }
578 copy_array->endMultipleChanges();
579 copy_array->copyFrom(*(src.second));
580
581 // We add the CPT to the CPT hashmap
582 _probaMap_.insert(src.first, copy_array);
583 }
584 }
const DiscreteVariable & variable(std::string_view name) const
Returns a gum::DiscreteVariable given its name in the gum::BayesNet.
const DiscreteVariable & variableFromName(std::string_view name) const override
Returns a constant reference over a variable given its name.
const std::string & name() const
returns the name of the variable

Referenced by BayesNet(), and operator=().

Here is the caller graph for this function:

◆ _nameNodes_()

INLINE void gum::GraphicalModel::_nameNodes_ ( NodeGraphPart & g) const
protectedinherited

Names every node of g using variable(id).name() for each node id in g.

Call this before returning any newly constructed graph from a model method.

Definition at line 175 of file graphicalModel_inl.h.

175 {
176 for (auto id: g)
177 g.setName(id, variable(id).name());
178 }
virtual const DiscreteVariable & variable(NodeId id) const =0
Returns a constant reference over a variable given it's node id.

References gum::NodeGraphPart::setName(), and variable().

Referenced by gum::DAGmodel::dag(), gum::UGmodel::graph(), gum::DAGmodel::moralGraph(), and gum::DAGmodel::moralizedAncestralGraph().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ _properties_()

INLINE const HashTable< std::string, std::string > & gum::GraphicalModel::_properties_ ( ) const
privateinherited

Return the properties of this Directed Graphical Model.

Definition at line 67 of file graphicalModel_inl.h.

67 {
68 return _propertiesMap_;
69 }
HashTable< std::string, std::string > _propertiesMap_
The properties of this Directed Graphical Model.

References _propertiesMap_.

Referenced by property().

Here is the caller graph for this function:

◆ _unsafeChangeTensor_()

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::_unsafeChangeTensor_ ( NodeId id,
Tensor< GUM_SCALAR > * newPot )
private

change the CPT associated to nodeId to newPot delete the old CPT associated to nodeId.

Warning
no verification of dimensions are performer
See also
changeTensor

Definition at line 620 of file BayesNet_tpl.h.

620 {
621 delete _probaMap_[id];
623 }

References _probaMap_.

◆ add() [1/5]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::add ( const DiscreteVariable & var)

Add a variable to the gum::BayesNet.

Add a gum::DiscreteVariable, it's associated gum::NodeId and it's gum::Tensor.

The variable is added by copy to the gum::BayesNet. The variable's gum::Tensor implementation will be a gum::MultiDimArray.

Parameters
varThe variable added by copy.
Returns
Returns the variable's id in the gum::BayesNet.
Exceptions
DuplicateLabelRaised if variable.name() is already used in this gum::BayesNet.

Definition at line 201 of file BayesNet_tpl.h.

201 {
202 auto ptr = new MultiDimArray< GUM_SCALAR >();
203 try {
204 return add(var, ptr);
205 } catch (Exception const&) {
206 delete ptr;
207 throw;
208 }
209 }
NodeId add(const DiscreteVariable &var)
Add a variable to the gum::BayesNet.

References add().

Referenced by add(), add(), add(), add(), addAMPLITUDE(), addAND(), addCOUNT(), addEXISTS(), addLogit(), addMAX(), addMEDIAN(), addMIN(), addNoisyAND(), addNoisyAND(), addNoisyORCompound(), addNoisyORNet(), addNoisyORNet(), addOR(), addSUM(), gum::build_node(), and gum::BayesNetFragment< GUM_SCALAR >::toBN().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ add() [2/5]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::add ( const DiscreteVariable & var,
MultiDimImplementation< GUM_SCALAR > * aContent )

Add a variable to the gum::BayesNet.

Add a gum::DiscreteVariable, it's associated gum::NodeId and it's gum::Tensor.

The variable is added by copy to the gum::BayesNet.

Parameters
varThe variable added by copy.
aContentThe gum::MultiDimImplementation to use for this variable's gum::Tensor implementation.
Returns
Returns the variable's id in the gum::BayesNet.
Exceptions
DuplicateLabelRaised if variable.name() is already used in this gum::BayesNet.

Definition at line 220 of file BayesNet_tpl.h.

221 {
222 NodeId proposedId = dag().nextNodeId();
223
224 return add(var, aContent, proposedId);
225 }
DAG dag() const
Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding vari...

References add(), and gum::DAGmodel::dag().

Here is the call graph for this function:

◆ add() [3/5]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::add ( const DiscreteVariable & var,
MultiDimImplementation< GUM_SCALAR > * aContent,
NodeId id )

Add a variable to the gum::BayesNet.

Add a gum::DiscreteVariable, it's associated gum::NodeId and it's gum::Tensor.

Parameters
varThe variable added by copy.
aContentThe gum::MultiDimImplementation to use for this variable's gum::Tensor implementation.
idThe variable's forced gum::NodeId in the gum::BayesNet.
Returns
Returns the variable's id in the gum::BayesNet.
Exceptions
DuplicateElementRaised id is already used.
DuplicateLabelRaised if variable.name() is already used in this gum::BayesNet.

Definition at line 240 of file BayesNet_tpl.h.

242 {
243 this->varMap_.insert(id, var);
244 this->dag_.addNodeWithId(id);
245
247 (*cpt) << variable(id);
248 _probaMap_.insert(id, cpt);
249 return id;
250 }
const Tensor< GUM_SCALAR > & cpt(NodeId varId) const final
Returns the CPT of a variable.
DAG dag_
The DAG of this Directed Graphical Model.
Definition DAGmodel.h:284
VariableNodeMap varMap_
Mapping between NodeIds and discrete variables.

References _probaMap_, cpt(), gum::DAGmodel::dag_, variable(), and gum::DiscreteGraphicalModel::varMap_.

Here is the call graph for this function:

◆ add() [4/5]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::add ( const DiscreteVariable & var,
NodeId id )

Add a variable to the gum::BayesNet.

Add a gum::DiscreteVariable, it's associated gum::NodeId and it's gum::Tensor.

The variable is added by copy to the gum::BayesNet. The variable's gum::Tensor implementation will be a gum::MultiDimArray.

Parameters
varThe variable added by copy.
idThe variable's forced gum::NodeId in the gum::BayesNet.
Returns
Returns the variable's id in the gum::BayesNet.
Exceptions
DuplicateElementRaised id is already used.
DuplicateLabelRaised if variable.name() is already used in this gum::BayesNet.

Definition at line 228 of file BayesNet_tpl.h.

228 {
229 auto ptr = new MultiDimArray< GUM_SCALAR >();
230
231 try {
232 return add(var, ptr, id);
233 } catch (Exception const&) {
234 delete ptr;
235 throw;
236 }
237 }

References add().

Here is the call graph for this function:

◆ add() [5/5]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::add ( std::string_view fast_description,
unsigned int default_nbrmod = 2 )

Use "fast" syntax to add a variable in the BayesNet.

  • a : range variable from 0 to default_nbrmod-1
  • a[5] : range variable from 0 to 5
  • a[-3,5] : range variable from -3 to 5
  • a[1,3.14,5,3] : discretized variable
  • a{x|y|z} : labelized variable
  • a{-3|0|3|100} : integer variable
Parameters
fast_description(str) following "fast" syntax description
default_nbrmod(int) nbr of modality if fast_description do not indicate it. default_nbrmod=1 is the way to create a variable with only one value (for instance for reward in influence diagram).
Exceptions
DuplicateLabelRaised if variable.name() is already used in this gum::BayesNet.
NotAllowedif nbrmod<2

Definition at line 212 of file BayesNet_tpl.h.

213 {
215 if (v->domainSize() < 2) GUM_ERROR(OperationNotAllowed, v->name() << " has a domain size <2")
216 return add(*v);
217 }
#define GUM_ERROR(type, msg)
Definition exceptions.h:76

References add(), gum::fastVariable(), and GUM_ERROR.

Here is the call graph for this function:

◆ addAMPLITUDE()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addAMPLITUDE ( const DiscreteVariable & var)

Others aggregators.

Definition at line 397 of file BayesNet_tpl.h.

397 {
399 }

References add().

Here is the call graph for this function:

◆ addAND()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addAND ( const DiscreteVariable & var)

Add a variable, it's associate node and an AND implementation.

The id of the new variable is automatically generated.

Warning
AND is implemented as a gum::aggregator::And which means that if parents are not boolean, all value>1 is True
Parameters
varThe variable added by copy.
Returns
the id of the added variable.
Exceptions
SizeErrorif variable.domainSize()>2

Definition at line 402 of file BayesNet_tpl.h.

402 {
403 if (var.domainSize() > 2) GUM_ERROR(SizeError, "an AND has to be boolean")
404
406 }

References add(), gum::DiscreteVariable::domainSize(), and GUM_ERROR.

Here is the call graph for this function:

◆ addArc() [1/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::addArc ( NodeId tail,
NodeId head )

Add an arc in the BN, and update arc.head's CPT.

Parameters
headand
tailas NodeId
Exceptions
InvalidEdgeIf arc.tail and/or arc.head are not in the BN.
DuplicateElementif the arc already exists

Definition at line 289 of file BayesNet_tpl.h.

289 {
290 if (this->dag_.existsArc(tail, head)) {
291 GUM_ERROR(DuplicateElement, "The arc (" << tail << "," << head << ") already exists.")
292 }
293
294 this->dag_.addArc(tail, head);
295 // Add parent in the child's CPT
296 (*(_probaMap_[head])) << variable(tail);
297 }

References gum::DAGmodel::dag_.

Referenced by addArc(), fastPrototype(), and gum::BayesNetFragment< GUM_SCALAR >::toBN().

Here is the caller graph for this function:

◆ addArc() [2/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::addArc ( std::string_view tail,
std::string_view head )

Add an arc in the BN, and update arc.head's CPT.

Exceptions
gum::DuplicateElementif the arc already exists

Definition at line 300 of file BayesNet_tpl.h.

300 {
301 try {
302 addArc(this->idFromName(tail), this->idFromName(head));
303 } catch (DuplicateElement const&) {
304 GUM_ERROR(DuplicateElement, "The arc " << tail << "->" << head << " already exists.")
305 }
306 }
NodeId idFromName(std::string_view name) const override
Returns the NodeId of a variable given its name.
void addArc(NodeId tail, NodeId head)
Add an arc in the BN, and update arc.head's CPT.

References addArc(), and idFromName().

Here is the call graph for this function:

◆ addCOUNT()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addCOUNT ( const DiscreteVariable & var,
Idx value = 1 )

Others aggregators.

Definition at line 409 of file BayesNet_tpl.h.

409 {
411 }

References add().

Here is the call graph for this function:

◆ addEXISTS()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addEXISTS ( const DiscreteVariable & var,
Idx value = 1 )

Others aggregators.

Definition at line 414 of file BayesNet_tpl.h.

414 {
415 if (var.domainSize() > 2) GUM_ERROR(SizeError, "an EXISTS has to be boolean")
416
418 }

References add(), gum::DiscreteVariable::domainSize(), and GUM_ERROR.

Here is the call graph for this function:

◆ addFORALL()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addFORALL ( const DiscreteVariable & var,
Idx value = 1 )

Others aggregators.

Definition at line 421 of file BayesNet_tpl.h.

421 {
422 if (var.domainSize() > 2) GUM_ERROR(SizeError, "an EXISTS has to be boolean")
423
425 }

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

Here is the call graph for this function:

◆ addLogit() [1/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addLogit ( const DiscreteVariable & var,
GUM_SCALAR external_weight )

Add a variable, its associate node and a Logit implementation.

The id of the new variable is automatically generated.

Parameters
varThe variable added by copy.
external_weightsee gum::MultiDimLogit
Returns
the id of the added variable.

Definition at line 482 of file BayesNet_tpl.h.

482 {
484 }

References add().

Here is the call graph for this function:

◆ addLogit() [2/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addLogit ( const DiscreteVariable & var,
GUM_SCALAR external_weight,
NodeId id )

Add a variable, its associate node and a Logit implementation.

Parameters
varThe variable added by copy
external_weightsee gum::MultiDimLogit
idproposed gum::nodeId for the variable
Warning
give an id should be reserved for rare and specific situations !!!
Returns
the id of the added variable.

Definition at line 501 of file BayesNet_tpl.h.

503 {
505 }

◆ addMAX()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addMAX ( const DiscreteVariable & var)

Others aggregators.

Definition at line 428 of file BayesNet_tpl.h.

428 {
430 }

References BayesNet(), add(), and addMAX().

Referenced by addMAX().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ addMEDIAN()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addMEDIAN ( const DiscreteVariable & var)

Others aggregators.

Definition at line 433 of file BayesNet_tpl.h.

433 {
435 }

References add().

Here is the call graph for this function:

◆ addMIN()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addMIN ( const DiscreteVariable & var)

Others aggregators.

Definition at line 438 of file BayesNet_tpl.h.

438 {
440 }

References add().

Here is the call graph for this function:

◆ addNoisyAND() [1/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyAND ( const DiscreteVariable & var,
GUM_SCALAR external_weight )

Add a variable, its associate node and a noisyAND implementation.

The id of the new variable is automatically generated.

Parameters
varThe variable added by copy.
external_weightsee gum::MultiDimNoisyAND
Returns
the id of the added variable.

Definition at line 476 of file BayesNet_tpl.h.

477 {
479 }

References add().

Here is the call graph for this function:

◆ addNoisyAND() [2/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyAND ( const DiscreteVariable & var,
GUM_SCALAR external_weight,
NodeId id )

Add a variable, its associate node and a noisyAND implementation.

Parameters
varThe variable added by copy
external_weightsee gum::MultiDimNoisyAND
idproposed gum::nodeId for the variable
Warning
give an id should be reserved for rare and specific situations !!!
Returns
the id of the added variable.

Definition at line 494 of file BayesNet_tpl.h.

496 {
498 }

References add().

Here is the call graph for this function:

◆ addNoisyOR() [1/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyOR ( const DiscreteVariable & var,
GUM_SCALAR external_weight )

Add a variable, it's associate node and a gum::noisyOR implementation.

The id of the new variable is automatically generated. Since it seems that the 'classical' noisyOR is the Compound noisyOR, we keep the gum::BayesNet::addNoisyOR as an alias for gum::BayesNet::addNoisyORCompound

Parameters
varThe variable added by copy.
external_weightsee ref gum::MultiDimNoisyORNet,gum::MultiDimNoisyORCompound
Returns
the id of the added variable.

Definition at line 458 of file BayesNet_tpl.h.

459 {
461 }
NodeId addNoisyORCompound(const DiscreteVariable &var, GUM_SCALAR external_weight)
Add a variable, it's associate node and a gum::noisyOR implementation.

References addNoisyORCompound().

Here is the call graph for this function:

◆ addNoisyOR() [2/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyOR ( const DiscreteVariable & var,
GUM_SCALAR external_weight,
NodeId id )

Add a variable, its associate node and a noisyOR implementation.

Since it seems that the 'classical' noisyOR is the Compound noisyOR, we keep the addNoisyOR as an alias for addNoisyORCompound.

Parameters
varThe variable added by copy.
external_weightsee gum::MultiDimNoisyORNet, gum::MultiDimNoisyORCompound
idThe chosen id
Warning
give an id should be reserved for rare and specific situations !!!
Returns
the id of the added variable.
Exceptions
DuplicateElementif id is already used

Definition at line 487 of file BayesNet_tpl.h.

489 {
491 }

References addNoisyORCompound().

Here is the call graph for this function:

◆ addNoisyORCompound() [1/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyORCompound ( const DiscreteVariable & var,
GUM_SCALAR external_weight )

Add a variable, it's associate node and a gum::noisyOR implementation.

The id of the new variable is automatically generated. Since it seems that the 'classical' noisyOR is the Compound noisyOR, we keep the gum::BayesNet::addNoisyOR as an alias for gum::BayesNet::addNoisyORCompound

Parameters
varThe variable added by copy.
external_weightsee ref gum::MultiDimNoisyORNet,gum::MultiDimNoisyORCompound
Returns
the id of the added variable.

Definition at line 464 of file BayesNet_tpl.h.

Referenced by addNoisyOR(), and addNoisyOR().

Here is the caller graph for this function:

◆ addNoisyORCompound() [2/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyORCompound ( const DiscreteVariable & var,
GUM_SCALAR external_weight,
NodeId id )

Add a variable, its associate node and a noisyOR implementation.

Since it seems that the 'classical' noisyOR is the Compound noisyOR, we keep the addNoisyOR as an alias for addNoisyORCompound.

Parameters
varThe variable added by copy.
external_weightsee gum::MultiDimNoisyORNet, gum::MultiDimNoisyORCompound
idThe chosen id
Warning
give an id should be reserved for rare and specific situations !!!
Returns
the id of the added variable.
Exceptions
DuplicateElementif id is already used

Definition at line 508 of file BayesNet_tpl.h.

510 {
512 }

References add().

Here is the call graph for this function:

◆ addNoisyORNet() [1/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyORNet ( const DiscreteVariable & var,
GUM_SCALAR external_weight )

Add a variable, it's associate node and a gum::noisyOR implementation.

The id of the new variable is automatically generated. Since it seems that the 'classical' noisyOR is the Compound noisyOR, we keep the gum::BayesNet::addNoisyOR as an alias for gum::BayesNet::addNoisyORCompound

Parameters
varThe variable added by copy.
external_weightsee ref gum::MultiDimNoisyORNet,gum::MultiDimNoisyORCompound
Returns
the id of the added variable.

Definition at line 470 of file BayesNet_tpl.h.

471 {
473 }

References add().

Here is the call graph for this function:

◆ addNoisyORNet() [2/2]

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addNoisyORNet ( const DiscreteVariable & var,
GUM_SCALAR external_weight,
NodeId id )

Add a variable, its associate node and a noisyOR implementation.

Since it seems that the 'classical' noisyOR is the Compound noisyOR, we keep the addNoisyOR as an alias for addNoisyORCompound.

Parameters
varThe variable added by copy.
external_weightsee gum::MultiDimNoisyORNet, gum::MultiDimNoisyORCompound
idThe chosen id
Warning
give an id should be reserved for rare and specific situations !!!
Returns
the id of the added variable.
Exceptions
DuplicateElementif id is already used

Definition at line 515 of file BayesNet_tpl.h.

517 {
519 }

References add().

Here is the call graph for this function:

◆ addOR()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addOR ( const DiscreteVariable & var)

Add a variable, it's associate node and an OR implementation.

The id of the new variable is automatically generated.

Warning
OR is implemented as a gum::aggregator::Or which means that if parents are not boolean, all value>1 is True
Parameters
varThe variable added by copy.
Returns
the id of the added variable.
Exceptions
SizeErrorif variable.domainSize()>2

Definition at line 443 of file BayesNet_tpl.h.

443 {
444 if (var.domainSize() > 2) GUM_ERROR(SizeError, "an OR has to be boolean")
445
447 }

References add(), gum::DiscreteVariable::domainSize(), and GUM_ERROR.

Here is the call graph for this function:

◆ addSUM()

template<GUM_Numeric GUM_SCALAR>
NodeId gum::BayesNet< GUM_SCALAR >::addSUM ( const DiscreteVariable & var)

Others aggregators.

Definition at line 450 of file BayesNet_tpl.h.

450 {
452 }

References add().

Here is the call graph for this function:

◆ addWeightedArc() [1/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::addWeightedArc ( NodeId tail,
NodeId head,
GUM_SCALAR causalWeight )

Add an arc in the BN, and update arc.head's CPT.

Parameters
headand
tailas NodeId
causalWeightsee gum::MultiDimICIModel
Exceptions
InvalidArcIf arc.tail and/or arc.head are not in the BN.
InvalidArcIf variable in arc.head is not a NoisyOR variable.

Definition at line 522 of file BayesNet_tpl.h.

522 {
523 if (auto* CImodel
524 = dynamic_cast< const MultiDimICIModel< GUM_SCALAR >* >(cpt(head).content())) {
525 // or is OK
526 addArc(tail, head);
527
528 CImodel->causalWeight(variable(tail), causalWeight);
529 } else {
531 "Head variable (" << variable(head).name() << ") is not a CIModel variable !")
532 }
533 }

Referenced by addWeightedArc().

Here is the caller graph for this function:

◆ addWeightedArc() [2/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::addWeightedArc ( std::string_view tail,
std::string_view head,
GUM_SCALAR causalWeight )

Add an arc in the BN, and update arc.head's CPT.

Parameters
headand
tailas std::string
causalWeightsee gum::MultiDimICIModel
Exceptions
NotFoundif no node with sun names is found
InvalidArcIf arc.tail and/or arc.head are not in the BN.
InvalidArcIf variable in arc.head is not a NoisyOR variable.

Definition at line 731 of file BayesNet_tpl.h.

733 {
735 }
void addWeightedArc(NodeId tail, NodeId head, GUM_SCALAR causalWeight)
Add an arc in the BN, and update arc.head's CPT.

References addWeightedArc(), and idFromName().

Here is the call graph for this function:

◆ ancestors() [1/2]

INLINE NodeSet gum::DAGmodel::ancestors ( const NodeId id) const
inherited

returns the set of nodes with directed path ingoing to a given node

Note that the set of nodes returned may be empty if no path within the ArcGraphPart is ingoing to the given node.

Parameters
idthe node which is the head of a directed path with the returned nodes
namethe name of the node which is the head of a directed path with the returned nodes

Definition at line 135 of file DAGmodel_inl.h.

135{ return dag_.ancestors(id); }

References dag_.

Referenced by ancestors().

Here is the caller graph for this function:

◆ ancestors() [2/2]

INLINE NodeSet gum::DAGmodel::ancestors ( std::string_view name) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 137 of file DAGmodel_inl.h.

137 {
138 return ancestors(idFromName(name));
139 }
NodeSet ancestors(const NodeId id) const
returns the set of nodes with directed path ingoing to a given node
NodeId idFromName(std::string_view name) const override
Returns the NodeId of a variable given its name.

References ancestors(), and gum::DiscreteGraphicalModel::idFromName().

Here is the call graph for this function:

◆ arcs()

INLINE const ArcSet & gum::DAGmodel::arcs ( ) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 73 of file DAGmodel_inl.h.

73{ return dag_.arcs(); }

References dag_.

Referenced by hasSameStructure(), gum::MarkovBlanket::hasSameStructure(), and gum::BayesNetFragment< GUM_SCALAR >::toBN().

Here is the caller graph for this function:

◆ beginTopologyTransformation()

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::beginTopologyTransformation ( )

When inserting/removing arcs, node CPTs change their dimension with a cost in time.

begin Multiple Change for all CPTs

These functions delay the CPTs change to be done just once at the end of a sequence of topology modification. begins a sequence of insertions/deletions of arcs without changing the dimensions of the CPTs.

Definition at line 543 of file BayesNet_tpl.h.

543 {
544 for (const auto node: nodes())
545 _probaMap_[node]->beginMultipleChanges();
546 }
const NodeGraphPart & nodes() const final
Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding vari...

References _probaMap_, and gum::DAGmodel::nodes().

Here is the call graph for this function:

◆ changeTensor() [1/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::changeTensor ( NodeId id,
Tensor< GUM_SCALAR > * newPot )

change the CPT associated to nodeId to newPot delete the old CPT associated to nodeId.

Exceptions
NotAllowedif newPot has not the same signature as probaMap[NodeId]

Definition at line 600 of file BayesNet_tpl.h.

600 {
601 if (cpt(id).nbrDim() != newPot->nbrDim()) {
603 "cannot exchange tensors with different "
604 "dimensions for variable with id "
605 << id)
606 }
607
608 for (Idx i = 0; i < cpt(id).nbrDim(); i++) {
609 if (&cpt(id).variable(i) != &(newPot->variable(i))) {
611 "cannot exchange tensors because, for variable with id " << id << ", dimension "
612 << i << " differs. ")
613 }
614 }
615
617 }
void _unsafeChangeTensor_(NodeId id, Tensor< GUM_SCALAR > *newPot)
change the CPT associated to nodeId to newPot delete the old CPT associated to nodeId.

References cpt(), and GUM_ERROR.

Referenced by changeTensor().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ changeTensor() [2/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::changeTensor ( std::string_view name,
Tensor< GUM_SCALAR > * newPot )

Definition at line 626 of file BayesNet_tpl.h.

626 {
628 }
void changeTensor(NodeId id, Tensor< GUM_SCALAR > *newPot)
change the CPT associated to nodeId to newPot delete the old CPT associated to nodeId.

References changeTensor(), and idFromName().

Here is the call graph for this function:

◆ changeVariableLabel() [1/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::changeVariableLabel ( NodeId id,
std::string_view old_label,
std::string_view new_label )

Changes a variable's label in the gum::BayesNet.

This will change the gum::LabelizedVariable names in the gum::BayesNet.

Exceptions
DuplicateLabelRaised if new_label is already used in this gum::LabelizedVariable.
NotFoundRaised if no variable matches id or if the variable is not a LabelizedVariable

Definition at line 188 of file BayesNet_tpl.h.

190 {
192 GUM_ERROR(NotFound, "Variable " << id << " is not a LabelizedVariable.")
193
195 if (var == nullptr) GUM_ERROR(TypeError, "Variable " << id << " is not a LabelizedVariable.")
196
198 }

Referenced by changeVariableLabel().

Here is the caller graph for this function:

◆ changeVariableLabel() [2/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::changeVariableLabel ( std::string_view name,
std::string_view old_label,
std::string_view new_label )

Changes a variable's name.

Definition at line 714 of file BayesNet_tpl.h.

716 {
718 }
void changeVariableLabel(NodeId id, std::string_view old_label, std::string_view new_label)
Changes a variable's label in the gum::BayesNet.

References changeVariableLabel(), and idFromName().

Here is the call graph for this function:

◆ changeVariableName() [1/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::changeVariableName ( NodeId id,
std::string_view new_name )

Changes a variable's name in the gum::BayesNet.

This will change the gum::DiscreteVariable names in the gum::BayesNet.

Exceptions
DuplicateLabelRaised if newName is already used in this gum::BayesNet.
NotFoundRaised if no variable matches id.

Definition at line 183 of file BayesNet_tpl.h.

183 {
184 this->varMap_.changeName(id, new_name);
185 }

References gum::DiscreteGraphicalModel::varMap_.

Referenced by changeVariableName().

Here is the caller graph for this function:

◆ changeVariableName() [2/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::changeVariableName ( std::string_view name,
std::string_view new_name )

Changes a variable's name.

Definition at line 708 of file BayesNet_tpl.h.

709 {
711 }
void changeVariableName(NodeId id, std::string_view new_name)
Changes a variable's name in the gum::BayesNet.

References changeVariableName(), and idFromName().

Here is the call graph for this function:

◆ check()

template<GUM_Numeric GUM_SCALAR>
std::vector< std::string > gum::IBayesNet< GUM_SCALAR >::check ( ) const
inherited

Check if the BayesNet is consistent (variables, CPT).

Returns
a list of comments on the consistency of the Bayes Net

Definition at line 322 of file IBayesNet_tpl.h.

322 {
324
325 const double epsilon = 1e-8;
326 const double error_epsilon = 1e-1;
327
328 // CHECKING domain
329 for (const auto i: nodes())
330 if (variable(i).domainSize() < 2) {
332 s << "Variable " << variable(i).name() << ": not consistent (domainSize=1).";
333 comments.push_back(s.str());
334 }
335
336 // CHECKING parameters are probabilities
337 // >0
338 for (const auto i: nodes()) {
339 const auto [amin, minval] = cpt(i).argmin();
340 if (minval < (GUM_SCALAR)0.0) {
342 s << "Variable " << variable(i).name() << " : P(" << *(amin.begin()) << ") < 0.0";
343 comments.push_back(s.str());
344 }
345 }
346 // <1
347 for (const auto i: nodes()) {
348 const auto [amax, maxval] = cpt(i).argmax();
349 if (maxval > (GUM_SCALAR)1.0) {
351 s << "Variable " << variable(i).name() << " : P(" << *(amax.begin()) << ") > 1.0";
352 comments.push_back(s.str());
353 }
354 }
355
356 // CHECKING distributions sum to 1
357 for (const auto i: nodes()) {
358 const auto p = cpt(i).sumOut({&variable(i)});
359 const auto [amin, minval] = p.argmin();
360 if (minval < (GUM_SCALAR)(1.0 - epsilon)) {
362 s << "Variable " << variable(i).name() << " : ";
363 if (!parents(i).empty()) s << "with (at least) parents " << *(amin.begin()) << ", ";
364 s << "the CPT sum to less than 1";
365 if (minval > (GUM_SCALAR)(1.0 - error_epsilon)) s << " (normalization problem ?)";
366 s << ".";
367 comments.push_back(s.str());
368 continue;
369 }
370 const auto [amax, maxval] = p.argmax();
371 if (maxval > (GUM_SCALAR)(1.0 + epsilon)) {
373 s << "Variable " << variable(i).name() << " : ";
374 if (!parents(i).empty()) s << "with (at least) parents " << *(amax.begin()) << ", ";
375 s << "the CPT sum to more than 1";
376 if (maxval < (GUM_SCALAR)(1.0 + error_epsilon)) s << " (normalization problem ?)";
377 s << ".";
378 comments.push_back(s.str());
379 }
380 }
381
382 return comments;
383 }
const NodeSet & parents(const NodeId id) const
returns the set of nodes with arc ingoing to a given node
const DiscreteVariable & variable(NodeId id) const override
Returns a constant reference over a variable given its node id.
virtual bool empty() const
Return true if this graphical model is empty.
Class representing the minimal interface for Bayesian network with no numerical data.
Definition IBayesNet.h:75
virtual const Tensor< GUM_SCALAR > & cpt(NodeId varId) const =0
Returns the CPT of a variable.

References cpt(), gum::GraphicalModel::empty(), gum::DAGmodel::nodes(), gum::DAGmodel::parents(), and gum::DiscreteGraphicalModel::variable().

Here is the call graph for this function:

◆ children() [1/4]

INLINE const NodeSet & gum::DAGmodel::children ( const NodeId id) const
inherited

returns the set of nodes with arc outgoing from a given node

Note that the set of nodes returned may be empty if no node is outgoing from the given node.

Parameters
idthe node which is the tail of an arc with the returned nodes
namethe name of the node which is the tail of an arc with the returned nodes

Definition at line 95 of file DAGmodel_inl.h.

95{ return dag_.children(id); }

References dag_.

Referenced by children(), gum::BayesNet< GUM_SCALAR >::erase(), gum::prm::ClassBayesNet< GUM_SCALAR >::toDot(), and gum::prm::InstanceBayesNet< GUM_SCALAR >::toDot().

Here is the caller graph for this function:

◆ children() [2/4]

INLINE NodeSet gum::DAGmodel::children ( const NodeSet & ids) const
inherited

returns the children of a set of nodes

Definition at line 101 of file DAGmodel_inl.h.

101{ return dag_.children(ids); }
std::vector< NodeId > ids(const std::vector< std::string > &names) const
transform a vector of names into a vector of nodeId

References dag_, and gum::GraphicalModel::ids().

Here is the call graph for this function:

◆ children() [3/4]

INLINE NodeSet gum::DAGmodel::children ( const std::vector< std::string > & names) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 103 of file DAGmodel_inl.h.

103 {
104 return children(nodeset(names));
105 }
const NodeSet & children(const NodeId id) const
returns the set of nodes with arc outgoing from a given node
std::vector< std::string > names(const std::vector< NodeId > &ids) const
transform a vector of NodeId in a vector of names
NodeSet nodeset(const std::vector< std::string > &names) const
transform a vector of names into a NodeSet

References children(), gum::GraphicalModel::names(), and gum::GraphicalModel::nodeset().

Here is the call graph for this function:

◆ children() [4/4]

INLINE const NodeSet & gum::DAGmodel::children ( std::string_view name) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 97 of file DAGmodel_inl.h.

97 {
98 return dag_.children(idFromName(name));
99 }

◆ clear()

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::clear ( )

clear the whole Bayes net *

Definition at line 279 of file BayesNet_tpl.h.

279 {
280 if (!this->empty()) {
281 auto l = this->nodes();
282 for (const auto no: l) {
283 this->erase(no);
284 }
285 }
286 }
void erase(NodeId varId)
Remove a variable from the gum::BayesNet.

References gum::GraphicalModel::empty(), erase(), and gum::DAGmodel::nodes().

Here is the call graph for this function:

◆ completeInstantiation()

INLINE Instantiation gum::GraphicalModel::completeInstantiation ( ) const
inherited

Get an instantiation over all the variables of the model.

Definition at line 104 of file graphicalModel_inl.h.

104 {
105 Instantiation I;
106
107 for (const auto node: nodes())
108 I << variable(node);
109
110 return I;
111 }
virtual const NodeGraphPart & nodes() const =0
Returns the number of variables in this Directed Graphical Model.

References nodes(), and variable().

Here is the call graph for this function:

◆ connectedComponents()

INLINE NodeProperty< NodeId > gum::DAGmodel::connectedComponents ( ) const
inherited

Returns the weakly connected components of the underlying DAG. Each node maps to the id of its component root.

Definition at line 125 of file DAGmodel_inl.h.

125 {
126 return dag_.connectedComponents();
127 }

References dag_.

◆ contextualize()

template<GUM_Numeric GUM_SCALAR>
BayesNet< GUM_SCALAR > gum::BayesNet< GUM_SCALAR >::contextualize ( const gum::Instantiation & observations,
const gum::Instantiation & interventions ) const

create a contextual BN from this and a set of hard observations and hard interventions.

Parameters
observationsthe hard observations
interventionsthe hard interventions
Returns
a new BN with the same structure as this, but with the CPTs modified to reflect the observations and interventions
Warning
The original BN is not modified. The returned BN is not a copy of the original BN, but a new BN with copied variables and modified structure and CPTs.
Exceptions
ArgumentErrorif the observations and interventions are not mutually exclusive

Definition at line 632 of file BayesNet_tpl.h.

633 {
635 for (gum::Idx i = 0; i < observations.nbrDim(); i++) {
636 if (interventions.contains(observations.variable(i))) {
638 "Cannot have both an observation and an intervention on the same variable")
639 }
641 }
642 for (gum::Idx i = 0; i < interventions.nbrDim(); i++) {
644 }
645 all.setVals(observations);
646 all.setVals(interventions);
647
649
651
653 for (gum::Idx i = 0; i < observations.nbrDim(); i++) {
655 const gum::NodeId nod = this->idFromName(nam);
656 for (gum::NodeId child: this->children(nod)) {
658 }
659 }
660 for (gum::Idx i = 0; i < interventions.nbrDim(); i++) {
662 const gum::NodeId nod = this->idFromName(nam);
663 for (gum::NodeId child: this->children(nod)) {
665 }
666 for (gum::NodeId par: this->parents(nod)) {
667 const auto v1 = bn.idFromName(this->variable(par).name());
668 const auto v2 = bn.idFromName(nam);
669 if (bn.existsArc(v1, v2)) bn.eraseArc(v1, v2);
670 }
671 cpt_changed.insert(bn.idFromName(nam));
674 interventions.val(i)));
675 }
677
678 for (gum::Idx i = 0; i < all.nbrDim(); i++) {
679 const gum::NodeId nod = this->idFromName(all.variable(i).name());
680 for (gum::NodeId child: this->children(nod)) {
681 if (!cpt_changed.contains(child)) {
682 cpt_changed.insert(child);
684 .fillWith(this->cpt(child).extract(all));
685 }
686 }
687 }
688
689 return bn;
690 }
void eraseArc(const Arc &arc)
Removes an arc in the BN, and update head's CTP.
void endTopologyTransformation()
terminates a sequence of insertions/deletions of arcs by adjusting all CPTs dimensions.
void beginTopologyTransformation()
When inserting/removing arcs, node CPTs change their dimension with a cost in time.
bool existsArc(const NodeId tail, const NodeId head) const
return true if the arc tail->head exists in the DAGmodel

◆ cpt() [1/2]

template<GUM_Numeric GUM_SCALAR>
const Tensor< GUM_SCALAR > & gum::BayesNet< GUM_SCALAR >::cpt ( NodeId varId) const
finalvirtual

Returns the CPT of a variable.

Parameters
varIdA variable's id in the gum::BayesNet.
Returns
The variable's CPT.
Exceptions
NotFoundIf no variable's id matches varId.

Implements gum::IBayesNet< GUM_SCALAR >.

Definition at line 253 of file BayesNet_tpl.h.

253 {
254 return *(_probaMap_[varId]);
255 }

References _probaMap_.

Referenced by add(), changeTensor(), cpt(), generateCPT(), and gum::BayesNetFragment< GUM_SCALAR >::toBN().

Here is the caller graph for this function:

◆ cpt() [2/2]

template<GUM_Numeric GUM_SCALAR>
const Tensor< GUM_SCALAR > & gum::BayesNet< GUM_SCALAR >::cpt ( std::string_view name) const

Returns the CPT of a variable.

Definition at line 693 of file BayesNet_tpl.h.

693 {
694 return cpt(idFromName(name));
695 }

References cpt(), and idFromName().

Here is the call graph for this function:

◆ dag()

INLINE DAG gum::DAGmodel::dag ( ) const
nodiscardinherited

Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding variable.

O(n) — allocates a new DAG. For a stable reference (listeners, long-lived pointers), use internalDag().

Definition at line 61 of file DAGmodel_inl.h.

61 {
62 DAG g = dag_;
63 _nameNodes_(g);
64 return g;
65 }
void _nameNodes_(NodeGraphPart &g) const
Names every node of g using variable(id).name() for each node id in g.

References gum::GraphicalModel::_nameNodes_(), and dag_.

Referenced by gum::BayesNetFragment< GUM_SCALAR >::BayesNetFragment(), gum::MarginalTargetedInference< GUM_SCALAR >::MarginalTargetedInference(), gum::BayesNet< GUM_SCALAR >::add(), gum::BayesNet< GUM_SCALAR >::reverseArc(), and gum::InfluenceDiagram< GUM_SCALAR >::toString().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ descendants() [1/2]

INLINE NodeSet gum::DAGmodel::descendants ( const NodeId id) const
inherited

returns the set of nodes with directed path outgoing from a given node

Note that the set of nodes returned may be empty if no path within the ArcGraphPart is outgoing from the given node.

Parameters
idthe node which is the tail of a directed path with the returned nodes
namethe name of the node which is the tail of a directed path with the returned nodes

Definition at line 129 of file DAGmodel_inl.h.

129{ return dag_.descendants(id); }

References dag_.

◆ descendants() [2/2]

INLINE NodeSet gum::DAGmodel::descendants ( std::string_view name) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 131 of file DAGmodel_inl.h.

131 {
132 return descendants(idFromName(name));
133 }
NodeSet descendants(const NodeId id) const
returns the set of nodes with directed path outgoing from a given node

◆ dim()

template<GUM_Numeric GUM_SCALAR>
Size gum::IBayesNet< GUM_SCALAR >::dim ( ) const
inherited

Returns the dimension (the number of free parameters) in this bayes net.

\( dim(G)=\sum_{i \in nodes} ((r_i-1)\cdot q_i) \) where \( r_i \) is the number of instantiations of node \( i \) and \( q_i \) is the number of instantiations of its parents.

Definition at line 114 of file IBayesNet_tpl.h.

114 {
115 Size dim = 0;
116
117 for (auto node: nodes()) {
118 Size q = 1;
119
120 for (auto parent: parents(node))
122
123 dim += (variable(node).domainSize() - 1) * q;
124 }
125
126 return dim;
127 }
virtual Size domainSize() const =0
Size dim() const
Returns the dimension (the number of free parameters) in this bayes net.

References dim(), gum::DAGmodel::nodes(), gum::DAGmodel::parents(), and gum::DiscreteGraphicalModel::variable().

Referenced by dim().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ empty()

INLINE bool gum::GraphicalModel::empty ( ) const
virtualinherited

Return true if this graphical model is empty.

Definition at line 114 of file graphicalModel_inl.h.

114{ return size() == 0; }
virtual Size size() const =0
Returns the number of variables in this Directed Graphical Model.

References size().

Referenced by gum::IBayesNet< GUM_SCALAR >::check(), and gum::BayesNet< GUM_SCALAR >::clear().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ endTopologyTransformation()

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::endTopologyTransformation ( )

terminates a sequence of insertions/deletions of arcs by adjusting all CPTs dimensions.

end Multiple Change for all CPTs

Definition at line 550 of file BayesNet_tpl.h.

550 {
551 for (const auto node: nodes())
552 _probaMap_[node]->endMultipleChanges();
553 }

References _probaMap_, and gum::DAGmodel::nodes().

Here is the call graph for this function:

◆ erase() [1/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::erase ( const DiscreteVariable & var)

Remove a variable from the gum::BayesNet.

Removes the corresponding variable from the gum::BayesNet and from all of it's children gum::Tensor.

If no variable matches the given variable, then nothing is done.

Parameters
varA reference on the variable to remove.

Definition at line 258 of file BayesNet_tpl.h.

258 {
259 erase(this->varMap_.get(var));
260 }

References erase(), and gum::DiscreteGraphicalModel::varMap_.

Here is the call graph for this function:

◆ erase() [2/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::erase ( NodeId varId)

Remove a variable from the gum::BayesNet.

Removes the corresponding variable from the gum::BayesNet and from all of it's children gum::Tensor.

If no variable matches the given id, then nothing is done.

Parameters
varIdThe variable's id to remove.

Definition at line 263 of file BayesNet_tpl.h.

263 {
264 if (this->varMap_.exists(varId)) {
265 // Reduce the variable child's CPT
266 for (const NodeSet& children = this->children(varId); const auto c: children) {
267 _probaMap_[c]->erase(variable(varId));
268 }
269
270 delete _probaMap_[varId];
271
272 _probaMap_.erase(varId);
273 this->varMap_.erase(varId);
274 this->dag_.eraseNode(varId);
275 }
276 }

References _probaMap_, gum::DAGmodel::children(), gum::DAGmodel::dag_, variable(), and gum::DiscreteGraphicalModel::varMap_.

Referenced by clear(), erase(), and erase().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ erase() [3/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::erase ( std::string_view name)

Removes a variable from the gum::BayesNet.

Definition at line 698 of file BayesNet_tpl.h.

698 {
700 }

References erase(), and idFromName().

Here is the call graph for this function:

◆ eraseArc() [1/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::eraseArc ( const Arc & arc)

Removes an arc in the BN, and update head's CTP.

If (tail, head) doesn't exist, the nothing happens.

Parameters
arcThe arc removed.

Definition at line 309 of file BayesNet_tpl.h.

309 {
310 if (this->varMap_.exists(arc.tail()) && this->varMap_.exists(arc.head())) {
311 NodeId head = arc.head();
312 NodeId tail = arc.tail();
313 this->dag_.eraseArc(arc);
314 // Remove parent from child's CPT
315 (*(_probaMap_[head])) >> variable(tail);
316 }
317 }
bool exists(NodeId id) const
Return true if id matches a node.

References _probaMap_, gum::DAGmodel::dag_, gum::Arc::head(), gum::Arc::tail(), variable(), and gum::DiscreteGraphicalModel::varMap_.

Referenced by eraseArc(), and eraseArc().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ eraseArc() [2/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::eraseArc ( NodeId tail,
NodeId head )

Removes an arc in the BN, and update head's CTP.

If (tail, head) doesn't exist, the nothing happens.

Parameters
headand
tailas NodeId

Definition at line 320 of file BayesNet_tpl.h.

320 {
322 }

References eraseArc().

Here is the call graph for this function:

◆ eraseArc() [3/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::eraseArc ( std::string_view tail,
std::string_view head )

Removes an arc in the BN, and update head's CTP.

Definition at line 721 of file BayesNet_tpl.h.

721 {
723 }

References eraseArc(), and idFromName().

Here is the call graph for this function:

◆ evEq()

template<GUM_Numeric GUM_SCALAR>
Tensor< GUM_SCALAR > gum::IBayesNet< GUM_SCALAR >::evEq ( std::string_view name,
double value ) const
inherited
Returns
a Tensor for a (numerical) discrete variable representing an evidence with a float as observed value

Definition at line 386 of file IBayesNet_tpl.h.

386 {
388 }
const DiscreteVariable & variableFromName(std::string_view name) const override
Returns a constant reference over a variable given its name.
static Tensor< GUM_SCALAR > evEq(const DiscreteVariable &v, double val)
numerical evidence generator

References gum::Tensor< GUM_SCALAR >::evEq(), and gum::DiscreteGraphicalModel::variableFromName().

Here is the call graph for this function:

◆ evGt()

template<GUM_Numeric GUM_SCALAR>
Tensor< GUM_SCALAR > gum::IBayesNet< GUM_SCALAR >::evGt ( std::string_view name,
double value ) const
inherited
Returns
a Tensor for a (numerical) discrete variable representing an evidence with an observed value greater than the parameter

Definition at line 397 of file IBayesNet_tpl.h.

397 {
399 }
static Tensor< GUM_SCALAR > evGt(const DiscreteVariable &v, double val)
numerical evidence generator

References gum::Tensor< GUM_SCALAR >::evGt(), and gum::DiscreteGraphicalModel::variableFromName().

Here is the call graph for this function:

◆ evIn()

template<GUM_Numeric GUM_SCALAR>
Tensor< GUM_SCALAR > gum::IBayesNet< GUM_SCALAR >::evIn ( std::string_view name,
double val1,
double val2 ) const
inherited
Returns
a Tensor for a (numerical) discrete variable representing an evidence with a interval of float as observed value

Definition at line 392 of file IBayesNet_tpl.h.

392 {
394 }
static Tensor< GUM_SCALAR > evIn(const DiscreteVariable &v, double val1, double val2)
numerical evidence generator

References gum::Tensor< GUM_SCALAR >::evIn(), and gum::DiscreteGraphicalModel::variableFromName().

Here is the call graph for this function:

◆ evLt()

template<GUM_Numeric GUM_SCALAR>
Tensor< GUM_SCALAR > gum::IBayesNet< GUM_SCALAR >::evLt ( std::string_view name,
double value ) const
inherited
Returns
a Tensor for a (numerical) discrete variable representing an evidence with an observed value less than the parameter

Definition at line 402 of file IBayesNet_tpl.h.

402 {
404 }
static Tensor< GUM_SCALAR > evLt(const DiscreteVariable &v, double val)
numerical evidence generator

References gum::Tensor< GUM_SCALAR >::evLt(), and gum::DiscreteGraphicalModel::variableFromName().

Here is the call graph for this function:

◆ exists() [1/2]

INLINE bool gum::DAGmodel::exists ( NodeId node) const
finalvirtualinherited

Return true if this node exists in this graphical model.

Implements gum::GraphicalModel.

Definition at line 113 of file DAGmodel_inl.h.

113{ return dag_.exists(node); }

References dag_.

Referenced by gum::build_node(), gum::build_node_for_ID(), hasSameStructure(), gum::MarkovBlanket::hasSameStructure(), gum::IBayesNet< GUM_SCALAR >::operator==(), and gum::InfluenceDiagram< GUM_SCALAR >::operator==().

Here is the caller graph for this function:

◆ exists() [2/2]

INLINE bool gum::DAGmodel::exists ( std::string_view name) const
finalvirtualinherited

Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding variable.

O(n) — allocates a new DAG. For a stable reference (listeners, long-lived pointers), use internalDag().

Implements gum::GraphicalModel.

Definition at line 115 of file DAGmodel_inl.h.

115 {
116 return variableNodeMap().exists(name);
117 }
const VariableNodeMap & variableNodeMap() const override
Returns a constant reference to the VariableNodeMap of this model.

◆ existsArc() [1/2]

INLINE bool gum::DAGmodel::existsArc ( const NodeId tail,
const NodeId head ) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 75 of file DAGmodel_inl.h.

75 {
76 return dag_.existsArc(tail, head);
77 }

References dag_.

Referenced by existsArc(), gum::BayesNet< GUM_SCALAR >::reverseArc(), gum::BayesNetFragment< GUM_SCALAR >::toDot(), and gum::BayesNetFragment< GUM_SCALAR >::whenArcDeleted().

Here is the caller graph for this function:

◆ existsArc() [2/2]

INLINE bool gum::DAGmodel::existsArc ( std::string_view nametail,
std::string_view namehead ) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 79 of file DAGmodel_inl.h.

79 {
80 return existsArc(idFromName(nametail), idFromName(namehead));
81 }

References existsArc(), and gum::DiscreteGraphicalModel::idFromName().

Here is the call graph for this function:

◆ existsProperty()

INLINE bool gum::GraphicalModel::existsProperty ( std::string_view name) const
inherited

check wether a property exists in this GraphicalModel

Definition at line 170 of file graphicalModel_inl.h.

170 {
171 return _propertiesMap_.exists(name);
172 }

References _propertiesMap_.

◆ family() [1/2]

INLINE NodeSet gum::DAGmodel::family ( const NodeId id) const
finalvirtualinherited

returns the parents of a node and the node

Parameters
idthe node which is the head of an arc with the returned nodes
namethe name of the node the node which is the head of an arc with the returned nodes

Implements gum::GraphicalModel.

Definition at line 89 of file DAGmodel_inl.h.

89{ return dag_.family(id); }

References dag_.

◆ family() [2/2]

INLINE NodeSet gum::DAGmodel::family ( std::string_view name) const
finalvirtualinherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Implements gum::GraphicalModel.

Definition at line 91 of file DAGmodel_inl.h.

91 {
92 return dag_.family(idFromName(name));
93 }

References dag_, and gum::DiscreteGraphicalModel::idFromName().

Here is the call graph for this function:

◆ fastPrototype() [1/2]

template<GUM_Numeric GUM_SCALAR>
BayesNet< GUM_SCALAR > gum::BayesNet< GUM_SCALAR >::fastPrototype ( std::string_view dotlike,
Size domainSize )
static

Create a Bayesian network with a dot-like syntax which specifies:

  • the structure "a->b->c;b->d<-e;".
  • the type of the variables with different syntax:

Note that if the dot-like string contains such a specification more than once for a variable, the first specification will be used.

Parameters
dotlikethe string containing the specification
domainSizethe default domain size for variables
Returns
the resulting Bayesian network

Definition at line 90 of file BayesNet_tpl.h.

91 {
92 return fastPrototype(dotlike, "[" + std::to_string(domainSize) + "]");
93 }
static BayesNet< GUM_SCALAR > fastPrototype(std::string_view dotlike, Size domainSize)
Create a Bayesian network with a dot-like syntax which specifies:

References fastPrototype().

Referenced by fastPrototype().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ fastPrototype() [2/2]

template<GUM_Numeric GUM_SCALAR>
BayesNet< GUM_SCALAR > gum::BayesNet< GUM_SCALAR >::fastPrototype ( std::string_view dotlike,
std::string_view domainSize = "[2]" )
static

Definition at line 96 of file BayesNet_tpl.h.

97 {
99
100 for (const auto& chaine: split(remove_newline(dotlike), ";")) {
101 NodeId lastId = 0;
102 bool notfirst = false;
103 for (const auto& souschaine: split(chaine, "->")) {
104 bool forward = true;
105 for (auto& node: split(souschaine, "<-")) {
106 auto idVar = build_node(bn, node, domain);
107 if (notfirst) {
108 if (forward) {
110 forward = false;
111 } else {
113 }
114 } else {
115 notfirst = true;
116 forward = false;
117 }
118 lastId = idVar;
119 }
120 }
121 }
123 bn.setProperty("name", "anonymousBN");
124 return bn;
125 }
void generateCPTs() const
randomly generates CPTs for a given structure
void setProperty(std::string_view name, std::string_view value)
Add or change a property of this GraphicalModel.

References addArc(), gum::build_node(), gum::remove_newline(), and gum::split().

Here is the call graph for this function:

◆ generateCPT() [1/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::generateCPT ( NodeId node) const

randomly generate CPT for a given node in a given structure

Definition at line 593 of file BayesNet_tpl.h.

593 {
595
597 }
void generateCPT(NodeId node) const
randomly generate CPT for a given node in a given structure

References cpt(), and variable().

Referenced by generateCPT(), and generateCPTs().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ generateCPT() [2/2]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::generateCPT ( std::string_view name) const

Definition at line 738 of file BayesNet_tpl.h.

738 {
740 }

References generateCPT(), and idFromName().

Here is the call graph for this function:

◆ generateCPTs()

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::generateCPTs ( ) const

randomly generates CPTs for a given structure

Definition at line 587 of file BayesNet_tpl.h.

587 {
588 for (const auto node: nodes())
590 }

References generateCPT(), and gum::DAGmodel::nodes().

Here is the call graph for this function:

◆ hasSameStructure()

bool gum::DAGmodel::hasSameStructure ( const DAGmodel & other) const
inherited
Returns
true if all the named node are the same and all the named arcs are the same

Definition at line 87 of file DAGmodel.cpp.

87 {
88 if (this == &other) return true;
89
90 if (size() != other.size()) return false;
91
92 if (sizeArcs() != other.sizeArcs()) return false;
93
94 for (const auto& nid: nodes()) {
95 if (!other.exists(variable(nid).name())) return false;
96 }
97
98 for (const auto& arc: arcs()) {
99 if (!other.arcs().exists(Arc(other.idFromName(variable(arc.tail()).name()),
100 other.idFromName(variable(arc.head()).name()))))
101 return false;
102 }
103
104 return true;
105 }
const ArcSet & arcs() const
return true if the arc tail->head exists in the DAGmodel
Size size() const final
Returns the number of variables in this Directed Graphical Model.
Size sizeArcs() const
Returns the number of arcs in this Directed Graphical Model.

References DAGmodel(), arcs(), exists(), gum::Set< Key >::exists(), gum::DiscreteGraphicalModel::idFromName(), nodes(), size(), sizeArcs(), and gum::DiscreteGraphicalModel::variable().

Here is the call graph for this function:

◆ idFromName()

template<GUM_Numeric GUM_SCALAR>
INLINE NodeId gum::DiscreteGraphicalModel::idFromName ( std::string_view name) const
overridevirtual

Returns the NodeId of a variable given its name.

Exceptions
NotFoundif no such name exists in the model.

Implements gum::GraphicalModel.

Definition at line 104 of file discreteGraphicalModel_inl.h.

61 {
62 return varMap_.idFromName(name);
63 }

Referenced by addArc(), addWeightedArc(), gum::build_node(), changeTensor(), changeVariableLabel(), changeVariableName(), cpt(), erase(), eraseArc(), generateCPT(), reverseArc(), and variable().

Here is the caller graph for this function:

◆ ids()

INLINE std::vector< NodeId > gum::GraphicalModel::ids ( const std::vector< std::string > & names) const
inherited

transform a vector of names into a vector of nodeId

Returns
the vector of names

Definition at line 139 of file graphicalModel_inl.h.

139 {
140 std::vector< NodeId > res;
141 const VariableNodeMap& v = variableNodeMap();
142 std::transform(names.cbegin(),
143 names.cend(),
144 std::back_inserter(res),
145 [&v](const std::string& n) { return v.idFromName(n); });
146 return res;
147 }
virtual const VariableNodeMap & variableNodeMap() const =0
Returns a constant reference to the VariableNodeMap of this Graphical Model.

References names(), and variableNodeMap().

Referenced by gum::DAGmodel::children(), exists(), names(), names(), and gum::DAGmodel::parents().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ internalDag()

INLINE const DAG & gum::DAGmodel::internalDag ( ) const
inherited

Returns a const reference to the internal (unnamed) DAG. O(1), no copy. Use for stable references or pointers (e.g. graph listeners). For named node access, use dag() instead.

Definition at line 58 of file DAGmodel_inl.h.

58{ return dag_; }

References dag_.

Referenced by gum::BayesNetFragment< GUM_SCALAR >::BayesNetFragment(), gum::MarkovBlanket::MarkovBlanket(), gum::BayesNetFragment< GUM_SCALAR >::installCPT(), gum::BayesNetFragment< GUM_SCALAR >::isInstalledNode(), gum::BayesBall::relevantTensors(), gum::dSeparationAlgorithm::relevantTensors(), gum::BayesNetFragment< GUM_SCALAR >::toBN(), gum::BayesNetFragment< GUM_SCALAR >::toDot(), and gum::BayesNetFragment< GUM_SCALAR >::whenArcDeleted().

Here is the caller graph for this function:

◆ isIndependent() [1/4]

INLINE bool gum::DAGmodel::isIndependent ( const NodeSet & X,
const NodeSet & Y,
const NodeSet & Z ) const
finalvirtualinherited

check if nodes X and nodes Y are independent given nodes Z

Implements gum::GraphicalModel.

Definition at line 156 of file DAGmodel_inl.h.

156 {
157 return dag_.dSeparation(X, Y, Z);
158 }

References dag_.

◆ isIndependent() [2/4]

INLINE bool gum::DAGmodel::isIndependent ( const std::vector< std::string > & Xnames,
const std::vector< std::string > & Ynames,
const std::vector< std::string > & Znames ) const
inherited

build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes

Parameters
nodesthe set of nodeId
nodenamesthe vector of names of nodes
Returns
the moralized ancestral graph

Definition at line 184 of file DAGmodel_inl.h.

186 {
187 return isIndependent(nodeset(Xnames), nodeset(Ynames), nodeset(Znames));
188 }
bool isIndependent(NodeId X, NodeId Y, const NodeSet &Z) const final
check if node X and node Y are independent given nodes Z

◆ isIndependent() [3/4]

INLINE bool gum::DAGmodel::isIndependent ( NodeId X,
NodeId Y,
const NodeSet & Z ) const
finalvirtualinherited

check if node X and node Y are independent given nodes Z

Implements gum::GraphicalModel.

Definition at line 152 of file DAGmodel_inl.h.

152 {
153 return dag_.dSeparation(X, Y, Z);
154 }

Referenced by gum::BayesNet< double >::ancestors(), and isIndependent().

Here is the caller graph for this function:

◆ isIndependent() [4/4]

INLINE bool gum::DAGmodel::isIndependent ( std::string_view Xname,
std::string_view Yname,
const std::vector< std::string > & Znames ) const
inherited

build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes

Parameters
nodesthe set of nodeId
nodenamesthe vector of names of nodes
Returns
the moralized ancestral graph

Definition at line 178 of file DAGmodel_inl.h.

180 {
181 return isIndependent(idFromName(Xname), idFromName(Yname), nodeset(Znames));
182 }

References gum::DiscreteGraphicalModel::idFromName(), isIndependent(), and gum::GraphicalModel::nodeset().

Here is the call graph for this function:

◆ jointProbability()

template<GUM_Numeric GUM_SCALAR>
GUM_SCALAR gum::IBayesNet< GUM_SCALAR >::jointProbability ( const Instantiation & i) const
inherited

Compute a parameter of the joint probability for the BN (given an instantiation of the vars).

Warning
a variable not present in the instantiation is assumed to be instantiated to 0.

Definition at line 238 of file IBayesNet_tpl.h.

238 {
239 auto value = (GUM_SCALAR)1.0;
240
242
243 for (auto node: nodes()) {
244 if ((tmp = cpt(node)[i]) == (GUM_SCALAR)0) { return (GUM_SCALAR)0; }
245
246 value *= tmp;
247 }
248
249 return value;
250 }

◆ log10DomainSize()

INLINE double gum::GraphicalModel::log10DomainSize ( ) const
inherited

Definition at line 93 of file graphicalModel_inl.h.

93 {
94 double dSize = 0.0;
95
96 for (const auto node: nodes()) {
97 dSize += std::log10(variable(node).domainSize());
98 }
99
100 return dSize;
101 }

References nodes().

Referenced by gum::IMarkovRandomField< GUM_SCALAR >::toString(), and gum::InfluenceDiagram< GUM_SCALAR >::toString().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ log2JointProbability()

template<GUM_Numeric GUM_SCALAR>
GUM_SCALAR gum::IBayesNet< GUM_SCALAR >::log2JointProbability ( const Instantiation & i) const
inherited

Compute a parameter of the log joint probability for the BN (given an instantiation of the vars).

Compute a parameter of the joint probability for the BN (given an instantiation of the vars).

Warning
a variable not present in the instantiation is assumed to be instantiated to 0.

Definition at line 256 of file IBayesNet_tpl.h.

256 {
257 auto value = (GUM_SCALAR)0.0;
258
260
261 for (auto node: nodes()) {
262 if ((tmp = cpt(node)[i]) == (GUM_SCALAR)0) {
264 }
265
266 value += std::log2(cpt(node)[i]);
267 }
268
269 return value;
270 }

References cpt(), and gum::DAGmodel::nodes().

Here is the call graph for this function:

◆ maxNonOneParam()

template<GUM_Numeric GUM_SCALAR>
GUM_SCALAR gum::IBayesNet< GUM_SCALAR >::maxNonOneParam ( ) const
inherited
Returns
the biggest value (not equal to 1) in the CPTs of *this
Warning
can return one if no other value in the CPTs than one....

Definition at line 170 of file IBayesNet_tpl.h.

170 {
171 GUM_SCALAR res = 0.0;
172 for (auto node: nodes()) {
173 auto v = cpt(node).maxNonOne();
174 if (v > res) { res = v; }
175 }
176 return res;
177 }

◆ maxParam()

template<GUM_Numeric GUM_SCALAR>
GUM_SCALAR gum::IBayesNet< GUM_SCALAR >::maxParam ( ) const
inherited
Returns
the biggest value in the CPTs of *this

Definition at line 150 of file IBayesNet_tpl.h.

150 {
151 GUM_SCALAR res = 1.0;
152 for (auto node: nodes()) {
153 auto v = cpt(node).max();
154 if (v > res) { res = v; }
155 }
156 return res;
157 }

References gum::DAGmodel::nodes().

Here is the call graph for this function:

◆ maxVarDomainSize()

template<GUM_Numeric GUM_SCALAR>
Size gum::IBayesNet< GUM_SCALAR >::maxVarDomainSize ( ) const
inherited
Returns
the biggest domainSize among the variables of *this

Definition at line 130 of file IBayesNet_tpl.h.

130 {
131 Size res = 0;
132 for (auto node: nodes()) {
133 auto v = variable(node).domainSize();
134 if (v > res) { res = v; }
135 }
136 return res;
137 }

References gum::DAGmodel::nodes(), and gum::DiscreteGraphicalModel::variable().

Referenced by gum::ImportanceSampling< GUM_SCALAR >::onContextualize_().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ memoryFootprint()

template<GUM_Numeric GUM_SCALAR>
Size gum::IBayesNet< GUM_SCALAR >::memoryFootprint ( ) const
inherited

compute the (approximated) footprint in memory of the model (the footprints of CPTs)

Returns
the size in bytes

Definition at line 180 of file IBayesNet_tpl.h.

180 {
181 Size usedMem = 0;
182
183 for (auto node: nodes())
184 usedMem += cpt(node).memoryFootprint();
185 return usedMem;
186 }

◆ minimalCondSet() [1/4]

INLINE NodeSet gum::DAGmodel::minimalCondSet ( const NodeSet & targets,
const NodeSet & soids ) const
inherited

Definition at line 164 of file DAGmodel_inl.h.

164 {
165 return dag_.minimalCondSet(targets, soids);
166 }

◆ minimalCondSet() [2/4]

INLINE NodeSet gum::DAGmodel::minimalCondSet ( const std::vector< std::string > & targets,
const std::vector< std::string > & soids ) const
inherited

Definition at line 173 of file DAGmodel_inl.h.

174 {
175 return dag_.minimalCondSet(nodeset(targets), nodeset(soids));
176 }

◆ minimalCondSet() [3/4]

INLINE NodeSet gum::DAGmodel::minimalCondSet ( NodeId target,
const NodeSet & soids ) const
inherited

Definition at line 160 of file DAGmodel_inl.h.

160 {
161 return dag_.minimalCondSet(target, soids);
162 }

Referenced by gum::ASTposteriorProba< GUM_SCALAR >::_compute_knw_from_bn().

Here is the caller graph for this function:

◆ minimalCondSet() [4/4]

INLINE NodeSet gum::DAGmodel::minimalCondSet ( std::string_view target,
const std::vector< std::string > & soids ) const
inherited

Definition at line 168 of file DAGmodel_inl.h.

169 {
170 return dag_.minimalCondSet(idFromName(target), nodeset(soids));
171 }

References dag_, gum::DiscreteGraphicalModel::idFromName(), and gum::GraphicalModel::nodeset().

Here is the call graph for this function:

◆ minNonZeroParam()

template<GUM_Numeric GUM_SCALAR>
GUM_SCALAR gum::IBayesNet< GUM_SCALAR >::minNonZeroParam ( ) const
inherited
Returns
the smallest value (not equal to 0) in the CPTs of *this
Warning
can return 0 if no other value in the CPTs than 0...

Definition at line 160 of file IBayesNet_tpl.h.

160 {
161 GUM_SCALAR res = 1.0;
162 for (auto node: nodes()) {
163 auto v = cpt(node).minNonZero();
164 if (v < res) { res = v; }
165 }
166 return res;
167 }

Referenced by gum::ImportanceSampling< GUM_SCALAR >::onContextualize_().

Here is the caller graph for this function:

◆ minParam()

template<GUM_Numeric GUM_SCALAR>
GUM_SCALAR gum::IBayesNet< GUM_SCALAR >::minParam ( ) const
inherited
Returns
the smallest value in the CPTs of *this

Definition at line 140 of file IBayesNet_tpl.h.

140 {
141 GUM_SCALAR res = 1.0;
142 for (auto node: nodes()) {
143 auto v = cpt(node).min();
144 if (v < res) { res = v; }
145 }
146 return res;
147 }

References gum::DAGmodel::nodes().

Here is the call graph for this function:

◆ moralGraph()

UndiGraph gum::DAGmodel::moralGraph ( ) const
inherited

The node's id are coherent with the variables and nodes of the topology.

Definition at line 81 of file DAGmodel.cpp.

81 {
82 auto g = dag_.moralGraph();
83 _nameNodes_(g);
84 return g;
85 }

References gum::GraphicalModel::_nameNodes_(), and dag_.

Referenced by gum::prm::SVE< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodes_(), gum::prm::SVE< GUM_SCALAR >::_eliminateNodesWithEvidence_(), gum::prm::SVED< GUM_SCALAR >::_eliminateNodesWithEvidence_(), gum::prm::SVE< GUM_SCALAR >::_initLiftedNodes_(), and gum::prm::SVED< GUM_SCALAR >::_initLiftedNodes_().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ moralizedAncestralGraph() [1/2]

INLINE UndiGraph gum::DAGmodel::moralizedAncestralGraph ( const NodeSet & nodes) const
inherited

build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes

Parameters
nodesthe set of nodeId
nodenamesthe vector of names of nodes
Returns
the moralized ancestral graph

Definition at line 146 of file DAGmodel_inl.h.

146 {
147 auto g = dag_.moralizedAncestralGraph(nodes);
148 _nameNodes_(g);
149 return g;
150 }

References gum::GraphicalModel::_nameNodes_(), dag_, and nodes().

Referenced by moralizedAncestralGraph().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ moralizedAncestralGraph() [2/2]

INLINE UndiGraph gum::DAGmodel::moralizedAncestralGraph ( const std::vector< std::string > & nodenames) const
inherited

build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes

Parameters
nodesthe set of nodeId
nodenamesthe vector of names of nodes
Returns
the moralized ancestral graph

Definition at line 142 of file DAGmodel_inl.h.

142 {
143 return moralizedAncestralGraph(nodeset(nodenames));
144 }
UndiGraph moralizedAncestralGraph(const NodeSet &nodes) const
build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes

References moralizedAncestralGraph(), and gum::GraphicalModel::nodeset().

Here is the call graph for this function:

◆ names() [1/2]

INLINE std::vector< std::string > gum::GraphicalModel::names ( const NodeSet & ids) const
inherited

transform a NodeSet in a vector of names

Returns
the vector of names

Definition at line 129 of file graphicalModel_inl.h.

129 {
130 const VariableNodeMap& v = variableNodeMap();
131 std::vector< std::string > res;
132 for (auto n: ids) {
133 res.push_back(v.name(n));
134 }
135 return res;
136 }

References ids(), gum::VariableNodeMap::name(), and variableNodeMap().

Here is the call graph for this function:

◆ names() [2/2]

INLINE std::vector< std::string > gum::GraphicalModel::names ( const std::vector< NodeId > & ids) const
inherited

transform a vector of NodeId in a vector of names

Returns
the vector of names

Definition at line 117 of file graphicalModel_inl.h.

117 {
118 std::vector< std::string > res;
119 const VariableNodeMap& v = variableNodeMap();
120
121 std::ranges::transform(ids, std::back_inserter(res), [&v](const NodeId n) {
122 return v[n].name();
123 });
124
125 return res;
126 }
Size NodeId
Type for node ids.

References ids().

Referenced by gum::DAGmodel::children(), exists(), ids(), nodeset(), and gum::DAGmodel::parents().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ nodeId()

template<GUM_Numeric GUM_SCALAR>
INLINE NodeId gum::DiscreteGraphicalModel::nodeId ( const DiscreteVariable & var) const
overridevirtual

Returns the NodeId of a variable.

Exceptions
NotFoundif no variable matches var.

Implements gum::GraphicalModel.

Definition at line 98 of file discreteGraphicalModel_inl.h.

56 {
57 return varMap_.get(var);
58 }

◆ nodes()

INLINE const NodeGraphPart & gum::DAGmodel::nodes ( ) const
finalvirtualinherited

Returns a named copy of the internal DAG: each node id is assigned the name of the corresponding variable.

O(n) — allocates a new DAG. For a stable reference (listeners, long-lived pointers), use internalDag().

Implements gum::GraphicalModel.

Definition at line 119 of file DAGmodel_inl.h.

119 {
120 return static_cast< const NodeGraphPart& >(dag_);
121 }

References dag_.

Referenced by gum::BayesNetFragment< GUM_SCALAR >::BayesNetFragment(), gum::Estimator< GUM_SCALAR >::Estimator(), gum::BayesNetFragment< GUM_SCALAR >::~BayesNetFragment(), gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::_verticesSampling_(), gum::BayesNet< GUM_SCALAR >::beginTopologyTransformation(), gum::InfluenceDiagram< GUM_SCALAR >::beginTopologyTransformation(), gum::IBayesNet< GUM_SCALAR >::check(), gum::BayesNetFragment< GUM_SCALAR >::checkConsistency(), gum::BayesNet< GUM_SCALAR >::clear(), gum::InfluenceDiagram< GUM_SCALAR >::copyStructureAndTables_(), gum::IBayesNet< GUM_SCALAR >::dim(), gum::BayesNet< GUM_SCALAR >::endTopologyTransformation(), gum::InfluenceDiagram< GUM_SCALAR >::endTopologyTransformation(), gum::InfluenceDiagram< GUM_SCALAR >::fastPrototype(), gum::BayesNet< GUM_SCALAR >::generateCPTs(), gum::getMaxModality(), hasSameStructure(), gum::IBayesNet< GUM_SCALAR >::log2JointProbability(), gum::IBayesNet< GUM_SCALAR >::maxParam(), gum::IBayesNet< GUM_SCALAR >::maxVarDomainSize(), gum::IBayesNet< GUM_SCALAR >::minParam(), gum::prm::ClassBayesNet< GUM_SCALAR >::modalities(), gum::prm::InstanceBayesNet< GUM_SCALAR >::modalities(), moralizedAncestralGraph(), gum::IBayesNet< GUM_SCALAR >::operator==(), gum::InfluenceDiagram< GUM_SCALAR >::operator==(), gum::Estimator< GUM_SCALAR >::setFromBN(), gum::BayesNetFragment< GUM_SCALAR >::toBN(), gum::prm::ClassBayesNet< GUM_SCALAR >::toDot(), gum::prm::InstanceBayesNet< GUM_SCALAR >::toDot(), and gum::ImportanceSampling< GUM_SCALAR >::unsharpenBN_().

◆ nodeset()

NodeSet gum::GraphicalModel::nodeset ( const std::vector< std::string > & names) const
inherited

transform a vector of names into a NodeSet

Returns
NodeSet

Definition at line 102 of file graphicalModel.cpp.

102 {
103 NodeSet res;
104 for (const auto& name: names) {
105 res.insert(idFromName(name));
106 }
107 return res;
108 }
virtual NodeId idFromName(std::string_view name) const =0
Getter by name.
Set< NodeId > NodeSet
Some typdefs and define for shortcuts ...

References idFromName(), gum::Set< Key >::insert(), and names().

Referenced by gum::BayesNet< double >::ancestors(), gum::DAGmodel::children(), gum::DAGmodel::isIndependent(), gum::UGmodel::isIndependent(), gum::UGmodel::isIndependent(), gum::DAGmodel::minimalCondSet(), and gum::DAGmodel::moralizedAncestralGraph().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ operator=() [1/2]

template<GUM_Numeric GUM_SCALAR>
BayesNet< GUM_SCALAR > & gum::BayesNet< GUM_SCALAR >::operator= ( BayesNet< GUM_SCALAR > && source)

Move operator.

Parameters
sourceThe moved BayesNet.
Returns
The moved-to BayesNet.

Definition at line 164 of file BayesNet_tpl.h.

164 {
165 if (this != &source) {
170 }
171 return *this;
172 }
void _clearTensors_()
clear all tensors
IBayesNet< GUM_SCALAR > & operator=(const IBayesNet< GUM_SCALAR > &source)
Copy operator.

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

Here is the call graph for this function:

◆ operator=() [2/2]

template<GUM_Numeric GUM_SCALAR>
BayesNet< GUM_SCALAR > & gum::BayesNet< GUM_SCALAR >::operator= ( const BayesNet< GUM_SCALAR > & source)

Copy operator.

Parameters
sourceThe copied BayesNet.
Returns
The copy of source.

Definition at line 152 of file BayesNet_tpl.h.

152 {
153 if (this != &source) {
158 }
159
160 return *this;
161 }

References BayesNet(), _clearTensors_(), _copyTensors_(), and gum::IBayesNet< GUM_SCALAR >::operator=().

Here is the call graph for this function:

◆ operator==()

template<GUM_Numeric GUM_SCALAR>
bool gum::IBayesNet< GUM_SCALAR >::operator== ( const IBayesNet< GUM_SCALAR > & from) const
inherited

This operator compares 2 BNs !

Warning
To identify nodes between BNs, it is assumed that they share the same name.
Returns
true if the src and this are equal.

Definition at line 273 of file IBayesNet_tpl.h.

273 {
274 if (size() != from.size()) { return false; }
275
276 if (sizeArcs() != from.sizeArcs()) { return false; }
277
278 for (auto node: nodes()) {
279 const auto& v1 = variable(node);
280 if (!from.exists(v1.name())) { return false; }
281 const auto& v2 = from.variableFromName(v1.name());
282 if (v1 != v2) { return false; }
283 }
284
285 for (auto node: nodes()) {
287
288 if (cpt(node).nbrDim() != from.cpt(fromnode).nbrDim()) { return false; }
289
290 if (cpt(node).domainSize() != from.cpt(fromnode).domainSize()) { return false; }
291
292 for (Idx i = 0; i < cpt(node).nbrDim(); ++i) {
293 if (!from.cpt(fromnode).contains(from.variableFromName(cpt(node).variable(i).name()))) {
294 return false;
295 }
296 }
297
300
302 for (i.setFirst(); !i.end(); i.inc()) {
303 for (Idx indice = 0; indice < cpt(node).nbrDim(); ++indice) {
304 const DiscreteVariable* p = &(i.variable(indice));
305 j.chgVal(j.pos(from.variableFromName(p->name())), i.val(*p));
306 }
307
308 if (cmp(cpt(node).get(i), from.cpt(fromnode).get(j))) { return false; }
309 }
310 }
311
312 return true;
313 }
bool exists(NodeId node) const final
Return true if this node exists in this graphical model.

References IBayesNet(), gum::Instantiation::chgVal(), cpt(), gum::Instantiation::end(), gum::DAGmodel::exists(), gum::DiscreteGraphicalModel::idFromName(), gum::Instantiation::inc(), gum::Variable::name(), gum::DAGmodel::nodes(), gum::Instantiation::pos(), gum::Instantiation::setFirst(), gum::DAGmodel::size(), gum::DAGmodel::sizeArcs(), gum::Instantiation::val(), gum::DiscreteGraphicalModel::variable(), gum::Instantiation::variable(), and gum::DiscreteGraphicalModel::variableFromName().

Here is the call graph for this function:

◆ parents() [1/4]

INLINE const NodeSet & gum::DAGmodel::parents ( const NodeId id) const
inherited

returns the set of nodes with arc ingoing to a given node

Note that the set of nodes returned may be empty if no arc within the ArcGraphPart is ingoing into the given node.

Parameters
idthe node which is the head of an arc with the returned nodes
namethe name of the node the node which is the head of an arc with the returned nodes

Definition at line 83 of file DAGmodel_inl.h.

83{ return dag_.parents(id); }

References dag_.

Referenced by gum::IBayesNet< GUM_SCALAR >::check(), gum::BayesNetFragment< GUM_SCALAR >::checkConsistency(), gum::InfluenceDiagram< GUM_SCALAR >::copyStructureAndTables_(), gum::IBayesNet< GUM_SCALAR >::dim(), gum::ASTposteriorProba< GUM_SCALAR >::eval(), gum::BayesNetFragment< GUM_SCALAR >::installCPT(), gum::BayesNetFragment< GUM_SCALAR >::installCPT_(), parents(), gum::prm::ClassBayesNet< GUM_SCALAR >::toDot(), and gum::prm::InstanceBayesNet< GUM_SCALAR >::toDot().

Here is the caller graph for this function:

◆ parents() [2/4]

INLINE NodeSet gum::DAGmodel::parents ( const NodeSet & ids) const
inherited

returns the parents of a set of nodes

Definition at line 107 of file DAGmodel_inl.h.

107{ return dag_.parents(ids); }

References dag_, and gum::GraphicalModel::ids().

Here is the call graph for this function:

◆ parents() [3/4]

INLINE NodeSet gum::DAGmodel::parents ( const std::vector< std::string > & names) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 109 of file DAGmodel_inl.h.

109 {
110 return parents(nodeset(names));
111 }

References gum::GraphicalModel::names().

Here is the call graph for this function:

◆ parents() [4/4]

INLINE const NodeSet & gum::DAGmodel::parents ( std::string_view name) const
inherited

return true if the arc tail->head exists in the DAGmodel

Parameters
tailthe nodeId (or the name) of the tail in tail->head
headthe nodeId (or the name) of the head in tail->head
Returns
true if the arc exists

Definition at line 85 of file DAGmodel_inl.h.

85 {
86 return parents(idFromName(name));
87 }

References gum::DiscreteGraphicalModel::idFromName(), and parents().

Here is the call graph for this function:

◆ properties()

INLINE std::vector< std::string > gum::GraphicalModel::properties ( ) const
inherited

List of all the names of property in the Graphical model.

Definition at line 79 of file graphicalModel_inl.h.

79 {
80 std::vector< std::string > prop;
81 for (const auto& [p, v]: _propertiesMap_)
82 prop.push_back(p);
83 return prop;
84 }

References _propertiesMap_.

◆ property()

INLINE const std::string & gum::GraphicalModel::property ( std::string_view name) const
inherited

Return the value of the property name of this GraphicalModel.

Exceptions
NotFoundRaised if no name property is found.

Definition at line 60 of file graphicalModel_inl.h.

60 {
61 auto p = _properties_().tryGet(name);
62 if (!p) { GUM_ERROR(NotFound, "The following property does not exists: " << name) }
63 return *p;
64 }
const HashTable< std::string, std::string > & _properties_() const
Return the properties of this Directed Graphical Model.
optional_ref< Val > tryGet(const Key &key)
Returns a pointer to the value associated with a given key, or nullptr if the key does not exist.

References _properties_(), GUM_ERROR, and gum::HashTable< Key, Val >::tryGet().

Here is the call graph for this function:

◆ propertyWithDefault()

INLINE const std::string & gum::GraphicalModel::propertyWithDefault ( std::string_view name,
const std::string & byDefault ) const
inherited

Return the value of the property name of this GraphicalModel.

return byDefault if the property name is not found

Definition at line 72 of file graphicalModel_inl.h.

73 {
74 auto p = _propertiesMap_.tryGet(name);
75 return p ? *p : byDefault;
76 }

References _propertiesMap_.

Referenced by gum::IBayesNet< GUM_SCALAR >::toDot(), gum::IMarkovRandomField< GUM_SCALAR >::toDot(), gum::InfluenceDiagram< GUM_SCALAR >::toDot(), and gum::IMarkovRandomField< GUM_SCALAR >::toDotAsFactorGraph().

Here is the caller graph for this function:

◆ reverseArc() [1/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::reverseArc ( const Arc & arc)

Reverses an arc while preserving the same joint distribution.

This method uses Shachter's 1986 algorithm for reversing an arc in the Bayes net while preserving the same joint distribution. By performing this reversal, we also add new arcs (required to not alter the joint distribution)

Exceptions
InvalidArcexception if the arc does not exist or if its reversal would induce a directed cycle.

Definition at line 325 of file BayesNet_tpl.h.

325 {
326 // check that the arc exists
327 if (!this->varMap_.exists(arc.tail()) || !this->varMap_.exists(arc.head())
328 || !dag().existsArc(arc)) {
329 GUM_ERROR(InvalidArc, "a non-existing arc cannot be reversed")
330 }
331
332 NodeId tail = arc.tail();
333 NodeId head = arc.head();
334
335 // check that the reversal does not induce a cycle
336 try {
337 DAG d = dag();
338 d.eraseArc(arc);
339 d.addArc(head, tail);
340 } catch (Exception const&) {
341 GUM_ERROR(InvalidArc, "this arc reversal would induce a directed cycle")
342 }
343
344 // with the same notations as Shachter (1986), "evaluating influence
345 // diagrams", p.878, we shall first compute the product of probabilities:
346 // pi_j^old (x_j | x_c^old(j) ) * pi_i^old (x_i | x_c^old(i) )
348
349 // modify the topology of the graph: add to tail all the parents of head
350 // and add to head all the parents of tail
353 for (const auto node: this->parents(tail))
354 new_parents.insert(node);
355 for (const auto node: this->parents(head))
356 new_parents.insert(node);
357 // remove arc (head, tail)
358 eraseArc(arc);
359
360 // add the necessary arcs to the tail
361 for (const auto p: new_parents) {
362 if ((p != tail) && !dag().existsArc(p, tail)) { addArc(p, tail); }
363 }
364
365 addArc(head, tail);
366 // add the necessary arcs to the head
368
369 for (const auto p: new_parents) {
370 if ((p != head) && !dag().existsArc(p, head)) { addArc(p, head); }
371 }
372
374
375 // update the conditional distributions of head and tail
377 del_vars << &(variable(tail));
379
380 auto& cpt_head = const_cast< Tensor< GUM_SCALAR >& >(cpt(head));
382
384 auto& cpt_tail = const_cast< Tensor< GUM_SCALAR >& >(cpt(tail));
386 }

References gum::DAGmodel::dag(), gum::DAGmodel::existsArc(), GUM_ERROR, gum::Arc::head(), gum::Arc::tail(), and gum::DiscreteGraphicalModel::varMap_.

Here is the call graph for this function:

◆ reverseArc() [2/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::reverseArc ( NodeId tail,
NodeId head )

Reverses an arc while preserving the same joint distribution.

This method uses Shachter's 1986 algorithm for reversing an arc in the Bayes net while preserving the same joint distribution. By performing this reversal, we also add new arcs (required to not alter the joint distribution)

Exceptions
InvalidArcexception if the arc does not exist or if its reversal would induce a directed cycle.

Definition at line 389 of file BayesNet_tpl.h.

389 {
391 }
void reverseArc(NodeId tail, NodeId head)
Reverses an arc while preserving the same joint distribution.

References reverseArc().

Referenced by reverseArc(), and reverseArc().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ reverseArc() [3/3]

template<GUM_Numeric GUM_SCALAR>
void gum::BayesNet< GUM_SCALAR >::reverseArc ( std::string_view tail,
std::string_view head )

Reverses an arc while preserving the same joint distribution.

This method uses Shachter's 1986 algorithm for reversing an arc in the Bayes net while preserving the same joint distribution. By performing this reversal, we also add new arcs (required to not alter the joint distribution)

Exceptions
InvalidArcexception if the arc does not exist or if its reversal would induce a directed cycle.

Definition at line 726 of file BayesNet_tpl.h.

726 {
728 }

References idFromName(), and reverseArc().

Here is the call graph for this function:

◆ setProperty()

INLINE void gum::GraphicalModel::setProperty ( std::string_view name,
std::string_view value )
inherited

Add or change a property of this GraphicalModel.

Definition at line 87 of file graphicalModel_inl.h.

87 {
88 if (auto p = _propertiesMap_.tryGet(name)) *p = value;
89 else _propertiesMap_.insert(std::string(name), std::string(value));
90 }

References _propertiesMap_.

Referenced by gum::IBayesNet< GUM_SCALAR >::IBayesNet(), gum::IMarkovRandomField< GUM_SCALAR >::IMarkovRandomField(), and gum::InfluenceDiagram< GUM_SCALAR >::fastPrototype().

Here is the caller graph for this function:

◆ size()

INLINE Size gum::DAGmodel::size ( ) const
finalvirtualinherited

Returns the number of variables in this Directed Graphical Model.

Implements gum::GraphicalModel.

Definition at line 68 of file DAGmodel_inl.h.

68{ return dag_.size(); }

References dag_.

Referenced by gum::InfluenceDiagram< GUM_SCALAR >::copyStructureAndTables_(), gum::InfluenceDiagram< GUM_SCALAR >::decisionNodeSize(), hasSameStructure(), gum::MarkovBlanket::hasSameStructure(), gum::IBayesNet< GUM_SCALAR >::operator==(), gum::InfluenceDiagram< GUM_SCALAR >::operator==(), gum::prm::ClassBayesNet< GUM_SCALAR >::toDot(), and gum::prm::InstanceBayesNet< GUM_SCALAR >::toDot().

Here is the caller graph for this function:

◆ sizeArcs()

INLINE Size gum::DAGmodel::sizeArcs ( ) const
inherited

Returns the number of arcs in this Directed Graphical Model.

Definition at line 71 of file DAGmodel_inl.h.

71{ return dag_.sizeArcs(); }

References dag_.

Referenced by hasSameStructure(), gum::MarkovBlanket::hasSameStructure(), gum::IBayesNet< GUM_SCALAR >::operator==(), gum::InfluenceDiagram< GUM_SCALAR >::operator==(), and gum::InfluenceDiagram< GUM_SCALAR >::toString().

Here is the caller graph for this function:

◆ spaceCplxToString()

std::string gum::GraphicalModel::spaceCplxToString ( double dSize,
int dim,
Size usedMem )
staticinherited

send to the stream the space complexity with 3 parametrs

Parameters
sthe stream
dSizethe log10domainSize
dimthe dimension
usedMemthe memory needed for the params

Definition at line 110 of file graphicalModel.cpp.

110 {
111 std::string result;
112 if (dSize > 6) result = std::format("domainSize: 10^{:.6g}", dSize);
113 else result = std::format("domainSize: {}", (long long)std::round(std::pow(10.0, dSize)));
114
115 result += std::format(", dim: {}, mem: ", dim);
116
117 if (const Size go = usedMem / (1024 * 1024 * 1024); go > 0) result += std::format("{}Go ", go);
118 if (const Size mo = (usedMem / (1024 * 1024)) % 1024; mo > 0)
119 result += std::format("{}Mo ", mo);
120 if (const Size ko = (usedMem / 1024) % 1024; ko > 0) result += std::format("{}Ko ", ko);
121 result += std::format("{}o", usedMem % 1024);
122 return result;
123 }
std::size_t Size
In aGrUM, hashed values are unsigned long int.
Definition types.h:74

◆ toDot()

template<GUM_Numeric GUM_SCALAR>
std::string gum::IBayesNet< GUM_SCALAR >::toDot ( ) const
virtualinherited
Returns
Returns a dot representation of this IBayesNet.

Reimplemented in gum::BayesNetFragment< GUM_SCALAR >, gum::prm::ClassBayesNet< GUM_SCALAR >, and gum::prm::InstanceBayesNet< GUM_SCALAR >.

Definition at line 198 of file IBayesNet_tpl.h.

198 {
200
201 std::string bn_name = this->propertyWithDefault("name", "no_name");
202
203 output << std::format("digraph \"{}\" {{\n", bn_name);
204 output << std::format(" graph [bgcolor=transparent,label=\"{}\"];\n", bn_name);
205 output << " node [style=filled fillcolor=\"#ffffaa\"];" << std::endl << std::endl;
206
207 for (auto node: nodes())
208 output << std::format("\"{}\" [comment=\"{}:{}\"];\n",
209 variable(node).name(),
210 node,
212
213 output << std::endl;
214
215 std::string tab = " ";
216
217 for (auto node: nodes()) {
218 if (children(node).size() > 0) {
219 for (auto child: children(node)) {
220 output << std::format(" \"{}\" -> \"{}\";\n",
221 variable(node).name(),
222 variable(child).name());
223 }
224 } else if (parents(node).size() == 0) {
225 output << std::format(" \"{}\";\n", variable(node).name());
226 }
227 }
228
229 output << "}" << std::endl;
230
231 return output.str();
232 }
const std::string & propertyWithDefault(std::string_view name, const std::string &byDefault) const
Return the value of the property name of this GraphicalModel.

References gum::GraphicalModel::propertyWithDefault().

Here is the call graph for this function:

◆ topologicalOrder()

INLINE Sequence< NodeId > gum::DAGmodel::topologicalOrder ( ) const
inherited

The topological order stays the same as long as no variable or arcs are added or erased src the topology.

Parameters
clearIf false returns the previously created topology.

Definition at line 123 of file DAGmodel_inl.h.

123{ return dag_.topologicalOrder(); }

References dag_.

Referenced by gum::InfluenceDiagramGenerator< GUM_SCALAR >::_checkTemporalOrder_(), gum::InfluenceDiagram< GUM_SCALAR >::decisionOrder(), and gum::InfluenceDiagram< GUM_SCALAR >::decisionOrderExists().

Here is the caller graph for this function:

◆ toString()

template<GUM_Numeric GUM_SCALAR>
std::string gum::IBayesNet< GUM_SCALAR >::toString ( ) const
inherited
Returns
Returns a string representation of this IBayesNet.

Definition at line 189 of file IBayesNet_tpl.h.

189 {
191 s << std::format("BN{{nodes: {}, arcs: {}, ", size(), dag().sizeArcs());
193 s << "}";
194 return s.str();
195 }
double log10DomainSize() const
static std::string spaceCplxToString(double dSize, int dim, Size usedMem)
send to the stream the space complexity with 3 parametrs
Size memoryFootprint() const
compute the (approximated) footprint in memory of the model (the footprints of CPTs)

Referenced by gum::operator<<().

Here is the caller graph for this function:

◆ updateMetaData()

void gum::GraphicalModel::updateMetaData ( )
inherited

update the meta data of this Graphical Model (version, creation date, last modification date) This method is called by the writers ONLY before writing the model to a file.

Definition at line 81 of file graphicalModel.cpp.

81 {
82 auto const time = std::chrono::time_point_cast< std::chrono::milliseconds >(
83 std::chrono::system_clock::now());
84 auto const currentdate = std::format("{:%Y-%m-%d %T}", time);
85
86 const std::string currentSoftware = "aGrUM " GUM_VERSION;
87 if (auto software = _propertiesMap_.tryGet("software")) {
88 *software = currentSoftware;
89 } else {
90 _propertiesMap_.insert("software", currentSoftware);
91 }
92
93 if (!_propertiesMap_.tryGet("creation")) { _propertiesMap_.insert("creation", currentdate); }
94
95 if (auto lastModification = _propertiesMap_.tryGet("lastModification")) {
96 *lastModification = currentdate;
97 } else {
98 _propertiesMap_.insert("lastModification", currentdate);
99 }
100 }

References _propertiesMap_.

◆ variable() [1/2]

template<GUM_Numeric GUM_SCALAR>
INLINE const DiscreteVariable & gum::DiscreteGraphicalModel::variable ( NodeId id) const
overridevirtual

Returns a constant reference over a variable given its node id.

Exceptions
NotFoundif no variable's id matches id.

Implements gum::GraphicalModel.

Definition at line 92 of file discreteGraphicalModel_inl.h.

51 {
52 return varMap_.get(id);
53 }

◆ variable() [2/2]

template<GUM_Numeric GUM_SCALAR>
const DiscreteVariable & gum::BayesNet< GUM_SCALAR >::variable ( std::string_view name) const

Returns a gum::DiscreteVariable given its name in the gum::BayesNet.

Definition at line 703 of file BayesNet_tpl.h.

703 {
704 return variable(idFromName(name));
705 }

References idFromName(), and variable().

Referenced by add(), erase(), eraseArc(), generateCPT(), gum::getMaxModality(), and variable().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ variableFromName()

template<GUM_Numeric GUM_SCALAR>
INLINE const DiscreteVariable & gum::DiscreteGraphicalModel::variableFromName ( std::string_view name) const
overridevirtual

Returns a constant reference over a variable given its name.

Exceptions
NotFoundif no such name exists in the model.

Implements gum::GraphicalModel.

Definition at line 110 of file discreteGraphicalModel_inl.h.

66 {
67 return varMap_.variableFromName(name);
68 }

◆ variableNodeMap()

template<GUM_Numeric GUM_SCALAR>
INLINE const VariableNodeMap & gum::DiscreteGraphicalModel::variableNodeMap ( ) const
overridevirtual

Returns a constant reference to the VariableNodeMap of this model.

Implements gum::GraphicalModel.

Definition at line 86 of file discreteGraphicalModel_inl.h.

48{ return varMap_; }

◆ variables() [1/2]

INLINE VariableSet gum::GraphicalModel::variables ( const NodeSet & ids) const
inherited

transform a vector of NodeId into a VariableeSet

Returns
NodeSet

Definition at line 160 of file graphicalModel_inl.h.

160 {
161 VariableSet s;
162 const VariableNodeMap& v = variableNodeMap();
163 for (const auto& node: l) {
164 s.insert(&v.get(node));
165 }
166 return s;
167 }
Set< const DiscreteVariable * > VariableSet

◆ variables() [2/2]

INLINE VariableSet gum::GraphicalModel::variables ( const std::vector< std::string > & l) const
inherited

transform a vector of names into a VariableeSet

Returns
NodeSet

Definition at line 150 of file graphicalModel_inl.h.

150 {
151 VariableSet s;
152 const VariableNodeMap& v = variableNodeMap();
153 for (const auto& name: l) {
154 s.insert(&v.variableFromName(name));
155 }
156 return s;
157 }

References gum::Set< Key >::insert(), gum::VariableNodeMap::variableFromName(), and variableNodeMap().

Here is the call graph for this function:

◆ BayesNetFactory< GUM_SCALAR >

template<GUM_Numeric GUM_SCALAR>
friend class BayesNetFactory< GUM_SCALAR >
friend

Definition at line 665 of file BayesNet.h.

Member Data Documentation

◆ _probaMap_

template<GUM_Numeric GUM_SCALAR>
NodeProperty< Tensor< GUM_SCALAR >* > gum::BayesNet< GUM_SCALAR >::_probaMap_
private

Mapping between the variable's id and their CPT.

Definition at line 639 of file BayesNet.h.

Referenced by BayesNet(), ~BayesNet(), _clearTensors_(), _unsafeChangeTensor_(), add(), beginTopologyTransformation(), cpt(), endTopologyTransformation(), erase(), and eraseArc().

◆ _propertiesMap_

HashTable< std::string, std::string > gum::GraphicalModel::_propertiesMap_
privateinherited

The properties of this Directed Graphical Model.

Definition at line 262 of file graphicalModel.h.

Referenced by GraphicalModel(), GraphicalModel(), _properties_(), existsProperty(), operator=(), operator=(), properties(), propertyWithDefault(), setProperty(), and updateMetaData().

◆ dag_

DAG gum::DAGmodel::dag_
protectedinherited

◆ varMap_


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