pyAgrum-nightly 2.3.1.9.dev202512261765915415__cp310-abi3-macosx_10_15_x86_64.whl

pyagrum/ctbn/notebook.py

@@ -0,0 +1,264 @@
+############################################################################
+#   This file is part of the aGrUM/pyAgrum library.                        #
+#                                                                          #
+#   Copyright (c) 2005-2025 by                                             #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#                                                                          #
+#   The aGrUM/pyAgrum library is free software; you can redistribute it    #
+#   and/or modify it under the terms of either :                           #
+#                                                                          #
+#    - the GNU Lesser General Public License as published by               #
+#      the Free Software Foundation, either version 3 of the License,      #
+#      or (at your option) any later version,                              #
+#    - the MIT license (MIT),                                              #
+#    - or both in dual license, as here.                                   #
+#                                                                          #
+#   (see https://agrum.gitlab.io/articles/dual-licenses-lgplv3mit.html)    #
+#                                                                          #
+#   This aGrUM/pyAgrum library is distributed in the hope that it will be  #
+#   useful, but WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,          #
+#   INCLUDING BUT NOT LIMITED TO THE WARRANTIES MERCHANTABILITY or FITNESS #
+#   FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT. IN NO EVENT SHALL THE   #
+#   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER #
+#   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,        #
+#   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR  #
+#   OTHER DEALINGS IN THE SOFTWARE.                                        #
+#                                                                          #
+#   See LICENCES for more details.                                         #
+#                                                                          #
+#   SPDX-FileCopyrightText: Copyright 2005-2025                            #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#   SPDX-License-Identifier: LGPL-3.0-or-later OR MIT                      #
+#                                                                          #
+#   Contact  : info_at_agrum_dot_org                                       #
+#   homepage : http://agrum.gitlab.io                                      #
+#   gitlab   : https://gitlab.com/agrumery/agrum                           #
+#                                                                          #
+############################################################################
+
+"""
+This file defines some helpers for handling CTBNs in notebooks
+"""
+
+from tempfile import mkdtemp
+import matplotlib.pyplot as plt
+import IPython
+import time
+import hashlib
+
+import pyagrum as gum
+from pyagrum.lib import proba_histogram
+import pyagrum.lib._colors as gumcols
+import pyagrum.lib.notebook as gnb
+import pydot as dot
+
+from pyagrum.ctbn import CTBN
+from pyagrum.ctbn import ForwardSamplingInference
+
+
+def getCtbnGraph(ctbn: CTBN, size=None):
+  """
+  Returns a HTML representing the CTBN.
+
+  Parameters
+  ----------
+  ctbn : CTBN
+      The CTBN.
+  size : int|str
+      The size of the rendered graph.
+
+  Returns
+  -------
+  pydot.Dot
+      The dot representation.
+  """
+  if size is None:
+    size = gum.config["ctbn", "default_graph_size"]
+  return gnb.getDot(ctbn.toDot(), size)
+
+
+def showCtbnGraph(ctbn: CTBN, size=None):
+  """
+  Show a pydot svg representation of the CTBN.
+
+  Parameters
+  ----------
+  ctbn : CTBN
+      The CTBN.
+  size : int|str
+      The size of the rendered graph.
+  """
+
+  if size is None:
+    size = gum.config["ctbn", "default_graph_size"]
+  gnb.showDot(ctbn.toDot(), size)
+
+
+def getCIMs(ctbn: CTBN, size=None):
+  """
+  Returns a HTML representing the CIMS of the CTBN.
+
+  Parameters
+  ----------
+  ctbn : CTBN
+      The CTBN.
+  size : int|str
+  """
+  gnb.flow.clear()
+  for var in ctbn.names():
+    gnb.flow.add(ctbn.CIM(var)._pot, caption=f"CIM({var})")
+  return gnb.flow.html()
+
+
+def showCIMs(ctbn: CTBN, size=None):
+  """
+  Show a pydot svg representation of the CIMs of the CTBN.
+
+  Parameters
+  ----------
+  ctbn : CTBN
+      The CTBN.
+  size : int|str
+  """
+  html = getCIMs(ctbn, size=size)
+  IPython.display.display(html)
+
+
+def CTBNinference2dot(
+  ctbn, engine, size=None, targets=None, nodeColor=None, arcWidth=None, arcColor=None, cmapNode=None, cmapArc=None
+):
+  """
+  create a pydot representation of an inference in a CTBN
+
+  Parameters
+  ----------
+    ctbn : CTBN
+      the Bayesian network
+    size: str
+      size of the rendered graph
+    engine:  pyagrum.Inference
+      inference algorithm used. If None, LazyPropagation will be used
+    targets: set
+      set of targets. If targets={} then each node is a target
+    nodeColor: dict
+      a nodeMap of values to be shown as color nodes (with special color for 0 and 1)
+    arcWidth: dict
+      a arcMap of values to be shown as bold arcs
+    arcColor: dict
+      a arcMap of values (between 0 and 1) to be shown as color of arcs
+    cmapNode: ColorMap
+      color map to show the vals of Nodes
+    cmapArc: ColorMap
+      color map to show the vals of Arcs
+
+  Returns
+  -------
+    the desired representation of the inference
+  """
+  if targets is None:
+    targets = {}
+  if cmapNode is None:
+    cmapNode = plt.get_cmap(gum.config["notebook", "default_node_cmap"])
+
+  if cmapArc is None:
+    cmapArc = plt.get_cmap(gum.config["notebook", "default_arc_cmap"])
+
+  # defaukt
+  maxarcs = 100
+  minarcs = 0
+
+  if arcWidth is not None:
+    minarcs = min(arcWidth.values())
+    maxarcs = max(arcWidth.values())
+
+  startTime = time.time()
+  if engine is None:
+    ie = ForwardSamplingInference(ctbn)
+  else:
+    ie = engine
+
+  ie.makeInference()
+  stopTime = time.time()
+
+  temp_dir = mkdtemp("", "tmp", None)  # with TemporaryDirectory() as temp_dir:
+
+  dotstr = 'digraph structs {\n  fontcolor="' + gumcols.getBlackInTheme() + '";bgcolor="transparent";'
+
+  if gum.config.asBool["notebook", "show_inference_time"]:
+    dotstr += f'  label="Inference in {1000 * (stopTime - startTime):6.2f}ms";\n'
+
+  fontname, fontsize = gumcols.fontFromMatplotlib()
+  dotstr += f'  node [fillcolor="{gum.config["notebook", "default_node_bgcolor"]}", style=filled,color="{gum.config["notebook", "default_node_fgcolor"]}",fontname="{fontname}",fontsize="{fontsize}"];\n'
+  dotstr += f'  edge [color="{gumcols.getBlackInTheme()}"];\n'
+
+  showdag = ctbn._graph
+
+  for nid in showdag.nodes():
+    name = ctbn.variable(nid).name()
+
+    # defaults
+    bgcol = gum.config["notebook", "default_node_bgcolor"]
+    fgcol = gum.config["notebook", "default_node_fgcolor"]
+    if len(targets) == 0 or name in targets or nid in targets:
+      bgcol = gum.config["notebook", "figure_facecolor"]
+
+    if nodeColor is not None and (name in nodeColor or nid in nodeColor):
+      bgcol = gumcols.proba2bgcolor(nodeColor[name], cmapNode)
+      fgcol = gumcols.proba2fgcolor(nodeColor[name], cmapNode)
+
+    # 'hard' colour for evidence (?)
+    # if name in evs or nid in evs:
+    #   bgcol = gum.config["notebook", "evidence_bgcolor"]
+    #   fgcol = gum.config["notebook", "evidence_fgcolor"]
+    colorattribute = f'fillcolor="{bgcol}", fontcolor="{fgcol}", color="#000000"'
+    if len(targets) == 0 or name in targets or nid in targets:
+      filename = temp_dir + hashlib.md5(name.encode()).hexdigest() + "." + gum.config["notebook", "graph_format"]
+      proba_histogram.saveFigProba(ie.posterior(name), filename, bgcolor=bgcol)
+      dotstr += f' "{name}" [shape=rectangle,image="{filename}",label="", {colorattribute}];\n'
+    else:
+      dotstr += f' "{name}" [{colorattribute}]'
+
+  for a in showdag.arcs():
+    (n, j) = a
+    pw = 1
+    av = f"{n} → {j}"
+    col = gumcols.getBlackInTheme()
+
+    if arcWidth is not None and a in arcWidth:
+      if maxarcs != minarcs:
+        pw = 0.1 + 5 * (arcWidth[a] - minarcs) / (maxarcs - minarcs)
+      av = f"{n} → {j} : {arcWidth[a]}"
+
+    if arcColor is not None and a in arcColor:
+      col = gumcols.proba2color(arcColor[a], cmapArc)
+
+    dotstr += (
+      f' "{ctbn.variable(n).name()}"->"{ctbn.variable(j).name()}" [penwidth="{pw}",tooltip="{av}",color="{col}"];'
+    )
+
+  dotstr += "}"
+
+  g = dot.graph_from_dot_data(dotstr)[0]
+
+  if size is None:
+    size = gum.config["notebook", "default_graph_inference_size"]
+  g.set_size(size)
+  g.temp_dir = temp_dir
+
+  return g
+
+
+def getCtbnInference(ctbn: CTBN, engine, targets=None, size=None):
+  if size is None:
+    size = gum.config["ctbn", "default_graph_size"]
+
+  return gnb.getGraph(CTBNinference2dot(ctbn, engine, targets=targets, size=size))
+
+
+def showCtbnInference(ctbn: CTBN, engine, targets=None, size=None):
+  gnb._showGraph(getCtbnInference(ctbn, engine, targets=targets, size=size))
+
+
+CTBN._repr_html_ = lambda ctbn: getCtbnGraph(ctbn)

