causalnex


Namecausalnex JSON
Version 0.12.1 PyPI version JSON
download
home_pagehttps://github.com/quantumblacklabs/causalnex
SummaryToolkit for causal reasoning (Bayesian Networks / Inference)
upload_time2023-06-22 13:11:35
maintainer
docs_urlNone
authorQuantumBlack Labs
requires_python>=3.8, <3.11
licenseApache Software License (Apache 2.0)
keywords causal reasoning bayesian network inference structure learning do-calculus
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            ![CausalNex](https://raw.githubusercontent.com/quantumblacklabs/causalnex/master/docs/source/causalnex_banner.png)

-----------------

| Theme | Status                                                                                                                                                                                                                 |
|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Latest Release | [![PyPI version](https://badge.fury.io/py/causalnex.svg)](https://pypi.org/project/causalnex/)                                                                                                                         |
| Python Version | [![Python Version](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10-blue.svg)](https://pypi.org/project/causalnex/)                                                            |
| `master` Branch Build | [![CircleCI](https://circleci.com/gh/quantumblacklabs/causalnex/tree/master.svg?style=shield&circle-token=92ab70f03f3183655473dad16be641959cd31b83)](https://circleci.com/gh/quantumblacklabs/causalnex/tree/master)   |
| `develop` Branch Build | [![CircleCI](https://circleci.com/gh/quantumblacklabs/causalnex/tree/develop.svg?style=shield&circle-token=92ab70f03f3183655473dad16be641959cd31b83)](https://circleci.com/gh/quantumblacklabs/causalnex/tree/develop) |
| Documentation Build | [![Documentation](https://readthedocs.org/projects/causalnex/badge/?version=latest)](https://causalnex.readthedocs.io/)                                                                                                |
| License | [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)                                                                                                   |
| Code Style | [![Code Style: Black](https://img.shields.io/badge/code%20style-black-black.svg)](https://github.com/ambv/black)                                                                                                       |


## 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.

## Why CausalNex?

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:

```bash
pip install causalnex
```

Use `all` for a full installation of dependencies:
```bash
pip install "causalnex[all]"
```

See more detailed installation instructions, including how to setup Python virtual environments, in our [installation guide](https://causalnex.readthedocs.io/en/latest/02_getting_started/02_install.html) and get started with our [tutorial](https://causalnex.readthedocs.io/en/latest/03_tutorial/01_first_tutorial.html).

## How do I use CausalNex?

You can find the documentation for the latest stable release [here](https://causalnex.readthedocs.io/en/latest/). It explains:

- An end-to-end [tutorial on how to use CausalNex](https://causalnex.readthedocs.io/en/latest/03_tutorial/01_first_tutorial.html)
- The [main concepts and methods](https://causalnex.readthedocs.io/en/latest/04_user_guide/04_user_guide.html) in using Bayesian Networks for Causal Inference

> Note: You can find the notebook and markdown files used to build the docs in [`docs/source`](docs/source).

## Can I contribute?

Yes! We'd love you to join us and help us build CausalNex. Check out our [contributing](CONTRIBUTING.md) documentation.

## How do I upgrade CausalNex?

We use [SemVer](http://semver.org/) for versioning. The best way to upgrade safely is to check our [release notes](RELEASE.md) for any notable breaking changes.

## How do I cite CausalNex?

You may click "Cite this repository" under the "About" section of this repository to get the citation information in APA and BibTeX formats.

## What licence do you use?

See our [LICENSE](LICENSE.md) for more detail.

## We're hiring!

Do you want to be part of the team that builds CausalNex and [other great products](https://www.mckinsey.com/capabilities/quantumblack/labs) 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](https://www.mckinsey.com/capabilities/quantumblack/careers-and-community) and see if you're a fit.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/quantumblacklabs/causalnex",
    "name": "causalnex",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8, <3.11",
    "maintainer_email": "",
    "keywords": "Causal Reasoning,Bayesian Network,Inference,Structure Learning,Do-Calculus",
    "author": "QuantumBlack Labs",
    "author_email": "causalnex@quantumblack.com",
    "download_url": "https://files.pythonhosted.org/packages/0c/7c/1698630b3dd6972bcdc4eb3569f35fd55aba4393cdb50e71cb3b63e1366a/causalnex-0.12.1.tar.gz",
    "platform": null,
    "description": "![CausalNex](https://raw.githubusercontent.com/quantumblacklabs/causalnex/master/docs/source/causalnex_banner.png)\n\n-----------------\n\n| Theme | Status                                                                                                                                                                                                                 |\n|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Latest Release | [![PyPI version](https://badge.fury.io/py/causalnex.svg)](https://pypi.org/project/causalnex/)                                                                                                                         |\n| Python Version | [![Python Version](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10-blue.svg)](https://pypi.org/project/causalnex/)                                                            |\n| `master` Branch Build | [![CircleCI](https://circleci.com/gh/quantumblacklabs/causalnex/tree/master.svg?style=shield&circle-token=92ab70f03f3183655473dad16be641959cd31b83)](https://circleci.com/gh/quantumblacklabs/causalnex/tree/master)   |\n| `develop` Branch Build | [![CircleCI](https://circleci.com/gh/quantumblacklabs/causalnex/tree/develop.svg?style=shield&circle-token=92ab70f03f3183655473dad16be641959cd31b83)](https://circleci.com/gh/quantumblacklabs/causalnex/tree/develop) |\n| Documentation Build | [![Documentation](https://readthedocs.org/projects/causalnex/badge/?version=latest)](https://causalnex.readthedocs.io/)                                                                                                |\n| License | [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)                                                                                                   |\n| Code Style | [![Code Style: Black](https://img.shields.io/badge/code%20style-black-black.svg)](https://github.com/ambv/black)                                                                                                       |\n\n\n## What is CausalNex?\n\n> \"A toolkit for causal reasoning with Bayesian Networks.\"\n\nCausalNex aims to become one of the leading libraries for causal reasoning and \"what-if\" analysis using Bayesian Networks. It helps to simplify the steps:\n - To learn causal structures,\n - To allow domain experts to augment the relationships,\n - To estimate the effects of potential interventions using data.\n\n## Why CausalNex?\n\nCausalNex 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:\n\n- 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.\n- Causal relationships are more accurate if we can easily **encode or augment domain expertise** in the graph model.\n- 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**.\n\nIn 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.\n\n## What are the main features of CausalNex?\n\nThe main features of this library are:\n\n- Use state-of-the-art structure learning methods to understand conditional dependencies between variables\n- Allow domain knowledge to augment model relationship\n- Build predictive models based on structural relationships\n- Fit probability distribution of the Bayesian Networks\n- Evaluate model quality with standard statistical checks\n- Simplify how causality is understood in Bayesian Networks through visualisation\n- Analyse the impact of interventions using Do-calculus\n\n## How do I install CausalNex?\n\nCausalNex is a Python package. To install it, simply run:\n\n```bash\npip install causalnex\n```\n\nUse `all` for a full installation of dependencies:\n```bash\npip install \"causalnex[all]\"\n```\n\nSee more detailed installation instructions, including how to setup Python virtual environments, in our [installation guide](https://causalnex.readthedocs.io/en/latest/02_getting_started/02_install.html) and get started with our [tutorial](https://causalnex.readthedocs.io/en/latest/03_tutorial/01_first_tutorial.html).\n\n## How do I use CausalNex?\n\nYou can find the documentation for the latest stable release [here](https://causalnex.readthedocs.io/en/latest/). It explains:\n\n- An end-to-end [tutorial on how to use CausalNex](https://causalnex.readthedocs.io/en/latest/03_tutorial/01_first_tutorial.html)\n- The [main concepts and methods](https://causalnex.readthedocs.io/en/latest/04_user_guide/04_user_guide.html) in using Bayesian Networks for Causal Inference\n\n> Note: You can find the notebook and markdown files used to build the docs in [`docs/source`](docs/source).\n\n## Can I contribute?\n\nYes! We'd love you to join us and help us build CausalNex. Check out our [contributing](CONTRIBUTING.md) documentation.\n\n## How do I upgrade CausalNex?\n\nWe use [SemVer](http://semver.org/) for versioning. The best way to upgrade safely is to check our [release notes](RELEASE.md) for any notable breaking changes.\n\n## How do I cite CausalNex?\n\nYou may click \"Cite this repository\" under the \"About\" section of this repository to get the citation information in APA and BibTeX formats.\n\n## What licence do you use?\n\nSee our [LICENSE](LICENSE.md) for more detail.\n\n## We're hiring!\n\nDo you want to be part of the team that builds CausalNex and [other great products](https://www.mckinsey.com/capabilities/quantumblack/labs) 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](https://www.mckinsey.com/capabilities/quantumblack/careers-and-community) and see if you're a fit.\n",
    "bugtrack_url": null,
    "license": "Apache Software License (Apache 2.0)",
    "summary": "Toolkit for causal reasoning (Bayesian Networks / Inference)",
    "version": "0.12.1",
    "project_urls": {
        "Homepage": "https://github.com/quantumblacklabs/causalnex"
    },
    "split_keywords": [
        "causal reasoning",
        "bayesian network",
        "inference",
        "structure learning",
        "do-calculus"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f3478458f3d575f7b20cac3a7fc3480e010606cbe00fb7f9f598c6588d966afc",
                "md5": "a22a9cb6cc41e03940f8132bf144a201",
                "sha256": "1328cfc240e53f6effd03974bc3282d15b085ad5f3becb118f1da02516126ed3"
            },
            "downloads": -1,
            "filename": "causalnex-0.12.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a22a9cb6cc41e03940f8132bf144a201",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8, <3.11",
            "size": 153889,
            "upload_time": "2023-06-22T13:11:34",
            "upload_time_iso_8601": "2023-06-22T13:11:34.043052Z",
            "url": "https://files.pythonhosted.org/packages/f3/47/8458f3d575f7b20cac3a7fc3480e010606cbe00fb7f9f598c6588d966afc/causalnex-0.12.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0c7c1698630b3dd6972bcdc4eb3569f35fd55aba4393cdb50e71cb3b63e1366a",
                "md5": "384b8788b2c6338857b65be7cdd28897",
                "sha256": "6b6d69e7fcdfb234e28d4ed41deac3935810f0c74d4f629eae1d72789f087437"
            },
            "downloads": -1,
            "filename": "causalnex-0.12.1.tar.gz",
            "has_sig": false,
            "md5_digest": "384b8788b2c6338857b65be7cdd28897",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8, <3.11",
            "size": 112745,
            "upload_time": "2023-06-22T13:11:35",
            "upload_time_iso_8601": "2023-06-22T13:11:35.743672Z",
            "url": "https://files.pythonhosted.org/packages/0c/7c/1698630b3dd6972bcdc4eb3569f35fd55aba4393cdb50e71cb3b63e1366a/causalnex-0.12.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-06-22 13:11:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "quantumblacklabs",
    "github_project": "causalnex",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": false,
    "circle": true,
    "requirements": [],
    "test_requirements": [],
    "lcname": "causalnex"
}
        
Elapsed time: 0.08692s