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.dev202608141786444173-cp310-abi3-win_amd64.whl (3.5 MB view details)

Uploaded CPython 3.10+Windows x86-64

pyagrum_nightly-3.0.0.9.dev202608141786444173-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.dev202608141786444173-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.dev202608141786444173-cp310-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608141786444173-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 810449c221c8743a506e097461eaf3351a33ac5c7cb9d4ea4f1027d7335ffd1c
MD5 9d30d4176c8b42bba3a56589c901de85
BLAKE2b-256 ce131f9679a0ca68f2f71ce29c76ca2a6c4d8db84ebf7fb7f6a7eb3b96372a02

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608141786444173-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3b0d9e366e8bd0d615a6f730451e1bf345bb66ba9638db2da9154d4fc24d3f3c
MD5 cdde95aabb70603df473d708767d17bd
BLAKE2b-256 5b056341ea233ed344c1f53b6001c26f684554db18439ffb46e86384b63d2a40

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608141786444173-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 2f6a74909ca2332bbf9569d3069186921fca5a10c3dcbba06e48cffa60b4b62a
MD5 c23fa22ca8a46b73a7b4890dd53fe6a6
BLAKE2b-256 c47e61cc6996957cc7b3e3440eb56e2580aa21cf59405a7cdfe78abb9d9bd04b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608141786444173-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4625ca816a9d94f3fa7bbe864aa9c959fe484a61ad96e94bc06f60eac55e845d
MD5 7edba8a84b8b90f5fd6fea6055518d97
BLAKE2b-256 dcf4aa765d0d8bac2d2a5eaaf4bfcbc53db6cc8255e7429e237a0bec2c4cf0fd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608141786444173-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 09e44616a5415da62b63f7cdced3fb164e76f33f5e4c5c1c7d9cacfdf9a31d7e
MD5 0d51a47fca66cb78469c92868fbc8b92
BLAKE2b-256 e1b67d8060815bc7f9ed98f3ef700c85bfa4217c3178b89317807cb8a109fb85

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