pyagrum/defaults.ini

@@ -0,0 +1,199 @@
+[core]
+  default_maxNumberOfThreads = 24
+
+[notebook]
+  # displaying tensors in (HTML) table
+  tensor_visible_digits = 4
+  tensor_with_colors = True
+  tensor_color_0 = #FF7F64
+  tensor_color_1 = #7FFF64
+  tensor_with_fraction = False
+  tensor_fraction_limit = 50
+  tensor_fraction_round_error = 1e-6
+  tensor_fraction_with_latex = True
+
+  # for histograms with matplotlibs
+  histogram_horizontal_visible_digits=2
+  histogram_vertical_visible_digits=2
+  histogram_horizontal_threshold = 8
+  histogram_line_threshold = 40
+  histogram_color=darkseagreen
+  histogram_edge_color=darkgreen
+  histogram_use_percent = True
+  # histogram | bar
+  histogram_discretized_visualisation = histogram
+  histogram_discretized_scale = 1.0
+
+
+  # compact |  classical
+  histogram_mode=compact
+  histogram_epsilon=1e-8
+
+  # merge | revmerge | nomerge
+  tensor_parent_values = merge
+
+  # see matplotlib
+  figure_facecolor = #E0E0E0
+
+  # flow configuration
+  flow_background_color = transparent
+  flow_border_color = transparent
+  flow_border_width = 0
+
+  # svg or png
+  graph_format = svg
+
+  show_inference_time = True
+
+  #theming
+  default_arc_color = #4A4A4A
+  default_node_bgcolor = #404040
+  default_node_fgcolor = white
+  evidence_bgcolor = sandybrown
+  evidence_fgcolor = black
+  default_node_cmap = Pastel1
+  default_arc_cmap = BuGn
+  default_edge_cmap = BuGn
+
+  default_graph_size = 5
+  default_graph_inference_size = 8
+
+  # TB | LR
+  graph_rankdir = TB
+  # dot | neato | fdp | sfdp | twopi | circo | nop | nop2 | osage | patchwork
+  graph_layout = dot
+
+  # graph | factorgraph
+  default_markovrandomfield_view = factorgraph
+
+  # junctiontree / cliquegraph
+  junctiontree_graph_size = 10
+  junctiontree_with_names=True
+  junctiontree_separator_bgcolor=palegreen
+  junctiontree_separator_fgcolor=black
+  junctiontree_separator_fontsize=8
+  junctiontree_clique_bgcolor=burlywood
+  junctiontree_clique_fgcolor=black
+  junctiontree_clique_fontsize=10
+  junctiontree_map_cliquescale=0.3
+  junctiontree_map_sepscale=0.1
+  junctiontree_map_edgelen=1
+  junctiontree_map_size=10
+
+  # structural diff
+  graphdiff_missing_style=dashed
+  graphdiff_missing_color=red
+  graphdiff_overflow_style=dashed
+  graphdiff_overflow_color=purple
+  graphdiff_reversed_style=solid
+  graphdiff_reversed_color=purple
+  graphdiff_correct_style=solid
+  graphdiff_correct_color=grey
+
+
+[BN]
+  allow_modification_when_saving = False
+
+[factorgraph]
+  #theming
+  default_node_bgcolor = coral
+  default_node_fgcolor = black
+  default_factor_bgcolor = burlywood
+  edge_length = 0.7
+  edge_length_inference = 0.9
+  # dot | neato | fdp | sfdp | twopi | circo | nop | nop2 | osage | patchwork
+  graph_layout = neato
+
+[dynamicBN]
+  #theming
+  default_graph_size = 6
+
+[influenceDiagram]
+  #theming
+  default_graph_size = 6
+  default_chance_bgcolor = #808080
+  default_chance_fgcolor = white
+  default_utility_bgcolor = #50508A
+  default_utility_fgcolor = white
+  default_decision_bgcolor = #9A5050
+  default_decision_fgcolor = white
+
+  chance_shape = ellipse
+  utility_shape = hexagon
+  decision_shape = box
+
+  decision_arc_style = tapered, bold, dotted
+  utility_arc_style = dashed
+
+  default_id_size=6
+  default_id_inference_size=6
+
+  utility_visible_digits = 2
+  utility_show_stdev = True
+
+  #show utility (False) or -utility (Loss)
+  utility_show_loss = False
+
+[credalnet]
+  #theming
+  default_node_bgcolor = #404040
+  default_node_fgcolor = white
+  histo_max_color = #BBFFAA
+
+[causal]
+  show_latent_names = False
+  # latex command for notation of intervention in formula
+  #\hookrightarrow\mkern-6.5mu
+  latex_do_prefix = \text{do}(
+  latex_do_suffix = )
+
+  #theming
+  default_graph_size = 2.5
+  default_node_bgcolor = #404040
+  default_node_fgcolor = white
+  default_latent_bgcolor = #A08080
+  default_latent_fgcolor = black
+
+[ROC]
+  draw_color = #008800
+  fill_color = #AAEEAA
+
+[ctbn]
+  show_latent_names = False
+  default_graph_size = 2.5
+  default_node_bgcolor = #404040
+  default_node_fgcolor = white
+  default_latent_bgcolor = #A08080
+  default_latent_fgcolor = black
+
+[bnmixture]
+  default_graph_size = 5
+
+  default_line_size = 1.0
+  default_head_size = 0.25
+  default_arrow_type=normal
+  default_arc_cmap = Greens
+  default_arc_color = #4A4A4A
+  default_arc_style = solid
+  default_node_bgcolor = #404040
+  default_node_fgcolor = white
+  default_layout = fdp
+  default_overlap = 0
+
+
+  default_bar_capsize = 1.5
+  default_bar_height = 0.8
+  default_boot_histo_scale = 2.0
+  default_histo_scale = 1.0
+
+  correct_arc_style = solid
+  correct_arc_color = green
+  incorrect_arc_style = dashed
+  incorrect_arc_color = green
+
+  left_quantile = 0.2
+  right_quantile = 0.8
+
+[Pickle]
+  add_version = True
+  add_date = True

