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

Uploaded CPython 3.10+Windows x86-64

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608271787169860-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 50272647b3530fac1810a30be8ceec24ea90853e07c0547cd33b4abbca916d30
MD5 f0c8c74615a4df582cfd038a3b8f0092
BLAKE2b-256 46335ed304320ce321c9cf79d9091b4b5ca51e5b3fbf2582d2bbb59076c569fe

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608271787169860-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7823e49c1c06f9d1c41eaa04292dd0b1b166f60b9e643a926097e1a099e2dab1
MD5 be71f6995dc786477774e5eec7cb0fde
BLAKE2b-256 7516a41481aea5959e11e83cb8206f116a5ad42baf4e3d48f88740a67960134e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608271787169860-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 649bad1bfc99655232d0c6b2364f49a8231a2de9f9a2a0e3b0dd66b2bf237a9f
MD5 bea078581c195c111792d2f751018a0e
BLAKE2b-256 fbfbc194dd9c07856beb46389fa6d85289618eeabd06cfc28402e9d11711a97f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608271787169860-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 62243054fd5d6a88f7e5f85990cf7908126d317ea0be1615af86be2054e40160
MD5 10ea16364025ff4b097ad7b067157651
BLAKE2b-256 b2de8b0203f0c689d03487ebd97d95be8798ebd06006eb3bc82a1487b5422c64

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608271787169860-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 b76f54cd3978862397a2899808555104b0e31fc667c3a9c1ae65bf203c2c6ea8
MD5 a3769ca94337926ce4311546ad455062
BLAKE2b-256 c69ba9b57f897af988a7bed58eb3985667c979066c24dfb3feed3410539efc87

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