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

Uploaded CPython 3.10+Windows x86-64

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608161786444173-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 8929fd4e5ccb4150373ce34279e5938e6e8b682e426912d861e139673c1ce71e
MD5 76ab9e8d28e7a6b6c7e3d0cb9c42a9ad
BLAKE2b-256 f92b64376b3e136d5075a9b76bb6ca749066bae95f9f352065461e8ab65423fe

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608161786444173-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8cf5516c25ae5083aabf25a55ea6e14d62e25cedc39c974a0b767de3a143c7d9
MD5 265dc484221545df036c790dbf54041c
BLAKE2b-256 b25df5cdbd31c09fd916a55ba3d0405ffa6deb0104440dc0f3239c6f0dede201

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608161786444173-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 12c598ca9975dd08405cad3108f53f89739d9a35aeef807a9e326796d5b6d503
MD5 ecfeb84b4d43d2c7286a24db4f80d4a5
BLAKE2b-256 717befd0ad87991d1a8f5d86c4599619e72a0310e2b1e728a432a471cb39ccac

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608161786444173-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2b8a82d0dd83d33b9f62be7feea165534810d0183261b82a9b6a70fa2753b935
MD5 b38e2007b5d27c3f36f92717a74b772d
BLAKE2b-256 e4eccf6c0ed4afc52e0ce5dea7dd953dbef74598ff0c25a0eb5c79ef58da0811

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608161786444173-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 480ca7dc0ef65fa2ca88e09f7a78c13ddefaaba27a5b546d1fb2b9f23bb8546b
MD5 2b5ffc82ecc7e2a63bde9604b9bee49f
BLAKE2b-256 a1ab3eed291e7a8559fc36cb86c5d1bc057c35a0873f8adb9aefe9b8ccc5337a

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