pyagrum/deprecated.py

@@ -0,0 +1,95 @@
+############################################################################
+#   This file is part of the aGrUM/pyAgrum library.                        #
+#                                                                          #
+#   Copyright (c) 2005-2025 by                                             #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#                                                                          #
+#   The aGrUM/pyAgrum library is free software; you can redistribute it    #
+#   and/or modify it under the terms of either :                           #
+#                                                                          #
+#    - the GNU Lesser General Public License as published by               #
+#      the Free Software Foundation, either version 3 of the License,      #
+#      or (at your option) any later version,                              #
+#    - the MIT license (MIT),                                              #
+#    - or both in dual license, as here.                                   #
+#                                                                          #
+#   (see https://agrum.gitlab.io/articles/dual-licenses-lgplv3mit.html)    #
+#                                                                          #
+#   This aGrUM/pyAgrum library is distributed in the hope that it will be  #
+#   useful, but WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,          #
+#   INCLUDING BUT NOT LIMITED TO THE WARRANTIES MERCHANTABILITY or FITNESS #
+#   FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT. IN NO EVENT SHALL THE   #
+#   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER #
+#   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,        #
+#   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR  #
+#   OTHER DEALINGS IN THE SOFTWARE.                                        #
+#                                                                          #
+#   See LICENCES for more details.                                         #
+#                                                                          #
+#   SPDX-FileCopyrightText: Copyright 2005-2025                            #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#   SPDX-License-Identifier: LGPL-3.0-or-later OR MIT                      #
+#                                                                          #
+#   Contact  : info_at_agrum_dot_org                                       #
+#   homepage : http://agrum.gitlab.io                                      #
+#   gitlab   : https://gitlab.com/agrumery/agrum                           #
+#                                                                          #
+############################################################################
+
+"""
+Deprecated for older pyAgrum
+"""
+
+import warnings
+import functools
+
+
+def deprecated_arg(newA: str, oldA: str, version: str):
+  """
+  Annotation of a function when changing the name of an argument of the function
+
+  Example
+  ------
+  @gum.deprecated_arg("x","old_x","1.8")
+  def f(x:int):
+    return 2*X
+
+  Parameters
+  ----------
+  newA:str
+    the new name of the argument
+  oldA:str
+    the old name of the argument
+  version:str
+    the version of pyAgrum
+  """
+
+  def deco(f):
+    @functools.wraps(f)
+    def wrapper(*args, **kwargs):
+      if oldA in kwargs:
+        if newA in kwargs:
+          warnings.warn(
+            f"""
+** pyAgrum : argument '{oldA}' is deprecated since '{version}', '{newA}' is used instead.
+""",
+            DeprecationWarning,
+            stacklevel=2,
+          )
+          kwargs.pop(oldA)
+        else:
+          warnings.warn(
+            f"""
+** pyAgrum : argument '{oldA}' is deprecated since '{version}', please use '{newA}' is instead.
+""",
+            DeprecationWarning,
+            stacklevel=2,
+          )
+          kwargs[newA] = kwargs.pop(oldA)
+      return f(*args, **kwargs)
+
+    return wrapper
+
+  return deco

