Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

pyAgrum

pyAgrum is a scientific C++ and Python library dedicated to Bayesian Networks and other Probabilistic Graphical Models. It provides a high-level interface to the part of aGrUM allowing to create, model, learn, use, calculate with and embed Bayesian Networks and other graphical models. Some specific (python and C++) codes are added in order to simplify and extend the aGrUM API.

Important

Since pyAgrum 2.0.0, the package name follows PEP8 rules and is now pyagrum (lowercase). Please use import pyagrum instead of import pyAgrum in your code.

See the CHANGELOG for more details.

Example

import pyagrum as gum

# Creating BayesNet with 4 variables
bn=gum.BayesNet('WaterSprinkler')
print(bn)

# Adding nodes the long way
c=bn.add(gum.LabelizedVariable('c','cloudy ?',["Yes","No"]))
print(c)

# Adding nodes the short way
s, r, w = [ bn.add(name, 2) for name in "srw" ]
print (s,r,w)
print (bn)

# Addings arcs c -> s, c -> r, s -> w, r -> w
bn.addArc(c,s)
for link in [(c,r),(s,w),(r,w)]:
bn.addArc(*link)
print(bn)

# or, equivalenlty, creating the BN with 4 variables, and the arcs in one line
bn=gum.fastBN("w<-r<-c{Yes|No}->s->w")

# Filling CPTs
bn.cpt("c").fillWith([0.5,0.5])
bn.cpt("s")[0,:]=0.5 # equivalent to [0.5,0.5]
bn.cpt("s")[{"c":1}]=[0.9,0.1]
bn.cpt("w")[0,0,:] = [1, 0] # r=0,s=0
bn.cpt("w")[0,1,:] = [0.1, 0.9] # r=0,s=1
bn.cpt("w")[{"r":1,"s":0}] = [0.1, 0.9] # r=1,s=0
bn.cpt("w")[1,1,:] = [0.01, 0.99] # r=1,s=1
bn.cpt("r")[{"c":0}]=[0.8,0.2]
bn.cpt("r")[{"c":1}]=[0.2,0.8]

# Saving BN as a BIF file
gum.saveBN(bn,"WaterSprinkler.bif")

# Loading BN from a BIF file
bn2=gum.loadBN("WaterSprinkler.bif")

# Inference
ie=gum.LazyPropagation(bn)
ie.makeInference()
print (ie.posterior("w"))

# Adding hard evidence
ie.setEvidence({"s": 1, "c": 0})
ie.makeInference()
print(ie.posterior("w"))

# Adding soft and hard evidence
ie.setEvidence({"s": [0.5, 1], "c": 0})
ie.makeInference()
print(ie.posterior("w"))

LICENSE

Copyright (C) 2005-2024 by Pierre-Henri WUILLEMIN et Christophe GONZALES {prenom.nom}_at_lip6.fr

The aGrUM/pyAgrum library and all its derivatives are distributed under the dual LGPLv3+MIT license, see LICENSE.LGPL and LICENSE.MIT.

You can therefore integrate this library into your software solution but it will remain covered by either the LGPL v.3 license or the MIT license or, as aGrUM itself, by the dual LGPLv3+MIT license at your convenience. If you wish to integrate the aGrUM library into your product without being affected by this license, please contact us (info@agrum.org).

This library depends on different third-party codes. See src/aGrUM/tools/externals for specific COPYING and explicit permission of the authors, if needed.

If you use aGrUM/pyAgrum as a dependency of your own project, you are not contaminated by the GPL license of some of these third-party codes as long as you use only their aGrUM/pyAgrum interfaces and not their native interfaces.

Authors

  • Pierre-Henri Wuillemin

  • Christophe Gonzales

Maintainers

  • Lionel Torti

  • Gaspard Ducamp

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-win_amd64.whl (3.5 MB view details)

Uploaded CPython 3.10+Windows x86-64

pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-macosx_11_0_arm64.whl (3.4 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-macosx_10_15_x86_64.whl (3.8 MB view details)

Uploaded CPython 3.10+macOS 10.15+ x86-64

File details

Details for the file pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 09a527fa328aa0a865816f8b746e3b19f2730adf900b1ec79040a592db9221d3
MD5 4b5ec26db0eb44d0878e54f403f3d671
BLAKE2b-256 43fc935479b1bc17e889917dfa61b4cec52644b65205e3f6fe4eb59c009b4382

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 2b4b9063a70d8dbf3ea96b8e618f1b73b02c7d2226b70fe6dff41cb069ce9af3
MD5 43515b10e43a98a8d8a969b1c5fae795
BLAKE2b-256 4c7a5017409f26f31b5e0bf79e964c88187208de45e9a728f62e13d88cb41bc4

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 e4bca603ddfe76d5fca572f625e2ce14b45be73d534b4ec65bfcbc47b54f6642
MD5 05e95ba6be7431e47f2660e88001cdd6
BLAKE2b-256 f12ec5b07e9bd80a11bd6af45cf7f02a45a8bc6efd6962471d89e3ee9c309b22

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e5fe40cfc3acc84c5c2b49321d0231effb5903e36402511efd639aa4455f03af
MD5 ad32e42f5121862caea0961f1528ca97
BLAKE2b-256 0f18dbfeb199f2e480860d8e5c99f7a0bafb7598ee400f906a61ae11206609b0

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608121786444173-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 353461367b70e30ec98053065ff8912e2ba2eb55e89f3824f2a729ed19c1ad18
MD5 3f0035454e216e9a99ef463474fac5d5
BLAKE2b-256 2d09f8b8f2414cb1aced033e4e636cf0f302da1a0318d6d82f9606477af8dca5

See more details on using hashes here.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page