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

Uploaded CPython 3.10+Windows x86-64

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608231787169860-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 9861657103df5ad9ab67f300889280b07573f787772915ad18cd896056798e2f
MD5 79a04c3233b7cdb5e353b4fd08cbf7cd
BLAKE2b-256 814c50d2329cc3bdd5a43c0562096d2888422aa36411ac3ac52f85de89dd79b2

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608231787169860-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 45b67dc4acc7becea42b3f6bb107ec3af8b903fe83a55adde605f3323287f38d
MD5 a124c8b1cfcf69ae1260f4a9e904ced2
BLAKE2b-256 efba624ebc03d8be8bb71a704936014dfabf687d0b6eecbedae22a6679579b50

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608231787169860-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 f96b8d7c2aebf45f4ef20fec54e9cf329874f3affdf01201fd920bb15b345df1
MD5 d5a5973cfdcd07ec3f867b4a67bf8542
BLAKE2b-256 6b0f8755a12f60611cafbda5def604be6d7cf1ae6fa3322c8b862b354b7854c9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608231787169860-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 84c9bebc7c79f8e004af497e910ddf549591b16aa60e82721fc02365ac0e8c5c
MD5 5f0c60f9655c1c79775ab85e95aa250c
BLAKE2b-256 5d875bb26747aa74dc55f97caf83e1c6fc1ad5da4916778775e6efef34880a03

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.1.1.9.dev202608231787169860-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 f9bd28193fca1bcba4a1e08a9bf6decbff8ca8b05123db15e01de3fb403058f6
MD5 ce0f28cacd34867bc3b10176283dd25b
BLAKE2b-256 907dbaabc854e72c686ec23f05ddcc0d1b05439f2cd6f6b203a39be022cfb84e

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