pyagrum/explain/_ComputationCausal.py

@@ -0,0 +1,75 @@
+############################################################################
+#   This file is part of the aGrUM/pyAgrum library.                        #
+#                                                                          #
+#   Copyright (c) 2005-2025 by                                             #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#                                                                          #
+#   The aGrUM/pyAgrum library is free software; you can redistribute it    #
+#   and/or modify it under the terms of either :                           #
+#                                                                          #
+#    - the GNU Lesser General Public License as published by               #
+#      the Free Software Foundation, either version 3 of the License,      #
+#      or (at your option) any later version,                              #
+#    - the MIT license (MIT),                                              #
+#    - or both in dual license, as here.                                   #
+#                                                                          #
+#   (see https://agrum.gitlab.io/articles/dual-licenses-lgplv3mit.html)    #
+#                                                                          #
+#   This aGrUM/pyAgrum library is distributed in the hope that it will be  #
+#   useful, but WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,          #
+#   INCLUDING BUT NOT LIMITED TO THE WARRANTIES MERCHANTABILITY or FITNESS #
+#   FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT. IN NO EVENT SHALL THE   #
+#   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER #
+#   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,        #
+#   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR  #
+#   OTHER DEALINGS IN THE SOFTWARE.                                        #
+#                                                                          #
+#   See LICENCES for more details.                                         #
+#                                                                          #
+#   SPDX-FileCopyrightText: Copyright 2005-2025                            #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#   SPDX-License-Identifier: LGPL-3.0-or-later OR MIT                      #
+#                                                                          #
+#   Contact  : info_at_agrum_dot_org                                       #
+#   homepage : http://agrum.gitlab.io                                      #
+#   gitlab   : https://gitlab.com/agrumery/agrum                           #
+#                                                                          #
+############################################################################
+
+import pyagrum as gum
+
+# Calculations
+import numpy as np
+
+
+class CausalComputation:
+  @staticmethod
+  def _outOfCoalition(tau: list[int], inter: list[int]) -> list[int]:
+    # Returns the intersection of the parameter inter and the complement of the coalition tau.
+    return [i for i in inter if i not in tau]
+
+  @staticmethod
+  def _doCalculus(bn: gum.BayesNet, tau: list[int]) -> gum.BayesNet:
+    # Creates a new Bayesian Network by removing incoming arcs to the nodes in tau.
+    doNetTemplate = gum.BayesNet(bn)
+    for i in tau:
+      parents = doNetTemplate.parents(i)
+      for j in parents:
+        doNetTemplate.eraseArc(j, i)
+    return doNetTemplate
+
+  @staticmethod
+  def _chgCpt(doNetTemplate: gum.BayesNet, tau: list[int], alpha: list[int]) -> None:
+    # Changes the conditional probability tables (CPTs) of the nodes in tau to reflect the values in alpha.
+    for i, j in zip(tau, alpha):
+      doNetTemplate.cpt(i).fillWith(0.0)
+      doNetTemplate.cpt(i)[int(j)] = 1.0
+
+  @staticmethod
+  def _weight(evidces: dict[int, int], count: int, doLazy: gum.LazyPropagation) -> np.ndarray:
+    # Returns the evidces probability.
+    # The signature must be : Dict[int, int], int, **kwargs
+    doLazy.updateEvidence(evidces)
+    return doLazy.evidenceProbability() * count

