Web: https://deepcausality.com
DeepCausality is a hyper-geometric computational causality library that enables fast and deterministic context-aware causal reasoning over complex multi-stage causality models. Deep Causality adds only minimal overhead and thus is suitable for real-time applications without additional acceleration hardware.
DeepCausality is hosted as a sandbox project in the LF AI & Data Foundation.
๐ค Why DeepCausality?
- DeepCausality is written in Rust with safety, reliability, and performance in mind.
- DeepCausality provides recursive causal data structures that concisely express arbitrary complex causal structures.
- DeepCausality enables context awareness across data-like, time-like, space-like, spacetime-like entities stored within (multiple) context-hyper-graphs.
- DeepCausality simplifies modeling of complex tempo-spatial patterns.
- DeepCausality comes with Causal State Machine (CSM)
๐ Docs
๐ Getting Started
In your project folder, just run in a terminal:
See the starter example.
How to run the example code
You can also run the example code from the project root with cargo:
# make sure you're in the project root folder
# CSM (Causal State Machine)
# CTX (Context)
# Smoking inference
# Getting started example
๐ฆ Sub-Crates
โญ Usage
Docs:
Code:
๐ ๏ธ Cargo & Make
Cargo works as expected, but in addition to cargo, a makefile exists that abstracts over several additional tools you may have to install before all make commands work. To do so, please run the following command:
The make install command tests and tries to install all required developer dependencies. if the automatic install fails, the script will show a link with further installation instructions.
After all dependencies have been installed, the following commands are ready to use.
for
)
The scripts called by each make command are located in the script folder.
๐ฉโ๐ฉโ๐งโ๐ฆ Community
๐จโ๐ป๐ฉโ๐ป Contribution
Contributions are welcomed especially related to documentation, example code, and fixes. If unsure where to start, open an issue and ask. For more significant code contributions, please run make test and make check locally before opening a PR.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in deep_causality by you, shall be licensed under the MIT license without additional terms or conditions.
For details:
๐ Credits
The project took inspiration from several researchers and their projects in the field:
- Judea Pearl at UCLA
- Lucien Hardy at the Perimeter Institute
- Kenneth O. Stanley at OpenAI
- Ilya Shpitser at Johns Hopkins University
- Miguel Hernan, Causal Lab at Harvard University
- Elias Bareinboim at Columbia University
- Causality and Machine Learning at Microsoft Research
- Causal ML at uber.
Parts of the implementation are inspired by:
Finally, inspiration, especially related to the hypergraph structure, was derived from reading the Quanta Magazine.
๐ Licence
This project is licensed under the MIT license.
๐ฎ๏ธ Security
For details about security, please read the security policy.
๐ Sponsors
JetBrains, the premier software development tool provider, has granted a free all-product license under its open-source community support program to the DeepCausality project. The project team expresses its gratitude towards JetBrains generous contribution. Thank you for your commitment to OSS development!
๐ป Author
- Marvin Hansen.
- Github GPG key ID: 369D5A0B210D39BC
- GPG Fingerprint: 4B18 F7B2 04B9 7A72 967E 663E 369D 5A0B 210D 39BC