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

Uploaded CPython 3.10+Windows x86-64

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608261787169860-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 84cb1c3973656a449d31c64fd6efdbf7b4f02486ce3aae81a881db5daa95ff47
MD5 cd68e1dbaa7f14a5277508091575b14f
BLAKE2b-256 6810929a41ec83a7b75d75d3b92a2b14a3a1201953b89ede29d0b16dad5c98c1

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608261787169860-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 4dde617cbaeed317103621ba58424f5d40a9d3c08018dbb68220b6a4c838ae9c
MD5 39d35f2448d559c99f8b656670129f9d
BLAKE2b-256 f2d9234a21c0aa622d38232dcdc1420cf7ea1d002ef05c21b1e250959dacf149

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608261787169860-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 c6184a95bfb6540322e08550b996227fe30809aabee97e2c4ba67a779e5bd808
MD5 6f58870b0b1069569d9811e7e4d42538
BLAKE2b-256 90c13498e423a607889320ae8751c961ff27c37886bd6fe0deab9d0f430177e9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608261787169860-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 df1cdde13bbe69d6be88c09bc652c648ffe19776e3913fa68b00f9cbf7809f09
MD5 875b78e82f914a07752b195f9bdbd7e2
BLAKE2b-256 c158ee5100a02bdfaea2eaf61c4eb32978b66e0efdb79a3d84b2dcf22691510e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608261787169860-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 4cbeaf5f4df5c8f9918f11cf874d5432c5b8febddc39bfa7a46f2e478001729f
MD5 fdff144715dba748ba4c74331d45a6b6
BLAKE2b-256 f3ba26730eb36453510e81f653d4e0901c93ba6132d09e13f44cf027e55ca0ac

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