pyagrum/explain/_ComputationConditional.py

@@ -0,0 +1,48 @@
+############################################################################
+#   This file is part of the aGrUM/pyAgrum library.                        #
+#                                                                          #
+#   Copyright (c) 2005-2025 by                                             #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#                                                                          #
+#   The aGrUM/pyAgrum library is free software; you can redistribute it    #
+#   and/or modify it under the terms of either :                           #
+#                                                                          #
+#    - the GNU Lesser General Public License as published by               #
+#      the Free Software Foundation, either version 3 of the License,      #
+#      or (at your option) any later version,                              #
+#    - the MIT license (MIT),                                              #
+#    - or both in dual license, as here.                                   #
+#                                                                          #
+#   (see https://agrum.gitlab.io/articles/dual-licenses-lgplv3mit.html)    #
+#                                                                          #
+#   This aGrUM/pyAgrum library is distributed in the hope that it will be  #
+#   useful, but WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,          #
+#   INCLUDING BUT NOT LIMITED TO THE WARRANTIES MERCHANTABILITY or FITNESS #
+#   FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT. IN NO EVENT SHALL THE   #
+#   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER #
+#   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,        #
+#   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR  #
+#   OTHER DEALINGS IN THE SOFTWARE.                                        #
+#                                                                          #
+#   See LICENCES for more details.                                         #
+#                                                                          #
+#   SPDX-FileCopyrightText: Copyright 2005-2025                            #
+#       - Pierre-Henri WUILLEMIN(_at_LIP6)                                 #
+#       - Christophe GONZALES(_at_AMU)                                     #
+#   SPDX-License-Identifier: LGPL-3.0-or-later OR MIT                      #
+#                                                                          #
+#   Contact  : info_at_agrum_dot_org                                       #
+#   homepage : http://agrum.gitlab.io                                      #
+#   gitlab   : https://gitlab.com/agrumery/agrum                           #
+#                                                                          #
+############################################################################
+
+import numpy as np
+
+
+class ConditionalComputation:
+  @staticmethod
+  def _weight(evidces: dict[int, int], count: int) -> np.ndarray:
+    # The signature must be : Dict[int, int], int, **kwargs
+    return count