aGrUM  0.16.0
gum::UnconstrainedTriangulation Class Referenceabstract

Interface for all triangulation methods without constraints on node elimination orderings. More...

#include <unconstrainedTriangulation.h>

+ Inheritance diagram for gum::UnconstrainedTriangulation:
+ Collaboration diagram for gum::UnconstrainedTriangulation:

Public Member Functions

Accessors / Modifiers
virtual UnconstrainedTriangulationnewFactory () const =0
 returns a fresh triangulation (over an empty graph) of the same type as the current object More...
 
virtual UnconstrainedTriangulationcopyFactory () const =0
 virtual copy constructor More...
 
virtual ~UnconstrainedTriangulation ()
 destructor More...
 
Accessors / Modifiers
double maxLog10CliqueDomainSize ()
 returns the max of log10DomainSize of the cliques in the junction tree. More...
 
const NodeProperty< Size > * domainSizes () const
 returns the domain sizes of the variables of the graph to be triangulated More...
 

Protected Attributes

EliminationSequenceStrategy_elimination_sequence_strategy {nullptr}
 the elimination sequence strategy used by the triangulation More...
 
JunctionTreeStrategy_junction_tree_strategy {nullptr}
 the junction tree strategy used by the triangulation More...
 
const NodeProperty< Size > * _domain_sizes {nullptr}
 the domain sizes of the variables/nodes of the graph More...
 

Protected Member Functions

