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

Uploaded CPython 3.10+Windows x86-64

pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-macosx_11_0_arm64.whl (3.4 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

pyagrum_nightly-3.1.0.dev202608191787066851-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.0.dev202608191787066851-cp310-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 0c322881459f74f529d7ffce494efe69fdd18859368cb0d429087e37d65cfb8c
MD5 cdb8bcb5492458d53c20d7433c746a77
BLAKE2b-256 49cb30c03ae0472c683a25750ab5db73bd9a8f18547c6f15c5edf1e6690d555e

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d47a5ed79b8d97eb5eb057376fb24836e6869e165deab849fa26da9a0b137134
MD5 4216b8982e16dbc2e9b9253f9d3e1184
BLAKE2b-256 706a6af26daa54b6f67c337cc1df91fb4028dc082986454ba8ea67915f5ea56c

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 533d17510262c2da55e0e3d1d920e112d2587bd45bd30d2916580b68829eec3a
MD5 760cfef979c4fc6be6edfae54c2e7f44
BLAKE2b-256 b5c80749860251a5c48ce71aff066b60d2fb71267d0c54469f74be46997ac3b1

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 28a6e5f8c04acff0f9c9ec4690a433ed907a056dbe8ba29393122b9eb20bbd50
MD5 5d263c57255a4208fc80789ff451b9e4
BLAKE2b-256 3c1111bd5511447f0c2e5123a035bf5f0d63f3c8e2a80c8084ee8985326b4033

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.0.dev202608191787066851-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 4912f14fd793f2e1423c46e695198b9f832edef72fd292def7e7287f51abff15
MD5 a2246f025c881111b404c15ca7a7df37
BLAKE2b-256 79fcf3fa356708957ed249b6e5a162fad4fbfe1650cf107425d32c966f11c70c

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