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

Uploaded CPython 3.10+Windows x86-64

pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-macosx_11_0_arm64.whl (3.4 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

pyagrum_nightly-3.0.1.dev202608181786967828-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.1.dev202608181786967828-cp310-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 ec62afedd5cba227e8346b8ca6cb3dfa8130ee960c740b3d030baf2dbe927554
MD5 e392b4195ca2b8287de48cbb6e4cff25
BLAKE2b-256 4a40b413bd4c99670306124d5dd0f6b67e8ff6e4113f302ae765b549ff816afc

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 b78a24a32ffdd3801a9620f23d269ee98d50c8ce7591aa2865a5ac14b5bf3d8b
MD5 47be96f87dfd3e0b6ff59220a4cb408b
BLAKE2b-256 76205acddec59c4f3c1b671fc483ff64698e346c346c66a40e6ff54dcc3f6438

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 15ce62b6a7fc47facce32bff101ce22712ac3879c81202be6a4344ec39c1a5b5
MD5 a478309e6d154cd2290498a69e521fc5
BLAKE2b-256 376e83ed12e8ec326dcafbcce2fa8babd255a82ec25a053cde5221cfeda051a6

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 fd18e49d55fe4616980a22fd75f707ff532d27882e147f033ac37ee568e8a389
MD5 d6f3bb4732cac98ecdbec6f7a322bad3
BLAKE2b-256 7a890a532e91d885f7f4078b0591faca5057522126294ca1df6d67141fdf26c5

See more details on using hashes here.

File details

Details for the file pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for pyagrum_nightly-3.0.1.dev202608181786967828-cp310-abi3-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 d1289562f548ce86f7e4271b278f8279a78662936dbbe6123b7aaa436146178e
MD5 474e08a7fc9e85f6a0c098a89c607202
BLAKE2b-256 d6fdb7d256d456857e809c7ac19cc78ffa318d1bad0a44573268ad766d2d6762

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