![]() |
aGrUM 3.0.0
a C++ library for (probabilistic) graphical models
|
Base class for dag. More...
#include <DAG.h>
Public Types | |
| using | ArcIterator = ArcSetIterator |
| using | NodeIterator = NodeGraphPartIterator |
| using | NodeConstIterator = NodeGraphPartIterator |
| using | NodeIteratorSafe = NodeGraphPartIteratorSafe |
| using | NodeConstIteratorSafe = NodeGraphPartIteratorSafe |
| using | node_iterator = NodeGraphPartIterator |
| types for STL compliance | |
| using | node_const_iterator = NodeGraphPartIterator |
| types for STL compliance | |
| using | node_iterator_safe = NodeGraphPartIteratorSafe |
| types for STL compliance | |
| using | node_const_iterator_safe = NodeGraphPartIteratorSafe |
| types for STL compliance | |
Public Member Functions | |||
| UndiGraph | moralGraph () const | ||
| build a UndiGraph by moralizing the dag | |||
| UndiGraph | moralizedAncestralGraph (const NodeSet &nodes) const | ||
| build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes | |||
| bool | dSeparation (NodeId X, NodeId Y, const NodeSet &Z) const | ||
| check if node X and node Y are independent given nodes Z (in the sense of d-separation) | |||
| bool | dSeparation (const NodeSet &X, const NodeSet &Y, const NodeSet &Z) const | ||
| check if nodes X and nodes Y are independent given Z (in the sense of d-separation) | |||
| NodeSet | minimalCondSet (NodeId target, const NodeSet &soids) const | ||
| NodeSet | minimalCondSet (const NodeSet &targets, const NodeSet &soids) const | ||
| bool | hasDirectedPath (NodeId from, NodeId to) const | ||
| checks whether there exists a directed path from from to to | |||
| std::optional< std::vector< NodeId > > | directedPath (NodeId node1, NodeId node2) const | ||
| returns a directed path from node1 to node2, or std::nullopt if none | |||
| std::optional< std::vector< NodeId > > | directedUnorientedPath (NodeId node1, NodeId node2) const | ||
| returns a shortest path from node1 to node2 ignoring arc orientation, or std::nullopt if none | |||
| NodeSet | ancestors (NodeId id) const | ||
| returns the set of all ancestors of id (nodes from which id is reachable) | |||
| NodeSet | descendants (NodeId id) const | ||
| returns the set of all descendants of id (nodes reachable from id) | |||
| NodeSet | family (NodeId id) const | ||
| returns { id } ∪ parents(id) | |||
| NodeSet | family (const NodeSet &ids) const | ||
| returns the union of families of all nodes in ids | |||
| NodeProperty< NodeId > | connectedComponents () const | ||
| returns a property {node:id of weakly connected component} | |||
Constructors / Destructors | |||
| DAG (Size nodes_size=HashTableConst::default_size, bool nodes_resize_policy=true, Size arcs_size=HashTableConst::default_size, bool arcs_resize_policy=true) | |||
| default constructor | |||
| DAG (const DAG &g) | |||
| copy constructor | |||
| DAG (DAG &&g) | |||
| move constructor | |||
| ~DAG () override | |||
| destructor | |||
Operators | |||
| DAG & | operator= (const DAG &g) | ||
| copy operator | |||
| DAG & | operator= (DAG &&g) | ||
| move assignment operator | |||
Accessors/Modifiers | |||
| void | addArc (NodeId tail, NodeId head) final | ||
| insert a new arc into the directed graph | |||
Operators | |||
| bool | operator== (const DiGraph &g) const | ||
| tests whether two DiGraphs are identical (same nodes, same arcs) | |||
Operators | |||
| bool | operator== (const ArcGraphPart &p) const | ||
| tests whether two ArcGraphParts contain the same arcs | |||
Accessors/Modifiers | |||
tests whether two DiGraphs are different
| |||
| void | eraseNode (const NodeId id) override | ||
| remove a node and its adjacent arcs from the graph | |||
| void | clear () override | ||
| removes all the nodes and arcs from the graph | |||
| std::string | toString () const override | ||
| to friendly display the content of the graph | |||
| virtual std::string | toDot () const | ||
| to friendly display the content of the graph in the DOT syntax | |||
| Sequence< NodeId > | topologicalOrder () const | ||
| Build and return a topological order. | |||
Accessors/Modifiers | |||
| virtual void | eraseArc (const Arc &arc) | ||
| removes an arc from the ArcGraphPart | |||
| bool | existsArc (const Arc &arc) const | ||
| indicates whether a given arc exists | |||
| bool | existsArc (NodeId tail, NodeId head) const | ||
| indicates whether a given arc exists | |||
| bool | emptyArcs () const | ||
| indicates wether the ArcGraphPart contains any arc | |||
| void | clearArcs () | ||
| removes all the arcs from the ArcGraphPart | |||
| Size | sizeArcs () const | ||
| indicates the number of arcs stored within the ArcGraphPart | |||
| const ArcSet & | arcs () const | ||
| returns the set of arcs stored within the ArcGraphPart | |||
| const NodeSet & | parents (NodeId id) const | ||
| returns the set of nodes with arc ingoing to a given node | |||
| NodeSet | parents (const NodeSet &ids) const | ||
| returns the set of parents of a set of nodes | |||
| NodeSet | children (const NodeSet &ids) const | ||
| returns the set of nodes which consists in the node and its parents returns the set of children of a set of nodes | |||
| const NodeSet & | children (NodeId id) const | ||
| returns the set of nodes with arc outgoing from a given node | |||
| void | eraseParents (NodeId id) | ||
| erase all the parents of a given node | |||
| void | unvirtualizedEraseParents (NodeId id) | ||
| same function as eraseParents but without any virtual call to an erase | |||
| void | eraseChildren (NodeId id) | ||
| removes all the children of a given node | |||
| void | unvirtualizedEraseChildren (NodeId id) | ||
| same function as eraseChildren but without any virtual call to an erase | |||
| template<typename VAL> | |||
| ArcProperty< VAL > | arcsProperty (VAL(*f)(const Arc &), Size size=0) const | ||
| a method to create a hashMap of VAL from a set of arcs (using for every arc, say x, the VAL f(x)) | |||
| template<typename VAL> | |||
| ArcProperty< VAL > | arcsProperty (const VAL &a, Size size=0) const | ||
| a method to create a hashMap of VAL from a set of arcs (using for every arc, say x, the VAL a) | |||
| template<typename VAL> | |||
| List< VAL > | listMapArcs (VAL(*f)(const Arc &)) const | ||
| a method to create a list of VAL from a set of arcs (using for every arc, say x, the VAL f(x)) | |||
Operators | |||
| bool | operator== (const NodeGraphPart &p) const | ||
| check whether two NodeGraphParts contain the same nodes | |||
Accessors/Modifiers | |||
| void | populateNodes (const NodeGraphPart &s) | ||
| populateNodes clears *this and fills it with the same nodes as "s" | |||
| template<typename T> | |||
| void | populateNodesFromProperty (const NodeProperty< T > &h) | ||
| populateNodesFromProperty clears *this and fills it with the keys of "h" | |||
| NodeId | nextNodeId () const | ||
| returns a new node id, not yet used by any node | |||
| virtual NodeId | addNode () | ||
| insert a new node and return its id | |||
| std::vector< NodeId > | addNodes (Size n) | ||
| insert n nodes | |||
| virtual void | addNodeWithId (const NodeId id) | ||
| try to insert a node with the given id | |||
| bool | existsNode (const NodeId id) const | ||
| returns true iff the NodeGraphPart contains the given nodeId | |||
| bool | exists (const NodeId id) const | ||
| alias for existsNode | |||
| bool | emptyNodes () const | ||
| indicates whether there exists nodes in the NodeGraphPart | |||
| bool | empty () const | ||
| alias for emptyNodes | |||
| virtual void | clearNodes () | ||
| remove all the nodes from the NodeGraphPart | |||
| Size | sizeNodes () const | ||
| returns the number of nodes in the NodeGraphPart | |||
| Size | size () const | ||
| alias for sizeNodes | |||
| NodeId | bound () const | ||
| returns a number n such that all node ids are strictly lower than n | |||
| NodeSet | asNodeSet () const | ||
| returns a copy of the set of nodes represented by the NodeGraphPart | |||
| const NodeGraphPart & | nodes () const | ||
| return *this as a NodeGraphPart | |||
| node_iterator_safe | beginSafe () const | ||
| a begin iterator to parse the set of nodes contained in the NodeGraphPart | |||
| const node_iterator_safe & | endSafe () const noexcept | ||
| the end iterator to parse the set of nodes contained in the NodeGraphPart | |||
| node_iterator | begin () const noexcept | ||
| a begin iterator to parse the set of nodes contained in the NodeGraphPart | |||
| const node_iterator & | end () const noexcept | ||
| the end iterator to parse the set of nodes contained in the NodeGraphPart | |||
| std::string | nameFromId (NodeId id) const | ||
| returns the name of node id, or "<id>" if no name is set | |||
| std::optional< NodeId > | idFromName (const std::string &name) const | ||
| returns the id of the node with the given name, or std::nullopt | |||
| void | setName (NodeId id, const std::string &name) | ||
| sets the name of node id | |||
| bool | hasName (NodeId id) const | ||
| returns true iff node id has an explicit name | |||
| std::string | dotNodeLabel (NodeId id) const | ||
| returns " [label=\"...\"]" with DOT-escaped name, or "" if no name | |||
| template<typename VAL> | |||
| NodeProperty< VAL > | nodesPropertyFromFunction (VAL(*f)(const NodeId &), Size size=0) const | ||
| a method to create a HashTable with key:NodeId and value:VAL | |||
| template<typename VAL> | |||
| NodeProperty< VAL > | nodesPropertyFromVal (const VAL &a, Size size=0) const | ||
| a method to create a hashMap with key:NodeId and value:VAL | |||
| template<typename VAL> | |||
| List< VAL > | listMapNodes (VAL(*f)(const NodeId &)) const | ||
| a method to create a list of VAL from a set of nodes (using for every nodee, say x, the VAL f(x)) | |||
Static Public Member Functions | |
Constructors / Destructors | |
| static DiGraph | completeGraph (int n) |
| Build a complete DiGraph with n nodes. | |
Public Attributes | |
| Signaler< NodeId, NodeId > | onArcAdded |
| Signaler< NodeId, NodeId > | onArcDeleted |
| Signaler< NodeId > | onNodeAdded |
| Signaler< NodeId > | onNodeDeleted |
Protected Member Functions | |
| void | eraseSetOfArcs_ (const ArcSet &set) |
| a (virtualized) function to remove a given set of arcs | |
| void | unvirtualizedEraseSetOfArcs_ (const ArcSet &set) |
| similar to eraseSetOfArcs_ except that it is unvirtualized | |
Private Member Functions | |
| void | _checkParents_ (NodeId id) |
| when the ArcGraphPart contains no arc ingoing into a given node, this function adds an empty set entry to parents[id] | |
| void | _checkChildren_ (NodeId id) |
| when the ArcGraphPart contains no arc outgoing from a given node, this function adds an empty set entry to children[id] | |
Private Attributes | |
| Set< Arc > | _arcs_ |
| the set of all the arcs contained within the ArcGraphPart | |
| NodeProperty< NodeSet * > | _parents_ |
| for each arc, the sets of its parents | |
| NodeProperty< NodeSet * > | _children_ |
| for each arc, the set of its children | |
Base class for dag.
This is the base class for Directed Acyclic Graph : addArc may throw a DirectedCycle if any (directed) cycle is created by this arc.
|
inherited |
Definition at line 100 of file arcGraphPart.h.
|
inherited |
types for STL compliance
Definition at line 268 of file nodeGraphPart.h.
|
inherited |
types for STL compliance
Definition at line 270 of file nodeGraphPart.h.
|
inherited |
types for STL compliance
Definition at line 267 of file nodeGraphPart.h.
|
inherited |
types for STL compliance
Definition at line 269 of file nodeGraphPart.h.
|
inherited |
Definition at line 277 of file nodeGraphPart.h.
|
inherited |
Definition at line 279 of file nodeGraphPart.h.
|
inherited |
Definition at line 276 of file nodeGraphPart.h.
|
inherited |
Definition at line 278 of file nodeGraphPart.h.
|
explicit |
default constructor
| nodes_size | the size of the hash table used to store all the nodes |
| nodes_resize_policy | the resizing policy of this hash table |
| arcs_size | the size of the hash table used to store all the arcs |
| arcs_resize_policy | the resizing policy of this hash table |
Definition at line 60 of file DAG.cpp.
References DAG(), and gum::DiGraph::DiGraph().
Referenced by DAG(), DAG(), DAG(), ~DAG(), operator=(), and operator=().
| gum::DAG::DAG | ( | const DAG & | g | ) |
copy constructor
| g | the DAG to copy |
Definition at line 67 of file DAG.cpp.
References DAG(), and gum::DiGraph::DiGraph().
| gum::DAG::DAG | ( | DAG && | g | ) |
move constructor
Definition at line 70 of file DAG.cpp.
References DAG(), and gum::DiGraph::DiGraph().
|
override |
|
privateinherited |
when the ArcGraphPart contains no arc outgoing from a given node, this function adds an empty set entry to children[id]
| id | the node whose children[id] is checked |
Definition at line 72 of file arcGraphPart_inl.h.
References _children_.
Referenced by addArc().
|
privateinherited |
when the ArcGraphPart contains no arc ingoing into a given node, this function adds an empty set entry to parents[id]
| id | the node whose parents[id] is checked |
Definition at line 68 of file arcGraphPart_inl.h.
References _parents_.
Referenced by addArc().
insert a new arc into the directed graph
| tail | the id of the tail of the new inserted arc |
| head | the id of the head of the new inserted arc |
| InvalidNode | if head or tail does not belong to the graph nodes |
| InvalidDirectedCycle | if any (directed) cycle is created by this arc. |
Reimplemented from gum::ArcGraphPart.
Definition at line 75 of file DAG_inl.h.
References gum::DiGraph::addArc(), GUM_ERROR, and gum::DiGraph::hasDirectedPath().
Referenced by gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::LayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::BarrenNodesFinder::barrenNodes(), gum::BayesNet< double >::changeVariableName(), gum::InfluenceDiagram< GUM_SCALAR >::getDecisionGraph(), gum::learning::IBNLearner::learnDag_(), gum::learning::SimpleMiic::learnStructure(), gum::graph::markovBlanket(), gum::learning::IBNLearner::prepareFCI_(), gum::learning::IBNLearner::prepareMiic_(), gum::learning::IBNLearner::preparePC_(), and gum::MeekRules::propagateToDAG().
|
virtualinherited |
insert a new node and return its id
Reimplemented in gum::CliqueGraph.
Definition at line 269 of file nodeGraphPart_inl.h.
References _boundVal_, _eraseHole_(), _holes_, _updateEndIteratorSafe_(), GUM_EMIT1, and onNodeAdded.
Referenced by gum::prm::gspan::DFSTree< GUM_SCALAR >::_addChild_(), gum::prm::StructuredInference< GUM_SCALAR >::_addEdgesInReducedGraph_(), gum::prm::gspan::StrictSearch< GUM_SCALAR >::_buildPatternGraph_(), gum::prm::StructuredInference< GUM_SCALAR >::_buildPatternGraph_(), gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::LayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::gspan::DFSTree< GUM_SCALAR >::addRoot(), and populateNodesFromProperty().
insert n nodes
| n | the number of nodes to add |
Definition at line 287 of file nodeGraphPart_inl.h.
Referenced by gum::DiGraph::completeGraph(), gum::UndiGraph::completeGraph(), and populateNodesFromProperty().
|
virtualinherited |
try to insert a node with the given id
| DuplicateElement | exception if the id already exists |
Reimplemented in gum::CliqueGraph.
Definition at line 214 of file nodeGraphPart.cpp.
References _boundVal_, _eraseHole_(), _holes_, _holes_resize_policy_, _holes_size_, _inHoles_(), _updateEndIteratorSafe_(), GUM_EMIT1, GUM_ERROR, and onNodeAdded.
Referenced by gum::EssentialGraph::_buildEssentialGraph_(), gum::prm::GSpan< GUM_SCALAR >::_sortPatterns_(), gum::prm::gspan::Pattern::addNodeWithLabel(), gum::InfluenceDiagram< GUM_SCALAR >::getDecisionGraph(), gum::Separation::isForwardSeparated(), gum::learning::IBNLearner::learnDag_(), gum::learning::FCI::learnPAG(), gum::learning::SimpleMiic::learnStructure(), gum::graph::markovBlanket(), gum::graph::moralGraph(), gum::graph::moralizedAncestralGraph(), gum::UndiGraph::partialUndiGraph(), populateNodesFromProperty(), gum::learning::IBNLearner::prepareFCI_(), gum::learning::IBNLearner::prepareMiic_(), gum::learning::IBNLearner::preparePC_(), gum::MeekRules::propagateToCPDAG(), gum::MeekRules::propagateToDAG(), gum::learning::StructuralConstraintDAG::setGraphAlone(), gum::EssentialGraph::skeleton(), and gum::PAG::toMixedGraph().
returns the set of all ancestors of id (nodes from which id is reachable)
Definition at line 119 of file diGraph_inl.h.
References gum::graph::ancestors().
Referenced by gum::Separation::isAncestorOf(), and gum::DoorCriteria::nodesOnDirectedPaths().
|
inherited |
returns the set of arcs stored within the ArcGraphPart
Definition at line 60 of file arcGraphPart_inl.h.
References _arcs_.
Referenced by gum::EssentialGraph::_buildEssentialGraph_(), gum::prm::PRMClass< GUM_SCALAR >::_inheritClass_(), gum::prm::ClassBayesNet< GUM_SCALAR >::_init_(), gum::prm::gspan::Pattern::arcs(), gum::learning::FCI::learnPAG(), gum::learning::SimpleMiic::learnStructure(), and gum::DiGraph::toDot().
|
inherited |
a method to create a hashMap of VAL from a set of arcs (using for every arc, say x, the VAL a)
| a | the default value assigned to each arc in the returned Property |
| size | an optional parameter enabling to fine-tune the returned Property. Roughly speaking, it is a good practice to have a size equal to half the number of arcs. If you do not specify this parameter, the method will assign it for you. |
|
inherited |
a method to create a hashMap of VAL from a set of arcs (using for every arc, say x, the VAL f(x))
| f | a function assigning a VAL to any arc |
| size | an optional parameter enabling to fine-tune the returned Property. Roughly speaking, it is a good practice to have a size equal to half the number of arcs. If you do not specify this parameter, the method will assign it for you. |
|
inherited |
returns a copy of the set of nodes represented by the NodeGraphPart
Definition at line 367 of file nodeGraphPart_inl.h.
References _boundVal_, _inHoles_(), empty(), gum::Set< Key >::insert(), and sizeNodes().
Referenced by gum::MarginalTargetedInference< GUM_SCALAR >::MarginalTargetedInference(), gum::MarginalTargetedMRFInference< GUM_SCALAR >::MarginalTargetedMRFInference(), gum::DoCalculus< GUM_SCALAR >::_ancestorsIn_(), populateNodesFromProperty(), and gum::ImportanceSampling< GUM_SCALAR >::unsharpenBN_().
|
noexceptinherited |
a begin iterator to parse the set of nodes contained in the NodeGraphPart
Definition at line 346 of file nodeGraphPart_inl.h.
References NodeGraphPartIterator, and gum::NodeGraphPartIterator::validate_().
Referenced by gum::Estimator< GUM_SCALAR >::Estimator(), gum::learning::ConstraintBasedLearning::initGraph_(), populateNodesFromProperty(), and gum::Estimator< GUM_SCALAR >::setFromBN().
|
inherited |
a begin iterator to parse the set of nodes contained in the NodeGraphPart
Definition at line 334 of file nodeGraphPart_inl.h.
References NodeGraphPartIteratorSafe, and gum::NodeGraphPartIterator::validate_().
Referenced by populateNodesFromProperty().
|
inherited |
returns a number n such that all node ids are strictly lower than n
Definition at line 323 of file nodeGraphPart_inl.h.
References _boundVal_.
Referenced by _clearNodes_(), and populateNodesFromProperty().
returns the set of nodes which consists in the node and its parents returns the set of children of a set of nodes
returns the set of children of a set of nodes
Definition at line 82 of file arcGraphPart_inl.h.
References children().
Referenced by ArcGraphPart(), gum::prm::ClassDependencyGraph< GUM_SCALAR >::_addArcs_(), gum::EssentialGraph::_buildEssentialGraph_(), gum::DoorCriteria::_existsUnblockedDirectedPath_(), gum::prm::gspan::Pattern::_expandCodeIsMinimal_(), gum::prm::SVE< GUM_SCALAR >::_initElimOrder_(), gum::prm::SVED< GUM_SCALAR >::_initElimOrder_(), gum::prm::gspan::Pattern::_not_rec_(), gum::MeekRules::_propagatesOrientationInChainOfRemainingEdges_(), gum::prm::gspan::Pattern::_rec_(), gum::DoCalculus< GUM_SCALAR >::_removeInIntoDoing_outOfKnowing_(), gum::BarrenNodesFinder::barrenNodes(), children(), gum::DoorCriteria::enumerateFrontdoorSets(), eraseChildren(), gum::PDAG::hasMixedReallyOrientedPath(), gum::credal::CNLoopyPropagation< GUM_SCALAR >::initialize_(), gum::Separation::isBackdoorSeparated(), gum::Separation::isForwardSeparated(), gum::prm::gspan::Pattern::isMinimal(), gum::credal::CNLoopyPropagation< GUM_SCALAR >::makeInferenceNodeToNeighbours_(), operator<<(), gum::learning::SimpleMiic::propagatesOrientationInChainOfRemainingEdges_(), gum::rec_hasMixedReallyOrientedPath(), gum::BayesBall::relevantTensors(), gum::dSeparationAlgorithm::relevantTensors(), gum::prm::gspan::Pattern::remove(), gum::dSeparationAlgorithm::requisiteNodes(), gum::DAGCycleDetector::setDAG(), gum::MixedGraph::toDot(), gum::PDAG::toDot(), and unvirtualizedEraseChildren().
returns the set of nodes with arc outgoing from a given node
Note that the set of arcs returned may be empty if no arc within the ArcGraphPart is outgoing from the given node.
| id | the node which is the tail of the arcs returned |
Definition at line 97 of file arcGraphPart_inl.h.
References _children_, and gum::emptyNodeSet.
|
overridevirtualinherited |
removes all the nodes and arcs from the graph
Reimplemented from gum::NodeGraphPart.
Reimplemented in gum::MixedGraph.
Definition at line 67 of file diGraph_inl.h.
References gum::ArcGraphPart::clearArcs(), and gum::NodeGraphPart::clearNodes().
Referenced by operator=().
|
inherited |
removes all the arcs from the ArcGraphPart
Definition at line 104 of file arcGraphPart.cpp.
References _arcs_, _children_, _parents_, GUM_EMIT2, and onArcDeleted.
Referenced by ~ArcGraphPart(), gum::DiGraph::clear(), gum::MixedGraph::clear(), operator=(), operator=(), and gum::MixedGraph::operator=().
|
virtualinherited |
remove all the nodes from the NodeGraphPart
Definition at line 325 of file nodeGraphPart_inl.h.
References _clearNodes_().
Referenced by gum::DiGraph::clear(), gum::MixedGraph::clear(), gum::UndiGraph::clear(), gum::MixedGraph::operator=(), operator=(), and populateNodesFromProperty().
|
staticinherited |
Build a complete DiGraph with n nodes.
| int | n |
Definition at line 58 of file diGraph.cpp.
References DiGraph(), addArc(), and gum::NodeGraphPart::addNodes().
|
inherited |
returns a property {node:id of weakly connected component}
Definition at line 127 of file diGraph_inl.h.
References gum::graph::connectedComponents().
returns the set of all descendants of id (nodes reachable from id)
Definition at line 121 of file diGraph_inl.h.
References gum::graph::descendants().
Referenced by gum::DoorCriteria::enumerateBackdoorSets(), gum::Separation::isDescendantOf(), gum::DoorCriteria::nodesOnDirectedPaths(), and gum::DoorCriteria::satisfiesBackdoorCriterion().
|
inherited |
returns a directed path from node1 to node2, or std::nullopt if none
Definition at line 109 of file diGraph_inl.h.
References gum::graph::directedPath().
|
inherited |
returns a shortest path from node1 to node2 ignoring arc orientation, or std::nullopt if none
Definition at line 115 of file diGraph_inl.h.
References gum::graph::directedUnorientedPath().
|
inherited |
returns " [label=\"...\"]" with DOT-escaped name, or "" if no name
Definition at line 188 of file nodeGraphPart.cpp.
References _names_, and hasName().
Referenced by populateNodesFromProperty(), gum::DiGraph::toDot(), gum::MixedGraph::toDot(), gum::PAG::toDot(), gum::PDAG::toDot(), and gum::UndiGraph::toDot().
check if nodes X and nodes Y are independent given Z (in the sense of d-separation)
Definition at line 84 of file DAG.cpp.
References gum::graph::dSeparated().
check if node X and node Y are independent given nodes Z (in the sense of d-separation)
Definition at line 80 of file DAG.cpp.
References gum::graph::dSeparated().
Referenced by gum::Separation::isBackdoorSeparated(), and gum::Separation::isDSeparated().
|
inherited |
alias for emptyNodes
Definition at line 321 of file nodeGraphPart_inl.h.
References emptyNodes().
Referenced by asNodeSet(), populateNodesFromProperty(), gum::prm::gspan::Pattern::remove(), and gum::PDAG::toDot().
|
inherited |
indicates wether the ArcGraphPart contains any arc
Definition at line 56 of file arcGraphPart_inl.h.
References _arcs_.
|
inherited |
indicates whether there exists nodes in the NodeGraphPart
Definition at line 319 of file nodeGraphPart_inl.h.
References sizeNodes().
Referenced by empty(), and populateNodesFromProperty().
|
noexceptinherited |
the end iterator to parse the set of nodes contained in the NodeGraphPart
Definition at line 352 of file nodeGraphPart_inl.h.
References _endIteratorSafe_, and NodeGraphPartIterator.
Referenced by gum::Estimator< GUM_SCALAR >::Estimator(), gum::learning::ConstraintBasedLearning::initGraph_(), populateNodesFromProperty(), and gum::Estimator< GUM_SCALAR >::setFromBN().
|
noexceptinherited |
the end iterator to parse the set of nodes contained in the NodeGraphPart
Definition at line 342 of file nodeGraphPart_inl.h.
References _endIteratorSafe_, and NodeGraphPartIteratorSafe.
Referenced by populateNodesFromProperty().
|
virtualinherited |
removes an arc from the ArcGraphPart
| arc | the arc to be removed |
Definition at line 114 of file arcGraphPart_inl.h.
References _arcs_, _children_, _parents_, existsArc(), GUM_EMIT2, gum::Arc::head(), onArcDeleted, and gum::Arc::tail().
Referenced by gum::EssentialGraph::_buildEssentialGraph_(), gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::LayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::MeekRules::_orientDoubleHeadedArcs_(), gum::DoCalculus< GUM_SCALAR >::_removeIncomingInto_(), gum::DoCalculus< GUM_SCALAR >::_removeInIntoDoing_outOfKnowing_(), gum::BarrenNodesFinder::barrenNodes(), gum::BayesNet< double >::changeVariableName(), eraseChildren(), eraseParents(), eraseSetOfArcs_(), gum::Separation::isBackdoorSeparated(), gum::learning::IBNLearner::learnDag_(), gum::learning::SimpleMiic::learnStructure(), gum::learning::ConstraintBasedLearning::orientDoubleHeadedArcs_(), gum::prm::gspan::Pattern::pop_back(), unvirtualizedEraseChildren(), unvirtualizedEraseParents(), and unvirtualizedEraseSetOfArcs_().
|
inherited |
removes all the children of a given node
| id | the node all the children of which will be removed |
Definition at line 146 of file arcGraphPart_inl.h.
References _children_, children(), and eraseArc().
|
overridevirtualinherited |
remove a node and its adjacent arcs from the graph
| id | the id of the node to be removed |
Reimplemented from gum::NodeGraphPart.
Reimplemented in gum::MixedGraph.
Definition at line 93 of file diGraph_inl.h.
References gum::NodeGraphPart::eraseNode(), gum::ArcGraphPart::unvirtualizedEraseChildren(), and gum::ArcGraphPart::unvirtualizedEraseParents().
Referenced by gum::BarrenNodesFinder::barrenNodes(), gum::prm::gspan::Pattern::pop_back(), gum::Separation::reduceForDSeparation(), and gum::prm::gspan::Pattern::remove().
|
inherited |
erase all the parents of a given node
| id | the node all the parents of which will be removed |
Definition at line 132 of file arcGraphPart_inl.h.
References _parents_, eraseArc(), and parents().
|
protectedinherited |
a (virtualized) function to remove a given set of arcs
Definition at line 127 of file arcGraphPart_inl.h.
References eraseArc().
alias for existsNode
Definition at line 307 of file nodeGraphPart_inl.h.
References existsNode().
Referenced by gum::prm::StructuredInference< GUM_SCALAR >::_removeNode_(), gum::DiGraph::addArc(), gum::prm::gspan::Pattern::addArc(), gum::UndiGraph::addEdge(), gum::prm::gspan::Pattern::exists(), gum::learning::IBNLearner::learnDag_(), and populateNodesFromProperty().
indicates whether a given arc exists
| arc | the arc we test whether or not it belongs to the ArcGraphPart |
Definition at line 62 of file arcGraphPart_inl.h.
References _arcs_.
Referenced by gum::DoorCriteria::_existsUnblockedDirectedPath_(), gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::LayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::gspan::Pattern::_not_rec_(), gum::MeekRules::_propagatesOrientationInChainOfRemainingEdges_(), gum::prm::gspan::Pattern::_rec_(), gum::EssentialGraph::_strongly_protected_(), gum::DoorCriteria::enumerateBackdoorSets(), eraseArc(), gum::prm::gspan::Pattern::exists(), gum::Separation::isBackdoorSeparated(), and gum::graph::markovBlanket().
indicates whether a given arc exists
| tail | the tail of the arc we test the existence in the ArcGraphPart |
| head | the head of the arc we test the existence in the ArcGraphPart |
Definition at line 64 of file arcGraphPart_inl.h.
References _parents_.
returns true iff the NodeGraphPart contains the given nodeId
Definition at line 301 of file nodeGraphPart_inl.h.
References _boundVal_, and _inHoles_().
Referenced by eraseNode(), gum::PAG::eraseNode(), exists(), gum::InfluenceDiagram< GUM_SCALAR >::getDecisionGraph(), gum::Separation::isForwardSeparated(), gum::graph::markovBlanket(), gum::graph::moralizedAncestralGraph(), gum::UndiGraph::partialUndiGraph(), populateNodesFromProperty(), gum::Separation::reduceForDSeparation(), and setName().
returns the union of families of all nodes in ids
Definition at line 125 of file diGraph_inl.h.
References gum::graph::family().
returns { id } ∪ parents(id)
Definition at line 123 of file diGraph_inl.h.
References gum::graph::family().
checks whether there exists a directed path from from to to
If from==to, this function checks if a directed cycle containing from exists.
| from | |
| to |
Definition at line 114 of file diGraph.cpp.
References gum::graph::hasDirectedPath().
Referenced by gum::DAG::addArc(), and gum::PDAG::addArc().
returns true iff node id has an explicit name
Definition at line 186 of file nodeGraphPart.cpp.
References _names_.
Referenced by dotNodeLabel(), and populateNodesFromProperty().
|
inherited |
returns the id of the node with the given name, or std::nullopt
Definition at line 165 of file nodeGraphPart.cpp.
References _names_.
Referenced by populateNodesFromProperty().
|
inherited |
a method to create a list of VAL from a set of arcs (using for every arc, say x, the VAL f(x))
| f | a function assigning a VAL to any arc |
|
inherited |
a method to create a list of VAL from a set of nodes (using for every nodee, say x, the VAL f(x))
| f | a function assigning a VAL to any node |
References listMapNodes().
Referenced by listMapNodes().
Definition at line 92 of file DAG.cpp.
References gum::graph::minimalCondSet().
Definition at line 88 of file DAG.cpp.
References gum::graph::minimalCondSet().
Referenced by gum::ASTposteriorProba< GUM_SCALAR >::_compute_knw_from_dag().
| UndiGraph gum::DAG::moralGraph | ( | ) | const |
build a UndiGraph by moralizing the dag
Definition at line 74 of file DAG.cpp.
References gum::graph::moralGraph().
build a UndiGraph by moralizing the Ancestral Graph of a set of Nodes
| nodes | the set of nodeId |
Definition at line 76 of file DAG.cpp.
References gum::graph::moralizedAncestralGraph(), and gum::NodeGraphPart::nodes().
Referenced by gum::Separation::isForwardSeparated().
|
inherited |
returns the name of node id, or "<id>" if no name is set
Definition at line 160 of file nodeGraphPart.cpp.
References _names_.
Referenced by populateNodesFromProperty().
|
inherited |
returns a new node id, not yet used by any node
Definition at line 243 of file nodeGraphPart_inl.h.
References _boundVal_, and _holes_.
Referenced by populateNodesFromProperty().
|
inherited |
return *this as a NodeGraphPart
Definition at line 379 of file nodeGraphPart_inl.h.
References NodeGraphPart().
Referenced by gum::DoCalculus< GUM_SCALAR >::_ancestorsIn_(), gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::LayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::ClassBayesNet< GUM_SCALAR >::_init_(), gum::prm::SVE< GUM_SCALAR >::_initElimOrder_(), gum::prm::SVED< GUM_SCALAR >::_initElimOrder_(), gum::prm::SVE< GUM_SCALAR >::_initLiftedNodes_(), gum::MeekRules::_orientDoubleHeadedArcs_(), gum::prm::GSpan< GUM_SCALAR >::_sortPatterns_(), gum::prm::PRMFactory< GUM_SCALAR >::addAttribute(), gum::DoorCriteria::enumerateBackdoorSets(), gum::learning::ConstraintBasedLearning::initGraph_(), gum::learning::FCI::learnPAG(), gum::DAG::moralizedAncestralGraph(), gum::graph::moralizedAncestralGraph(), gum::PDAG::moralizedAncestralGraph(), gum::prm::gspan::Pattern::nodes(), operator<<(), gum::learning::ConstraintBasedLearning::orientDoubleHeadedArcs_(), gum::UndiGraph::partialUndiGraph(), populateNodesFromProperty(), gum::learning::IBNLearner::prepareFCI_(), gum::learning::IBNLearner::prepareMiic_(), gum::learning::IBNLearner::preparePC_(), gum::learning::FCI::ruleR10_(), gum::learning::FCI::ruleR1_(), gum::learning::FCI::ruleR2_(), gum::learning::FCI::ruleR3_(), gum::learning::FCI::ruleR4_(), gum::learning::FCI::ruleR5_(), gum::learning::FCI::ruleR6_(), gum::learning::FCI::ruleR7_(), gum::learning::FCI::ruleR8_(), gum::learning::FCI::ruleR9_(), gum::DiGraph::toDot(), gum::MixedGraph::toDot(), gum::PAG::toDot(), gum::PDAG::toDot(), gum::UndiGraph::toDot(), and gum::PAG::toMixedGraph().
|
inherited |
a method to create a HashTable with key:NodeId and value:VAL
VAL are computed from the nodes using for all node x, VAL f(x). This method is a wrapper of the same method in HashTable.
| f | a function assigning a VAL to any node |
| size | an optional parameter enabling to fine-tune the returned Property. Roughly speaking, it is a good practice to have a size equal to half the number of nodes. If you do not specify this parameter, the method will assign it for you. |
References nodesPropertyFromFunction(), and size().
Referenced by nodesPropertyFromFunction().
|
inherited |
a method to create a hashMap with key:NodeId and value:VAL
for all nodes, the value stored is a. This method is a wrapper of the same method in HashTable.
| a | the default value assigned to each edge in the returned Property |
| size | an optional parameter enabling to fine-tune the returned Property. Roughly speaking, it is a good practice to have a size equal to half the number of nodes. If you do not specify this parameter, the method will assign it for you. |
References nodesPropertyFromVal(), and size().
Referenced by gum::BinaryJoinTreeConverterDefault::convert(), and nodesPropertyFromVal().
copy operator
| g | the DAG to copy |
Definition at line 57 of file DAG_inl.h.
References DAG(), and gum::DiGraph::operator=().
move assignment operator
Definition at line 67 of file DAG_inl.h.
References DAG(), and gum::DiGraph::operator=().
|
inherited |
tests whether two ArcGraphParts contain the same arcs
| p | the ArcGraphPart that we compare with this |
Definition at line 189 of file arcGraphPart_inl.h.
References ArcGraphPart(), and _arcs_.
Referenced by gum::DiGraph::operator==(), and gum::MixedGraph::operator==().
tests whether two DiGraphs are identical (same nodes, same arcs)
| g | the DiGraph with which "this" is compared |
Definition at line 103 of file diGraph_inl.h.
References DiGraph(), gum::ArcGraphPart::operator==(), and gum::NodeGraphPart::operator==().
|
inherited |
check whether two NodeGraphParts contain the same nodes
| p | the NodeGraphPart to be compared with "this" |
Definition at line 356 of file nodeGraphPart_inl.h.
References NodeGraphPart(), _boundVal_, and _holes_.
Referenced by gum::DiGraph::operator==(), gum::MixedGraph::operator==(), and gum::UndiGraph::operator==().
returns the set of parents of a set of nodes
Definition at line 90 of file arcGraphPart_inl.h.
References parents().
returns the set of nodes with arc ingoing to a given node
Note that the set of arcs returned may be empty if no arc within the ArcGraphPart is ingoing into the given node.
| id | the node toward which the arcs returned are pointing |
Definition at line 76 of file arcGraphPart_inl.h.
References _parents_, and gum::emptyNodeSet.
Referenced by gum::DoCalculus< GUM_SCALAR >::_ancestorsIn_(), gum::prm::gspan::Pattern::_expandCodeIsMinimal_(), gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateClass_(), gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::LayerGenerator< GUM_SCALAR >::_generateClassDag_(), gum::prm::LayerGenerator< GUM_SCALAR >::_generateClasses_(), gum::prm::ClusteredLayerGenerator< GUM_SCALAR >::_generateCluster_(), gum::prm::SVE< GUM_SCALAR >::_initElimOrder_(), gum::prm::SVED< GUM_SCALAR >::_initElimOrder_(), gum::prm::SVE< GUM_SCALAR >::_initLiftedNodes_(), gum::prm::SVED< GUM_SCALAR >::_initLiftedNodes_(), gum::prm::gspan::Pattern::_not_rec_(), gum::MeekRules::_orientDoubleHeadedArcs_(), gum::prm::gspan::Pattern::_rec_(), gum::DoCalculus< GUM_SCALAR >::_removeIncomingInto_(), gum::DoCalculus< GUM_SCALAR >::_removeInIntoDoing_outOfKnowing_(), gum::EssentialGraph::_strongly_protected_(), gum::DoorCriteria::backdoorReach(), gum::BarrenNodesFinder::barrenNodes(), gum::DoorCriteria::enumerateBackdoorSets(), gum::DoorCriteria::enumerateFrontdoorSets(), eraseParents(), gum::credal::CNLoopyPropagation< GUM_SCALAR >::initialize_(), gum::prm::gspan::Pattern::isMinimal(), gum::learning::SimpleMiic::learnPDAG(), gum::learning::SimpleMiic::learnStructure(), gum::credal::CNLoopyPropagation< GUM_SCALAR >::makeInferenceNodeToNeighbours_(), operator<<(), gum::learning::ConstraintBasedLearning::orientDoubleHeadedArcs_(), gum::prm::gspan::DFSTree< GUM_SCALAR >::parent(), gum::prm::gspan::DFSTree< GUM_SCALAR >::parent(), parents(), gum::BayesBall::relevantTensors(), gum::dSeparationAlgorithm::relevantTensors(), gum::prm::gspan::Pattern::remove(), gum::dSeparationAlgorithm::requisiteNodes(), gum::prm::gspan::Pattern::rightmostPath(), gum::DAGCycleDetector::setDAG(), and unvirtualizedEraseParents().
|
inherited |
populateNodes clears *this and fills it with the same nodes as "s"
populateNodes should basically be the preferred way to insert nodes with IDs not selected by the internal idFactory.
| s | the NodeGraphPart to be copied |
Definition at line 97 of file nodeGraphPart.cpp.
References NodeGraphPart(), _boundVal_, _cloneNames_(), _holes_, _holes_resize_policy_, _holes_size_, _names_, _updateEndIteratorSafe_(), and clear().
Referenced by operator=().
|
inherited |
populateNodesFromProperty clears *this and fills it with the keys of "h"
populateNodes should basically be the preferred way to insert nodes with IDs not selected by the internal idFactory.
References NodeGraphPart(), addNode(), addNodes(), addNodeWithId(), asNodeSet(), begin(), beginSafe(), bound(), clear(), clearNodes(), dotNodeLabel(), empty(), emptyNodes(), end(), endSafe(), eraseNode(), exists(), existsNode(), hasName(), idFromName(), nameFromId(), nextNodeId(), nodes(), setName(), size(), sizeNodes(), and toString().
|
inherited |
sets the name of node id
| DuplicateElement | if name is already used by another node |
Definition at line 170 of file nodeGraphPart.cpp.
References _names_, existsNode(), and GUM_ERROR.
Referenced by gum::GraphicalModel::_nameNodes_(), gum::CausalModel< GUM_SCALAR >::causalDAG(), populateNodesFromProperty(), and gum::EssentialGraph::skeleton().
|
inherited |
alias for sizeNodes
Definition at line 299 of file nodeGraphPart_inl.h.
References sizeNodes().
Referenced by gum::StaticTriangulation::StaticTriangulation(), gum::prm::gspan::DFSTree< GUM_SCALAR >::_addChild_(), gum::StaticTriangulation::_triangulate_(), nodesPropertyFromFunction(), nodesPropertyFromVal(), populateNodesFromProperty(), gum::BayesBall::relevantTensors(), gum::dSeparationAlgorithm::relevantTensors(), gum::dSeparationAlgorithm::requisiteNodes(), gum::prm::gspan::Pattern::size(), and gum::UndiGraph::toDot().
|
inherited |
indicates the number of arcs stored within the ArcGraphPart
Definition at line 58 of file arcGraphPart_inl.h.
References _arcs_.
Referenced by gum::prm::gspan::Pattern::sizeArcs().
|
inherited |
returns the number of nodes in the NodeGraphPart
Definition at line 295 of file nodeGraphPart_inl.h.
References _boundVal_, and _holes_.
Referenced by gum::BinaryJoinTreeConverterDefault::_markConnectedComponent_(), asNodeSet(), gum::BinaryJoinTreeConverterDefault::convert(), emptyNodes(), populateNodesFromProperty(), and size().
|
virtualinherited |
to friendly display the content of the graph in the DOT syntax
| name | The graph name in the dot syntax. Default is G. |
Reimplemented in gum::MixedGraph, gum::PDAG, and gum::prm::gspan::Pattern.
Definition at line 93 of file diGraph.cpp.
References gum::ArcGraphPart::arcs(), gum::NodeGraphPart::dotNodeLabel(), and gum::NodeGraphPart::nodes().
Build and return a topological order.
| InvalidDirectedCycle | Raised if this DiGraph contains cycles. |
Definition at line 131 of file diGraph_inl.h.
References gum::graph::topologicalOrder().
Referenced by gum::learning::SimpleMiic::learnPDAG(), and gum::learning::SimpleMiic::learnStructure().
|
overridevirtualinherited |
to friendly display the content of the graph
Reimplemented from gum::NodeGraphPart.
Reimplemented in gum::MixedGraph.
Definition at line 86 of file diGraph.cpp.
References gum::ArcGraphPart::toString(), and gum::NodeGraphPart::toString().
Referenced by gum::operator<<().
|
inherited |
same function as eraseChildren but without any virtual call to an erase
| id | the node whose outgoing arcs will be removed |
Definition at line 177 of file arcGraphPart_inl.h.
References _children_, children(), and eraseArc().
Referenced by gum::DiGraph::eraseNode(), and gum::MixedGraph::eraseNode().
|
inherited |
same function as eraseParents but without any virtual call to an erase
| id | the node whose ingoing arcs will be removed |
Definition at line 165 of file arcGraphPart_inl.h.
References _parents_, eraseArc(), and parents().
Referenced by gum::DiGraph::eraseNode(), and gum::MixedGraph::eraseNode().
|
protectedinherited |
similar to eraseSetOfArcs_ except that it is unvirtualized
Definition at line 160 of file arcGraphPart_inl.h.
References eraseArc().
the set of all the arcs contained within the ArcGraphPart
Definition at line 281 of file arcGraphPart.h.
Referenced by ArcGraphPart(), ArcGraphPart(), ArcGraphPart(), addArc(), arcs(), clearArcs(), emptyArcs(), eraseArc(), existsArc(), operator=(), operator=(), operator==(), sizeArcs(), and toString().
|
privateinherited |
for each arc, the set of its children
Definition at line 287 of file arcGraphPart.h.
Referenced by ArcGraphPart(), ArcGraphPart(), _checkChildren_(), addArc(), children(), clearArcs(), eraseArc(), eraseChildren(), operator=(), operator=(), and unvirtualizedEraseChildren().
|
privateinherited |
for each arc, the sets of its parents
Definition at line 284 of file arcGraphPart.h.
Referenced by ArcGraphPart(), ArcGraphPart(), _checkParents_(), addArc(), clearArcs(), eraseArc(), eraseParents(), existsArc(), operator=(), operator=(), parents(), and unvirtualizedEraseParents().
Definition at line 102 of file arcGraphPart.h.
Referenced by ArcGraphPart(), addArc(), operator=(), and operator=().
Definition at line 103 of file arcGraphPart.h.
Referenced by clearArcs(), and eraseArc().
Definition at line 281 of file nodeGraphPart.h.
Referenced by addNode(), and addNodeWithId().
Definition at line 282 of file nodeGraphPart.h.
Referenced by _clearNodes_(), and eraseNode().