Constructors / Destructors
 UnconstrainedTriangulation (const UnconstrainedEliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
 default constructor More...
 
 UnconstrainedTriangulation (const UndiGraph *graph, const NodeProperty< Size > *dom, const UnconstrainedEliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
 constructor with a given graph More...
 
 UnconstrainedTriangulation (const UnconstrainedTriangulation &)
 forbid copy constructor except in newfactory More...
 
 UnconstrainedTriangulation (UnconstrainedTriangulation &&)
 forbid move constructor except in children's constructors More...
 

Accessors / Modifiers

virtual void setGraph (const UndiGraph *graph, const NodeProperty< Size > *domsizes)
 initialize the triangulation data structures for a new graph More...
 
const EdgeSetfillIns ()
 returns the fill-ins added by the triangulation algorithm More...
 
const std::vector< NodeId > & eliminationOrder ()
 returns an elimination ordering compatible with the triangulated graph More...
 
Idx eliminationOrder (const NodeId)
 returns the index of a given node in the elimination order (0 = first node eliminated) More...
 
const NodeProperty< NodeId > & reverseEliminationOrder ()
 returns a table indicating, for each node, at which step it was deleted by the triangulation process More...
 
const UndiGraphtriangulatedGraph ()
 returns the triangulated graph More...
 
const CliqueGrapheliminationTree ()
 returns the elimination tree of a compatible ordering More...
 
const CliqueGraphjunctionTree ()
 returns a compatible junction tree More...
 
NodeId createdJunctionTreeClique (const NodeId id)
 returns the Id of the clique of the junction tree created by the elimination of a given node during the triangulation process More...
 
const NodeProperty< NodeId > & createdJunctionTreeCliques ()
 returns the Ids of the cliques of the junction tree created by the elimination of the nodes More...
 
const CliqueGraphmaxPrimeSubgraphTree ()
 returns a junction tree of maximal prime subgraphs More...
 
NodeId createdMaxPrimeSubgraph (const NodeId id)
 returns the Id of the maximal prime subgraph created by the elimination of a given node during the triangulation process More...
 
void clear ()
 reinitialize the graph to be triangulated to an empty graph More...
 
void setMinimalRequirement (bool)
 sets/unset the minimality requirement More...
 
virtual bool isMinimalityRequired () const final
 indicates wether minimality is required More...
 
void setFillIns (bool)
 sets/unsets the record of the fill-ins in the standard triangulation procedure More...
 
const UndiGraphoriginalGraph () const
 returns the graph to be triangulated More...
 
EliminationSequenceStrategyeliminationSequenceStrategy () const
 returns the elimination sequence strategy used by the triangulation More...
 
JunctionTreeStrategyjunctionTreeStrategy () const
 returns the junction tree strategy used by the triangulation More...
 
virtual void _initTriangulation (UndiGraph &graph)
 the function called to initialize the triangulation process More...
 

Detailed Description

Interface for all triangulation methods without constraints on node elimination orderings.

Definition at line 45 of file unconstrainedTriangulation.h.

Constructor & Destructor Documentation

◆ ~UnconstrainedTriangulation()

gum::UnconstrainedTriangulation::~UnconstrainedTriangulation ( )
virtual

destructor

Definition at line 75 of file unconstrainedTriangulation.cpp.

75  {
76  // for debugging purposes
77  GUM_DESTRUCTOR(UnconstrainedTriangulation);
78  }
UnconstrainedTriangulation(const UnconstrainedEliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor

◆ UnconstrainedTriangulation() [1/4]

gum::UnconstrainedTriangulation::UnconstrainedTriangulation ( const UnconstrainedEliminationSequenceStrategy elimSeq,
const JunctionTreeStrategy JTStrategy,
bool  minimality = false 
)
protected

default constructor

Parameters
elimSeqthe elimination sequence used to triangulate the graph
JTStrategythe junction tree strategy used to create junction trees
minimalitya Boolean indicating whether we should enforce that the triangulation is minimal w.r.t. inclusion

Definition at line 37 of file unconstrainedTriangulation.cpp.

40  :
41  StaticTriangulation(elimSeq, JTStrategy, minimality) {
42  // for debugging purposes
43  GUM_CONSTRUCTOR(UnconstrainedTriangulation);
44  }
UnconstrainedTriangulation(const UnconstrainedEliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor
StaticTriangulation(const EliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor: without any graph

◆ UnconstrainedTriangulation() [2/4]

gum::UnconstrainedTriangulation::UnconstrainedTriangulation ( const UndiGraph graph,
const NodeProperty< Size > *  dom,
const UnconstrainedEliminationSequenceStrategy elimSeq,
const JunctionTreeStrategy JTStrategy,
bool  minimality = false 
)
protected

constructor with a given graph

Parameters
graphthe graph to be triangulated, i.e., the nodes of which will be eliminated
domthe domain sizes of the nodes to be eliminated
elimSeqthe elimination sequence used to triangulate the graph
JTStrategythe junction tree strategy used to create junction trees
minimalitya Boolean indicating whether we should enforce that the triangulation is minimal w.r.t. inclusion
Warning
note that, by aGrUM's rule, the graph and the modalities are not copied but only referenced by the elimination sequence algorithm.

Definition at line 47 of file unconstrainedTriangulation.cpp.

52  :
53  StaticTriangulation(theGraph, domsizes, elimSeq, JTStrategy, minimality) {
54  // for debugging purposes
55  GUM_CONSTRUCTOR(UnconstrainedTriangulation);
56  }
UnconstrainedTriangulation(const UnconstrainedEliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor
StaticTriangulation(const EliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor: without any graph

◆ UnconstrainedTriangulation() [3/4]

gum::UnconstrainedTriangulation::UnconstrainedTriangulation ( const UnconstrainedTriangulation from)
protected

forbid copy constructor except in newfactory

copy constructor

Definition at line 59 of file unconstrainedTriangulation.cpp.

60  :
61  StaticTriangulation(from) {
62  // for debugging purposes
63  GUM_CONS_CPY(UnconstrainedTriangulation);
64  }
UnconstrainedTriangulation(const UnconstrainedEliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor
StaticTriangulation(const EliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor: without any graph

◆ UnconstrainedTriangulation() [4/4]

gum::UnconstrainedTriangulation::UnconstrainedTriangulation ( UnconstrainedTriangulation &&  from)
protected

forbid move constructor except in children's constructors

move constructor

Definition at line 67 of file unconstrainedTriangulation.cpp.

68  :
69  StaticTriangulation(std::move(from)) {
70  // for debugging purposes
71  GUM_CONS_MOV(UnconstrainedTriangulation);
72  }
UnconstrainedTriangulation(const UnconstrainedEliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor
StaticTriangulation(const EliminationSequenceStrategy &elimSeq, const JunctionTreeStrategy &JTStrategy, bool minimality=false)
default constructor: without any graph

Member Function Documentation

◆ _initTriangulation()

void gum::StaticTriangulation::_initTriangulation ( UndiGraph graph)
protectedvirtualinherited

the function called to initialize the triangulation process

This function is called when the triangulation process starts and is used to initialize the elimination sequence strategy. Actually, the graph that is modified by the triangulation algorithm is a copy of the original graph, and this copy needs be known by the elimination sequence strategy. _initTriangulation is used to transmit this knowledge to the elimination sequence (through method setGraph of the elimination sequence class).

Parameters
graphthe very graph that is triangulated (this is a copy of __original_graph)

Reimplemented in gum::PartialOrderedTriangulation, and gum::OrderedTriangulation.

Definition at line 733 of file staticTriangulation.cpp.

References gum::Triangulation::_domain_sizes, gum::StaticTriangulation::_elimination_sequence_strategy, and gum::EliminationSequenceStrategy::setGraph().

Referenced by gum::StaticTriangulation::__triangulate().

733  {
735  }
EliminationSequenceStrategy * _elimination_sequence_strategy
the elimination sequence strategy used by the triangulation
const NodeProperty< Size > * _domain_sizes
the domain sizes of the variables/nodes of the graph
virtual bool setGraph(UndiGraph *graph, const NodeProperty< Size > *dom_sizes)
sets a new graph to be triangulated
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ clear()

void gum::StaticTriangulation::clear ( )
virtualinherited

reinitialize the graph to be triangulated to an empty graph

Implements gum::Triangulation.

Definition at line 165 of file staticTriangulation.cpp.

References gum::StaticTriangulation::__added_fill_ins, gum::StaticTriangulation::__elim_cliques, gum::StaticTriangulation::__elim_order, gum::StaticTriangulation::__elim_tree, gum::StaticTriangulation::__fill_ins, gum::StaticTriangulation::__has_elimination_tree, gum::StaticTriangulation::__has_fill_ins, gum::StaticTriangulation::__has_junction_tree, gum::StaticTriangulation::__has_max_prime_junction_tree, gum::StaticTriangulation::__has_triangulated_graph, gum::StaticTriangulation::__has_triangulation, gum::StaticTriangulation::__junction_tree, gum::StaticTriangulation::__max_prime_junction_tree, gum::StaticTriangulation::__node_2_max_prime_clique, gum::StaticTriangulation::__original_graph, gum::StaticTriangulation::__reverse_elim_order, gum::StaticTriangulation::__triangulated_graph, gum::StaticTriangulation::_elimination_sequence_strategy, gum::StaticTriangulation::_junction_tree_strategy, gum::JunctionTreeStrategy::clear(), gum::CliqueGraph::clear(), gum::EliminationSequenceStrategy::clear(), gum::UndiGraph::clear(), and gum::Set< Key, Alloc >::clear().

Referenced by gum::StaticTriangulation::setGraph().

165  {
166  // clear the factories
169 
170  // remove the current graphs
171  __original_graph = nullptr;
172  __junction_tree = nullptr;
174  __elim_tree.clear();
176  __elim_cliques.clear();
178 
179  // remove all fill-ins and orderings
180  __fill_ins.clear();
181  __added_fill_ins.clear();
182  __elim_order.clear();
183  __reverse_elim_order.clear();
184 
185  // indicates that the junction tree, the max prime tree, etc, are updated
186  __has_triangulation = true;
188  __has_elimination_tree = true;
189  __has_junction_tree = true;
191  __has_fill_ins = true;
192  }
virtual void clear()
clears the sequence (to prepare, for instance, a new elimination sequence)
virtual void clear()
removes all the nodes and edges from the graph
Definition: undiGraph_inl.h:43
NodeProperty< NodeId > __node_2_max_prime_clique
indicates which clique of the max prime junction tree was created by the elmination of a given node (...
bool __has_max_prime_junction_tree
indicates whether a maximal prime subgraph junction tree has been constructed
EliminationSequenceStrategy * _elimination_sequence_strategy
the elimination sequence strategy used by the triangulation
const UndiGraph * __original_graph
a pointer to the (external) original graph (which will be triangulated)
bool __has_triangulated_graph
a boolean indicating whether we have constructed the triangulated graph
virtual void clear()
removes all the cliques and separators from the graph (as well as their adjacent edges) ...
JunctionTreeStrategy * _junction_tree_strategy
the junction tree strategy used by the triangulation
UndiGraph __triangulated_graph
the triangulated graph
NodeProperty< NodeId > __reverse_elim_order
the elimination order (access by NodeId)
std::vector< EdgeSet > __added_fill_ins
a vector containing the set of fill-ins added after each node elimination (used by recursive thinning...
bool __has_triangulation
a boolean indicating whether we have parformed a triangulation
virtual void clear()=0
resets the current junction tree strategy data structures
bool __has_junction_tree
a boolean indicating whether the junction tree has been constructed
CliqueGraph __max_prime_junction_tree
the maximal prime subgraph junction tree computed from the junction tree
NodeProperty< NodeSet > __elim_cliques
the cliques formed by the elimination of the nodes
bool __has_fill_ins
indicates whether we actually computed fill-ins
const CliqueGraph * __junction_tree
the junction tree computed by the algorithm
bool __has_elimination_tree
a boolean indicating whether the elimination tree has been computed
void clear()
Removes all the elements, if any, from the set.
Definition: set_tpl.h:375
EdgeSet __fill_ins
the fill-ins added during the whole triangulation process
std::vector< NodeId > __elim_order
the order in which nodes are eliminated by the algorithm
CliqueGraph __elim_tree
the elimination tree computed by the algorithm
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ copyFactory()

virtual UnconstrainedTriangulation* gum::UnconstrainedTriangulation::copyFactory ( ) const
pure virtual

virtual copy constructor

note that we return a pointer as it enables subclasses to return pointers to their types, not Triangulation pointers. See item 25 of the more effective C++.

Implements gum::StaticTriangulation.

Implemented in gum::DefaultTriangulation.

◆ createdJunctionTreeClique()

NodeId gum::StaticTriangulation::createdJunctionTreeClique ( const NodeId  id)
virtualinherited

returns the Id of the clique of the junction tree created by the elimination of a given node during the triangulation process

Implements gum::Triangulation.

◆ createdJunctionTreeCliques()

const NodeProperty< NodeId >& gum::StaticTriangulation::createdJunctionTreeCliques ( )
virtualinherited

returns the Ids of the cliques of the junction tree created by the elimination of the nodes

Implements gum::Triangulation.

◆ createdMaxPrimeSubgraph()

NodeId gum::StaticTriangulation::createdMaxPrimeSubgraph ( const NodeId  id)
virtualinherited

returns the Id of the maximal prime subgraph created by the elimination of a given node during the triangulation process

Implements gum::Triangulation.

◆ domainSizes()

const NodeProperty< Size >* gum::Triangulation::domainSizes ( ) const
inherited

returns the domain sizes of the variables of the graph to be triangulated

◆ eliminationOrder() [1/2]

◆ eliminationOrder() [2/2]

Idx gum::StaticTriangulation::eliminationOrder ( const NodeId  )
virtualinherited

returns the index of a given node in the elimination order (0 = first node eliminated)

Implements gum::Triangulation.

◆ eliminationSequenceStrategy()

EliminationSequenceStrategy& gum::StaticTriangulation::eliminationSequenceStrategy ( ) const
inherited

returns the elimination sequence strategy used by the triangulation

◆ eliminationTree()

const CliqueGraph& gum::StaticTriangulation::eliminationTree ( )
virtualinherited

returns the elimination tree of a compatible ordering

Implements gum::Triangulation.

Referenced by gum::DefaultJunctionTreeStrategy::__computeJunctionTree().

+ Here is the caller graph for this function:

◆ fillIns()

const EdgeSet & gum::StaticTriangulation::fillIns ( )
virtualinherited

returns the fill-ins added by the triangulation algorithm

Implements gum::Triangulation.

Definition at line 679 of file staticTriangulation.cpp.

References gum::StaticTriangulation::__fill_ins, gum::StaticTriangulation::__has_fill_ins, gum::StaticTriangulation::__has_junction_tree, gum::StaticTriangulation::__has_triangulation, gum::StaticTriangulation::__junction_tree, gum::StaticTriangulation::__original_graph, gum::StaticTriangulation::__triangulate(), gum::StaticTriangulation::__we_want_fill_ins, gum::StaticTriangulation::_elimination_sequence_strategy, gum::CliqueGraph::clique(), gum::EdgeGraphPart::existsEdge(), gum::EliminationSequenceStrategy::fillIns(), gum::Set< Key, Alloc >::insert(), gum::StaticTriangulation::junctionTree(), gum::NodeGraphPart::nodes(), gum::EliminationSequenceStrategy::providesFillIns(), and gum::Set< Key, Alloc >::size().

679  {
680  // if we did not compute the triangulation yet, do it and commpute
681  // the fill-ins at the same time
682  if (!__has_triangulation) {
683  bool want_fill_ins = __we_want_fill_ins;
684  __we_want_fill_ins = true;
685  __triangulate();
686  __we_want_fill_ins = want_fill_ins;
687  __has_fill_ins = true;
688  }
689 
690  // here, we already computed a triangulation and we already computed
691  // the fill-ins, so return them
692  if (__has_fill_ins) {
695  else
696  return __fill_ins;
697  } else {
698  // ok, here, we shall compute the fill-ins as they were not precomputed
699  if (!__original_graph) return __fill_ins;
700 
701  // just in case, be sure that the junction tree has been constructed
703 
704  for (const auto clik_id : __junction_tree->nodes()) {
705  // for each clique, add the edges necessary to make it complete
706  const NodeSet& clique = __junction_tree->clique(clik_id);
707  std::vector< NodeId > clique_nodes(clique.size());
708  unsigned int i = 0;
709 
710  for (const auto node : clique) {
711  clique_nodes[i] = node;
712  i += 1;
713  }
714 
715  for (i = 0; i < clique_nodes.size(); ++i) {
716  for (unsigned int j = i + 1; j < clique_nodes.size(); ++j) {
717  Edge edge(clique_nodes[i], clique_nodes[j]);
718 
719  if (!__original_graph->existsEdge(edge)) {
720  try {
721  __fill_ins.insert(edge);
722  } catch (DuplicateElement&) {}
723  }
724  }
725  }
726  }
727 
728  return __fill_ins;
729  }
730  }
const CliqueGraph & junctionTree()
returns a compatible junction tree
virtual const EdgeSet & fillIns()
in case fill-ins are provided, this function returns the fill-ins due to all the nodes eliminated so ...
void __triangulate()
the function that performs the triangulation
Set< NodeId > NodeSet
Some typdefs and define for shortcuts ...
EliminationSequenceStrategy * _elimination_sequence_strategy
the elimination sequence strategy used by the triangulation
const UndiGraph * __original_graph
a pointer to the (external) original graph (which will be triangulated)
bool __has_triangulation
a boolean indicating whether we have parformed a triangulation
bool __has_junction_tree
a boolean indicating whether the junction tree has been constructed
bool existsEdge(const Edge &edge) const
indicates whether a given edge exists
const NodeGraphPart & nodes() const
return *this as a NodeGraphPart
const NodeSet & clique(const NodeId idClique) const
returns the set of nodes included into a given clique
bool __we_want_fill_ins
a boolean indicating if we want fill-ins list with the standard triangulation method ...
bool __has_fill_ins
indicates whether we actually computed fill-ins
const CliqueGraph * __junction_tree
the junction tree computed by the algorithm
EdgeSet __fill_ins
the fill-ins added during the whole triangulation process
void insert(const Key &k)
Inserts a new element into the set.
Definition: set_tpl.h:613
virtual bool providesFillIns() const =0
indicates whether the fill-ins generated by the eliminated nodes, if needed, will be computed by the ...
+ Here is the call graph for this function:

◆ isMinimalityRequired()

virtual bool gum::StaticTriangulation::isMinimalityRequired ( ) const
finalvirtualinherited

indicates wether minimality is required

◆ junctionTree()

const CliqueGraph& gum::StaticTriangulation::junctionTree ( )
virtualinherited

returns a compatible junction tree

Implements gum::Triangulation.

Referenced by gum::StaticTriangulation::__computeMaxPrimeJunctionTree(), gum::StaticTriangulation::fillIns(), and gum::StaticTriangulation::triangulatedGraph().

+ Here is the caller graph for this function:

◆ junctionTreeStrategy()

JunctionTreeStrategy& gum::StaticTriangulation::junctionTreeStrategy ( ) const
inherited

returns the junction tree strategy used by the triangulation

◆ maxLog10CliqueDomainSize()

double gum::Triangulation::maxLog10CliqueDomainSize ( )
inherited

returns the max of log10DomainSize of the cliques in the junction tree.

This is usefull for instance to estimate the complexity (both in space and in time) of the inference that will use the junction tree.

This method is not 'const' since it can be called before building any junction tree and hence it needs to build it...

Definition at line 70 of file triangulation.cpp.

References gum::Triangulation::_domain_sizes, and gum::Triangulation::junctionTree().

Referenced by gum::MaxInducedWidthMCBayesNetGenerator< GUM_SCALAR, ICPTGenerator, ICPTDisturber >::__checkConditions().

70  {
71  double res = 0.0;
72  double dSize;
73  const JunctionTree& jt = junctionTree(); // here, the fact that we get
74  // a junction tree ensures that _domain_sizes is different from nullptr
75 
76  for (const NodeId cl : jt) {
77  dSize = 0.0;
78 
79  for (const auto node : jt.clique(cl))
80  dSize += std::log10((*_domain_sizes)[node]);
81 
82  if (res < dSize) res = dSize;
83  }
84 
85  return res;
86  }
const NodeProperty< Size > * _domain_sizes
the domain sizes of the variables/nodes of the graph
CliqueGraph JunctionTree
a junction tree is a clique graph satisfying the running intersection property and such that no cliqu...
Definition: cliqueGraph.h:302
virtual const CliqueGraph & junctionTree()=0
returns a compatible junction tree
Size NodeId
Type for node ids.
Definition: graphElements.h:98
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ maxPrimeSubgraphTree()

const CliqueGraph& gum::StaticTriangulation::maxPrimeSubgraphTree ( )
virtualinherited

returns a junction tree of maximal prime subgraphs

Warning
Actually, the cliques of the junction tree are guarranteed to be maximal prime subgraph of the original graph that was triangulated only if the triangulation performed is minimal (in the sense that removing any edge in the triangulated graph results in a nontriangulated graph). This can be ensured by requiring minimality of the triangulation.

Implements gum::Triangulation.

◆ newFactory()

virtual UnconstrainedTriangulation* gum::UnconstrainedTriangulation::newFactory ( ) const
pure virtual

returns a fresh triangulation (over an empty graph) of the same type as the current object

note that we return a pointer as it enables subclasses to return pointers to their types, not Triangulation pointers. See item 25 of the more effective C++.

Implements gum::StaticTriangulation.

Implemented in gum::DefaultTriangulation.

◆ operator=()

UnconstrainedTriangulation& gum::UnconstrainedTriangulation::operator= ( const UnconstrainedTriangulation )
private

forbid copy operator

◆ originalGraph()

const UndiGraph* gum::StaticTriangulation::originalGraph ( ) const
inherited

returns the graph to be triangulated

Warning
if we have not set yet a graph, then originalGraph () will return a nullptr.

Referenced by gum::DefaultJunctionTreeStrategy::copyFactory().

+ Here is the caller graph for this function:

◆ reverseEliminationOrder()

const NodeProperty< NodeId >& gum::StaticTriangulation::reverseEliminationOrder ( )
inherited

returns a table indicating, for each node, at which step it was deleted by the triangulation process

◆ setFillIns()

void gum::StaticTriangulation::setFillIns ( bool  )
inherited

sets/unsets the record of the fill-ins in the standard triangulation procedure

◆ setGraph()

void gum::StaticTriangulation::setGraph ( const UndiGraph graph,
const NodeProperty< Size > *  domsizes 
)
virtualinherited

initialize the triangulation data structures for a new graph

Parameters
graphthe graph to be triangulated, i.e., the nodes of which will be eliminated
domsizesthe domain sizes of the nodes to be eliminated
Warning
Note that we allow domsizes to be defined over nodes/variables that do not belong to graph. These sizes will simply be ignored. However, it is compulsory that all the nodes of graph belong to dom_sizes
the graph is not copied but only referenced by the elimination sequence algorithm.

Implements gum::Triangulation.

Reimplemented in gum::PartialOrderedTriangulation, and gum::OrderedTriangulation.

Definition at line 526 of file staticTriangulation.cpp.

References gum::StaticTriangulation::__added_fill_ins, gum::StaticTriangulation::__elim_cliques, gum::StaticTriangulation::__elim_order, gum::StaticTriangulation::__has_elimination_tree, gum::StaticTriangulation::__has_fill_ins, gum::StaticTriangulation::__has_junction_tree, gum::StaticTriangulation::__has_max_prime_junction_tree, gum::StaticTriangulation::__has_triangulated_graph, gum::StaticTriangulation::__has_triangulation, gum::StaticTriangulation::__node_2_max_prime_clique, gum::StaticTriangulation::__original_graph, gum::StaticTriangulation::__reverse_elim_order, gum::Triangulation::_domain_sizes, gum::StaticTriangulation::clear(), and gum::NodeGraphPart::size().

Referenced by gum::OrderedTriangulation::setGraph(), and gum::PartialOrderedTriangulation::setGraph().

527  {
528  // remove the old graph
529  clear();
530 
531  if (graph != nullptr) {
532  // prepare the size of the data for the new graph
533  __elim_order.resize(graph->size());
534  __reverse_elim_order.resize(graph->size());
535  __elim_cliques.resize(graph->size());
536  __added_fill_ins.resize(graph->size());
537  __node_2_max_prime_clique.resize(graph->size());
538  }
539 
540  // keep track of the variables passed in argument
541  __original_graph = graph;
542  _domain_sizes = domsizes;
543 
544  // indicate that no triangulation was performed for this graph
545  __has_triangulation = false;
546  __has_triangulated_graph = false;
547  __has_elimination_tree = false;
548  __has_junction_tree = false;
550  __has_fill_ins = false;
551  }
void clear()
reinitialize the graph to be triangulated to an empty graph
NodeProperty< NodeId > __node_2_max_prime_clique
indicates which clique of the max prime junction tree was created by the elmination of a given node (...
bool __has_max_prime_junction_tree
indicates whether a maximal prime subgraph junction tree has been constructed
const UndiGraph * __original_graph
a pointer to the (external) original graph (which will be triangulated)
bool __has_triangulated_graph
a boolean indicating whether we have constructed the triangulated graph
NodeProperty< NodeId > __reverse_elim_order
the elimination order (access by NodeId)
std::vector< EdgeSet > __added_fill_ins
a vector containing the set of fill-ins added after each node elimination (used by recursive thinning...
const NodeProperty< Size > * _domain_sizes
the domain sizes of the variables/nodes of the graph
bool __has_triangulation
a boolean indicating whether we have parformed a triangulation
bool __has_junction_tree
a boolean indicating whether the junction tree has been constructed
NodeProperty< NodeSet > __elim_cliques
the cliques formed by the elimination of the nodes
bool __has_fill_ins
indicates whether we actually computed fill-ins
bool __has_elimination_tree
a boolean indicating whether the elimination tree has been computed
std::vector< NodeId > __elim_order
the order in which nodes are eliminated by the algorithm
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setMinimalRequirement()

void gum::StaticTriangulation::setMinimalRequirement ( bool  )
inherited

sets/unset the minimality requirement

◆ triangulatedGraph()

const UndiGraph & gum::StaticTriangulation::triangulatedGraph ( )
virtualinherited

returns the triangulated graph

Implements gum::Triangulation.

Definition at line 487 of file staticTriangulation.cpp.

References gum::StaticTriangulation::__has_junction_tree, gum::StaticTriangulation::__has_triangulated_graph, gum::StaticTriangulation::__has_triangulation, gum::StaticTriangulation::__junction_tree, gum::StaticTriangulation::__original_graph, gum::StaticTriangulation::__triangulate(), gum::StaticTriangulation::__triangulated_graph, gum::UndiGraph::addEdge(), gum::StaticTriangulation::junctionTree(), and gum::Set< Key, Alloc >::size().

487  {
489 
490  // if we did not construct the triangulated graph during the triangulation,
491  // that is, we just constructed the junction tree, we shall construct it now
493  // just in case, be sure that the junction tree has been constructed
495 
496  // copy the original graph
498 
499  for (const auto clik_id : *__junction_tree) {
500  // for each clique, add the edges necessary to make it complete
501  const NodeSet& clique = __junction_tree->clique(clik_id);
502  std::vector< NodeId > clique_nodes(clique.size());
503  unsigned int i = 0;
504 
505  for (const auto node : clique) {
506  clique_nodes[i] = node;
507  i += 1;
508  }
509 
510  for (i = 0; i < clique_nodes.size(); ++i) {
511  for (unsigned int j = i + 1; j < clique_nodes.size(); ++j) {
512  try {
513  __triangulated_graph.addEdge(clique_nodes[i], clique_nodes[j]);
514  } catch (DuplicateElement&) {}
515  }
516  }
517  }
518 
520  }
521 
522  return __triangulated_graph;
523  }
const CliqueGraph & junctionTree()
returns a compatible junction tree
void __triangulate()
the function that performs the triangulation
Set< NodeId > NodeSet
Some typdefs and define for shortcuts ...
const UndiGraph * __original_graph
a pointer to the (external) original graph (which will be triangulated)
virtual void addEdge(const NodeId first, const NodeId second)
insert a new edge into the undirected graph
Definition: undiGraph_inl.h:35
bool __has_triangulated_graph
a boolean indicating whether we have constructed the triangulated graph
UndiGraph __triangulated_graph
the triangulated graph
bool __has_triangulation
a boolean indicating whether we have parformed a triangulation
bool __has_junction_tree
a boolean indicating whether the junction tree has been constructed
const CliqueGraph * __junction_tree
the junction tree computed by the algorithm
+ Here is the call graph for this function:

Member Data Documentation

◆ _domain_sizes

const NodeProperty< Size >* gum::Triangulation::_domain_sizes {nullptr}
protectedinherited

◆ _elimination_sequence_strategy

◆ _junction_tree_strategy


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