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

Uploaded CPython 3.10+Windows x86-64

pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-macosx_11_0_arm64.whl (3.4 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

pyagrum_nightly-3.1.1.9.dev202608281787169860-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.1.1.9.dev202608281787169860-cp310-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 7be18bc0d0c53e6b17d5728465246c1da5f734d10773926e4d599a97f7fa7f32
MD5 69729bf9c4d6e56c22b8c86312f64bcb
BLAKE2b-256 a4da044e7c79170fc42c0938059e1326f205646a1241b8fa9a7cac34174ee354

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 78cfa1c036e1fc1f4605e13a7dfe4a85206eac8b8a48856c14adb22b102b2832
MD5 ff1c6fb35688d71d1e0d6a0f2dc450e8
BLAKE2b-256 3ad895c6716a4097bf6472b51330a84f1da07a686a309645df3465e46201db5b

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 3021684ef04b2d125eea7d0d192180658520ee0cf05cae97e1753ee0b56c461f
MD5 2864e296d9e63196e8c7f27e06f9766d
BLAKE2b-256 e9f827c27444fddd9a8482c7c50f75fabec98b452e2a378800d825fab3700a2b

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 37c3a89cd4b355c89e2de5fa54f27f75dbae08029a0263c8f40a1a15589cc9c8
MD5 ad5340b29953edf264ddf4d5a76f505e
BLAKE2b-256 d46bad4e4c6d7cae92d235acb7f637708539b048ef3db6eae99d43f0b16563bc

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608281787169860-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 3aeff062de3ebdb3c8011a01b9251ee30a000140fdd5eeba5fb158c060b4dea7
MD5 535b9cfc1dbeb76f133ba8f7408b0955
BLAKE2b-256 ed4865c840bbd440750652f50704a025dcc690ac9ef0405f1fa8a4e56201e176

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