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

Uploaded CPython 3.10+Windows x86-64

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608241787169860-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 063dc591ba18fc8f9955be0dbe203609dc61b826f2d31831856f73b51c7d73e6
MD5 49cc1b5ec2b2f699f210743e60e4349f
BLAKE2b-256 6d605944f9fd52b92e5ed7b0056461f5a275a3c2acc856f891ec915007a6ec5c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608241787169860-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 829dbcd26ac3e47f7add6e0f512486bdad92c6faabfa952f373c2802f87677bc
MD5 303b3d4ef53f8173c819fc1f5814fafd
BLAKE2b-256 5c770a230cf8a9677dab4eed515ef1140f6e38bb53bbff91921e083f211e1851

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608241787169860-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 98c57d4f4114be5d3ab80522cba515eda5c60294dab829c8214dded4939a6c16
MD5 005d1e242766abccc6c846ae2c631e38
BLAKE2b-256 32bc86a0359dbddac62edc5d2f022c6e8072cde51053572bd173076d0b321cfd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608241787169860-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 404ca016bf1636a85305b7e4ef63fe1fe29b4c48ea1fca6e84ecec18b76233df
MD5 ee837dc1b44a3328d56f24239015a580
BLAKE2b-256 fd590bbc481ea839d8d1cdd1f0ed0b09259c41577d477b2647d7a3ab8793f4f4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608241787169860-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 9afb3273314f3d2175abb18ccd5848d77cfac43537db6e8e143d9db015ee6176
MD5 060d87361f3ab0f8ace32106998393bb
BLAKE2b-256 6fefffae2bee547d3d8e552761883b86552cef0ccfe649ba1964d33f4cd75d6b

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