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

Uploaded CPython 3.10+Windows x86-64

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608131786444173-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 fddbd343b828f9bdb1c5fdd13dbc40c649371950f2bb5d89f39507a949206dc4
MD5 5da5f5ecb642647db379a2d6b5626e38
BLAKE2b-256 b69983c1a62bc2095f8ef973db2e915b66ee93f7785fefe517dd7aa436b29cc4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608131786444173-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e9fe918e8ef12420253be00c4ee10e99234a550068d040db5e9f65086390966f
MD5 bf37f6ef0ed015fbd3acdc2cabbf8291
BLAKE2b-256 00959784d8d8fc0d3f84c85440bbed98e8f13092f55ea466c77007b76c5640a4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608131786444173-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 6b096e82da1116cd897bd2191b20e6ed8242a71132b64b9ebfd80ced9a2a9804
MD5 b87a311b8cad3556d3486f9ff57d5c8a
BLAKE2b-256 2f6342ad8e6e2e33e98042df35897c2af650c16dfd6a9612d06ffbdb977bb179

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608131786444173-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 826fd109e2d0aa9182d4b5e428eaa5852587e90482b6ee6908e9ee7d51fc02ae
MD5 c4b4eea3754ca63fbc750289609abca5
BLAKE2b-256 2908d86191507ccf84f8f4d37894982edfc5b0dc3680a42b1246575d7a78ef64

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.0.9.dev202608131786444173-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 126543574fe88419d79905a58ddbfa4392498f93f4cf8d76f8489bc7737913ae
MD5 08e81c292704bd046a1fddedd2e5dd1a
BLAKE2b-256 dc35ea6b2827f910167a39ade17f3f9dbefe1df4d281a9186e76fe99c2d27302

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