miic
Learning causal or non-causal graphical models using information theory
Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 7 DOI reference(s) in README -
✓Academic publication links
Links to: biorxiv.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (11.2%) to scientific vocabulary
Repository
Learning causal or non-causal graphical models using information theory
Basic Info
Statistics
- Stars: 31
- Watchers: 3
- Forks: 4
- Open Issues: 7
- Releases: 10
Metadata Files
README.md
MIIC
<!-- badges: start -->
<!-- badges: end -->
This repository contains the source code for MIIC (Multivariate Information-based Inductive Causation), a causal discovery method, based on information theory principles, which learns a large class of causal or non-causal graphical models from purely observational data, while including the effects of unobserved latent variables. Starting from a complete graph, the method iteratively removes dispensable edges, by uncovering significant information contributions from indirect paths, and assesses edge-specific confidences from randomization of available data. The remaining edges are then oriented based on the signature of causality in observational data. The recent more interpretable MIIC extension (iMIIC) further distinguishes genuine causes from putative and latent causal effects, while scaling to very large datasets (hundreds of thousands of samples). Since the version 2.0, MIIC also includes a temporal mode (tMIIC) to learn temporal causal graphs from stationary time series data. MIIC has been applied to a wide range of biological and biomedical data, such as single cell gene expression data, genomic alterations in tumors, live-cell time-lapse imaging data (CausalXtract), as well as medical records of patients. MIIC brings unique insights based on causal interpretation and could be used in a broad range of other data science domains (technology, climatology, economy, ...).
References
Simon F., Comes M. C., Tocci T., Dupuis L., Cabeli V., Lagrange N., Mencattini A., Parrini M. C., Martinelli E., Isambert H., CausalXtract: a flexible pipeline to extract causal effects from live-cell time-lapse imaging data, eLife 2024.
Ribeiro-Dantas M. D. C., Li H., Cabeli V., Dupuis L., Simon F., Hettal L., Hamy A. S., Isambert H., Learning interpretable causal networks from very large datasets, application to 400,000 medical records of breast cancer patients, iScience, 2024.
Cabeli V., Li H., Ribeiro-Dantas M., Simon F., Isambert H., Reliable causal discovery based on mutual information supremum principle for finite dataset, Why21 at NeurIPS 2021.
Cabeli V., Verny L., Sella N., Uguzzoni G., Verny M., Isambert H., Learning clinical networks from medical records based on information estimates in mixed-type data, PLoS Comput. Biol. 2020 | code
Li H., Cabeli V., Sella N., Isambert H., Constraint-based causal structure learning with consistent separating sets, In Advances in Neural Information Processing Systems 2019. | code.
Verny L., Sella N., Affeldt S., Singh PP., Isambert H., Learning causal networks with latent variables from multivariate information in genomic data, PLoS Comput. Biol. 2017.
Affeldt S., Isambert H., Robust Reconstruction of Causal Graphical Models based on Conditional 2-point and 3-point Information, UAI 2015 | supp.
Prerequisites
MIIC contains R and C++ sources.
- To compile from source, a compiler with support for c++14 language features is required.
- MIIC imports the following R packages: ppcor, scales, stats, Rcpp
Installation
From CRAN (release):
R
install.packages("miic")
Or from GitHub (development):
```R
install.packages("remotes")
remotes::installgithub("miicTeam/miicR_package") ```
Quick start
MIIC allows you to create a graph object from a dataset of observations
of both discrete and continuous variables, potentially with missing values
and taking into account unobserved latent variables.
You can find this example along others by calling the documentation
of the main function ?miic from R.
```R library(miic)
EXAMPLE HEMATOPOIESIS
data(hematoData)
execute MIIC (reconstruct graph)
miicobj <- miic( inputdata = hematoData, latent = "yes", nshuffles = 10, confthreshold = 0.001 )
plot graph with igraph
if(require(igraph)) { plot(miic_obj, method="igraph") } ```
Documentation
You can find the documentation pages in the "man" folder, in the auto generated
PDF,
or use R functions help() and ?.
Authors
- Tiziana Tocci
- Nikita Lagrange
- Orianne Debeaupuis
- Louise Dupuis
- Franck Simon
- Vincent Cabeli
- Honghao Li
- Marcel Ribeiro Dantas
- Verny Louis
- Sella Nadir
- Séverine Affeldt
- Hervé Isambert
License
GPL-2 | GPL-3
Owner
- Name: MIIC
- Login: miicTeam
- Kind: organization
- Location: France
- Website: https://miic.curie.fr
- Repositories: 2
- Profile: https://github.com/miicTeam
This organization contains repositories related to MIIC, a causal discovery application developed by Dr Isambert's team at Institut Curie.
GitHub Events
Total
- Watch event: 7
- Delete event: 1
- Issue comment event: 1
- Push event: 15
- Pull request review event: 3
- Pull request review comment event: 2
- Pull request event: 5
- Fork event: 2
- Create event: 4
Last Year
- Watch event: 7
- Delete event: 1
- Issue comment event: 1
- Push event: 15
- Pull request review event: 3
- Pull request review comment event: 2
- Pull request event: 5
- Fork event: 2
- Create event: 4
Committers
Last synced: over 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Honghao Li | h****2@g****m | 215 |
| vcabeli | v****i@g****m | 161 |
| Marcel Ribeiro-Dantas | m****s@c****r | 11 |
| franck-simon | 5****n | 7 |
| Franck SIMON | f****n@w****r | 3 |
| miic | r****t@m****e | 1 |
| miic | m****c@m****e | 1 |
| nadirsella | n****a@g****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 8 months ago
All Time
- Total issues: 47
- Total pull requests: 63
- Average time to close issues: 3 months
- Average time to close pull requests: about 1 month
- Total issue authors: 8
- Total pull request authors: 5
- Average comments per issue: 1.04
- Average comments per pull request: 0.17
- Merged pull requests: 53
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 5
- Average time to close issues: N/A
- Average time to close pull requests: 6 days
- Issue authors: 1
- Pull request authors: 2
- Average comments per issue: 3.0
- Average comments per pull request: 0.2
- Merged pull requests: 2
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- honghaoli42 (25)
- franck-simon (10)
- vcabeli (6)
- mribeirodantas (2)
- gcoter (1)
- KevinZhou-hub (1)
- ylincen (1)
- guodudou2 (1)
Pull Request Authors
- honghaoli42 (36)
- franck-simon (18)
- vcabeli (9)
- Alich13 (4)
- mribeirodantas (3)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 242 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 11
- Total maintainers: 1
cran.r-project.org: miic
Learning Causal or Non-Causal Graphical Models Using Information Theory
- Homepage: https://github.com/miicTeam/miic_R_package
- Documentation: http://cran.r-project.org/web/packages/miic/miic.pdf
- License: GPL-2 | GPL-3 [expanded from: GPL (≥ 2)]
-
Latest release: 2.0.3
published over 1 year ago