Toolkit for causal reasoning (Bayesian Networks / Inference)
What is CausalNex?
"A toolkit for causal reasoning with Bayesian Networks."
CausalNex aims to become one of the leading libraries for causal reasoning and "what-if" analysis using Bayesian Networks. It helps to simplify the steps:
- To learn causal structures,
- To allow domain experts to augment the relationships,
- To estimate the effects of potential interventions using data.
CausalNex is built on our collective experience to leverage Bayesian Networks to identify causal relationships in data so that we can develop the right interventions from analytics. We developed CausalNex because:
- We believe leveraging Bayesian Networks is more intuitive to describe causality compared to traditional machine learning methodology that are built on pattern recognition and correlation analysis.
- Causal relationships are more accurate if we can easily encode or augment domain expertise in the graph model.
- We can then use the graph model to assess the impact from changes to underlying features, i.e. counterfactual analysis, and identify the right intervention.
In our experience, a data scientist generally has to use at least 3-4 different open-source libraries before arriving at the final step of finding the right intervention. CausalNex aims to simplify this end-to-end process for causality and counterfactual analysis.
What are the main features of CausalNex?
The main features of this library are:
- Use state-of-the-art structure learning methods to understand conditional dependencies between variables
- Allow domain knowledge to augment model relationship
- Build predictive models based on structural relationships
- Fit probability distribution of the Bayesian Networks
- Evaluate model quality with standard statistical checks
- Simplify how causality is understood in Bayesian Networks through visualisation
- Analyse the impact of interventions using Do-calculus
How do I install CausalNex?
CausalNex is a Python package. To install it, simply run:
pip install causalnex
Since pygraphviz can be difficult to install, esp. on Windows machines, the requirement is optional. If you want to use the causalnex native plotting tools, you can use
pip install "causalnex[plot]"
Alternatively, you can use the
networkx drawing functionality for visualisations with fewer dependencies.
all for a full installation of dependencies (only the plotting right now):
pip install "causalnex[all]"
How do I use CausalNex?
You can find the documentation for the latest stable release here. It explains:
- An end-to-end tutorial on how to use CausalNex
- The main concepts and methods in using Bayesian Networks for Causal Inference
Note: You can find the notebook and markdown files used to build the docs in
Can I contribute?
Yes! We'd love you to join us and help us build CausalNex. Check out our contributing documentation.
How do I upgrade CausalNex?
What licence do you use?
See our LICENSE for more detail.
Do you want to be part of the team that builds CausalNex and other great products at QuantumBlack? If so, you're in luck! QuantumBlack is currently hiring Machine Learning Engineers who love using data to drive their decisions. Take a look at our open positions and see if you're a fit.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size causalnex-0.9.0-py3-none-any.whl (127.0 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size causalnex-0.9.0.tar.gz (79.2 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for causalnex-0.9.0-py3-none-any.whl