PyPhi: A toolbox for integrated information theory
Open accessThe DOI matches its Crossref record; 20 of the 20 references it cites were found in a registry or an index.
Abstract
Integrated information theory provides a mathematical framework to fully characterize the cause-effect structure of a physical system. Here, we introduce PyPhi, a Python software package that implements this framework for causal analysis and unfolds the full cause-effect structure of discrete dynamical systems of binary elements. The software allows users to easily study these structures, serves as an up-to-date reference implementation of the formalisms of integrated information theory, and has been applied in research on complexity, emergence, and certain biological questions. We first provide an overview of the main algorithm and demonstrate PyPhi's functionality in the course of analyzing an example system, and then describe details of the algorithm's design and implementation. PyPhi can be installed with Python's package manager via the command 'pip install pyphi' on Linux and macOS systems equipped with Python 3.4 or higher. PyPhi is open-source and licensed under the GPLv3; the source code is hosted on GitHub at https://github.com/wmayner/pyphi. Comprehensive and continually-updated documentation is available at https://pyphi.readthedocs.io. The pyphi-users mailing list can be joined at https://groups.google.com/forum/#!forum/pyphi-users. A web-based graphical interface to the software is available at http://integratedinformationtheory.org/calculate.html.
Overview
The claims and statistics of this paper haven’t been checked yet.
Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.
Integrity signals
Registry
Cites
Statistics
Figures




Verification
Claims the paper makes
The claims and statistics of this paper haven’t been checked yet.
Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.
Claims other papers make about this one
Each is checked against this paper’s own text: does it say what the citing paper says it does?
The source backs part of the claim, not all of it — or backs it for a different population, condition or comparison.
In the citing paper
“This is because the computer contains modules that are connected to the rest of the system in a purely feedforward manner.This violates the requirement for integration”
From Dissociating Artificial Intelligence from Artificial Consciousness (2024) · cites this paper as [43]
Experimental — accuracy not yet measuredThe source backs part of the claim, not all of it — or backs it for a different population, condition or comparison.
In the citing paper
“This is because, despite the presence of feedback connections, the computer has many fault lines, such as sparse connectivity and bottlenecks, along which it segregates into smaller, nonoverlapping and maximally integrated pieces”
From Dissociating Artificial Intelligence from Artificial Consciousness (2024) · cites this paper as [43]
Experimental — accuracy not yet measuredThe cited source says what the claim attributes to it.
In the citing paper
“For these reasons, a full analysis of complexes and their cause–effect structure can only be performed on idealized systems of a few units [37].”
From Integrated information theory (IIT) 4.0: Formulating the properties of phenomenal existence in physical terms (2023) · cites this paper as [37]
The check wasn’t confident either way, so it gives no verdict — never disputed.
In the citing paper
“Specifically, uncertainty in the macro TPM reduces the selectivity of the macro system, and thus both its intrinsic information and integrated information [43].”
From Dissociating Artificial Intelligence from Artificial Consciousness (2024) · cites this paper as [43]
Experimental — accuracy not yet measured
Self-check
Percentages, sums and reported differences re-computed from the paper’s own numbers.
The self-check needs the paper’s full text.
Citations
Cites
Causality: Models, Reasoning, and Inference
Pearl, J. (2009) · doi:10.1017/cbo9780511803161 · Cited by 11,653
The NumPy Array: A Structure for Efficient Numerical Computation
van der Walt, S., Colbert, S. C., & Varoquaux, G. (2011) · Computing in Science & Engineering · doi:10.1109/mcse.2011.37 · Cited by 9,381 · cited 2×
“Most importantly, the multidimensional representation simplifies the calculation of marginal and conditional distributions and cause/effect repertoires, because it allows efficient “broadcasting” [19] of probabilities when multiplying distributions.”
An information integration theory of consciousness
Tononi, G. (2004) · BMC Neuroscience · doi:10.1186/1471-2202-5-42 · Cited by 1,958 · cited 1×
“…to itself); (2) composition (it must be composed of parts that have causal power within the whole); (3) information (its causal power must be specific); (4) integration (its causal power must not be reducible to that of its parts); and (5) exclusion (it must be maximally irreducible) [1–5].”
Self-citationIntegrated information theory: from consciousness to its physical substrate
Tononi, G., Boly, M., Massimini, M., & Koch, C. (2016) · Nature Reviews Neuroscience · doi:10.1038/nrn.2016.44 · Cited by 1,727 · cited 1×
“Details of the mathematical framework are published elsewhere [1,3]; in § Results we describe the output and input of the software and give an overview of the main algorithm in the course of reproducing results obtained from an example system studied in [3].”
Self-citationFrom the phenomenology to the mechanisms of consciousness: integrated information theory 3.0
Oizumi, M., Albantakis, L., & Tononi, G. (2014) · PLoS Computational Biology · doi:10.1371/journal.pcbi.1003588 · Cited by 1,128 · cited 9×
“The nodes to include can be specified with either their labels or their indices (note that in other PyPhi functions, nodes must be specified with their If there are nodes outside the subsystem, they are considered as background conditions for the causal analysis [3].”
InfluentialSelf-citationFast and robust Earth Mover's Distances
Pele, O., & Werman, M. (2009) · 2009 IEEE 12th International Conference on Computer Vision · doi:10.1109/iccv.2009.5459199 · Cited by 805
Integrated information in discrete dynamical systems: motivation and theoretical framework
Balduzzi, D., & Tononi, G. (2008) · PLoS Computational Biology · doi:10.1371/journal.pcbi.1000091 · Cited by 419 · cited 2×
“In this way, the analysis captures how a mechanism in a state constrains a purview without being biased by whether certain states arise more frequently than others in the dynamical evolution of the system [3,4,11,16].”
Self-citationQuantifying causal emergence shows that macro can beat micro
Hoel, E. P., Albantakis, L., & Tononi, G. (2013) · Proceedings of the National Academy of Sciences · doi:10.1073/pnas.1314922110 · Cited by 378 · cited 2×
“In this way, the analysis captures how a mechanism in a state constrains a purview without being biased by whether certain states arise more frequently than others in the dynamical evolution of the system [3,4,11,16].”
Self-citationInformation Flows in Causal Networks
AY, N., & POLANI, D. (2008) · Advances in Complex Systems · doi:10.1142/s0219525908001465 · Cited by 287 · cited 2×
“In this way, the analysis captures how a mechanism in a state constrains a purview without being biased by whether certain states arise more frequently than others in the dynamical evolution of the system [3,4,11,16].”
Tononi, G. (2015) · Scholarpedia · doi:10.4249/scholarpedia.4164 · Cited by 188
Self-citation
Research works printed but not linked: 1
- L Albantakis, 2017, Chapter 14: Automata and Animats, From Matter to Life: Information and Causality, 334
Cited by
Items 101–120 of 120
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.003.0007
Alternative Theories of Consciousness
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.003.0010
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.003.0012
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.003.0004
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.003.0005
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.002.0007
Rungs on the Ladder to Consciousness
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.003.0001
Thagard, P. R. (2025) · Oxford University Press eBooks · doi:10.1093/9780198962373.002.0002
From Function to Implementation: Exploring Degeneracy in Evolved Artificial Agents
Hu, Z., Cingiler, O., Bohm, C., & Albantakis, L. (2025) · Neural Computation · doi:10.1162/neco.a.19 · Cited by 2
Self-citationInformation integration and the latent consciousness of human groups
Watson, J. R., Maier, A., Novillo, Á., Echegoyen, I., Resta, R., del Campo, R. L., & Buldú, J. M. (2025) · Chaos Solitons & Fractals · doi:10.1016/j.chaos.2025.117627 · Cited by 3
A K-Means-Based Strategy for Estimating the MIP in Integrated Information Theory
Guerrero, L. E., Arango‐López, J., Castillo, L., & Moreira, F. (2026) · Lecture notes in networks and systems · doi:10.1007/978-3-032-10721-3_46
TAMING of the abrupt emergence
Beni, M. D., & Pietarinen, A. (2026) · Synthese · doi:10.1007/s11229-025-05413-9
“Exploring the relationship between the amount of comprehension and the level of competence would indeed be an intriguing avenue for further investigation, employ - ing various formal and experimental methodologies (Mayner et al., 2018 ; Tononi & Sporns, 2003 ).”
Díaz, J., Guerrero, L. E., Arango‐López, J., Castillo, L. F., & Bustamante-Mora, A. (2026) · Applied Sciences · doi:10.3390/app16020809
Mendieta, L. E. G., Arango‐López, J., & Castillo, L. F. (2026) · Communications in computer and information science · doi:10.1007/978-3-032-16761-3_10
Exploring Alternatives to Identify the Partitioning of Minimal Information Loss
Mendieta, L. E. G., Arango‐López, J., Castillo, L. F., Correa, J. D., & Moreira, F. (2026) · Lecture notes in networks and systems · doi:10.1007/978-3-032-12876-8_29
Collapse of local circuit integrated information Φ during NREM sleepPreprint
Onoda, K. (2026) · bioRxiv (Cold Spring Harbor Laboratory) · doi:10.64898/2026.04.01.715799
“In this study, Φ was computed according to IIT version 4 (Albantakis et al., 2023) using the PyPhi toolbox (Mayner et al., 2018).”
Formalizing Consciousness: Integrating AI with Integrated Information Theory (IIT)
Chatterjee, S., Srivastva, S., Atrey, P., Sah, N., & Das, S. (2026) · Lecture notes in networks and systems · doi:10.1007/978-3-032-25080-3_3
Integrated information theory (IIT) and the testability of the silent neuron predictions
de Leon, S. P., & Yoshimi, J. (2026) · Neuroscience of Consciousness · doi:10.1093/nc/niag037
“Based on IIT 3.0, the size of systems able to be analyzed is ∼ 10–12 nodes ( Mayner et al. 2018).”
InfluentialOn integrated information under Krohn-Rhodes decomposition
Mayeux, A. (2026) · Annals of Mathematics and Artificial Intelligence · doi:10.1007/s10472-026-10021-5
Biological Systems as Physical Data Processors: Evolution as a Case of Embodied Computing
de Lorenzo, V. (2026) · BioEssays · doi:10.1002/bies.70196
Metadata
- Authors
- Mayner, W. G. P., Marshall, W., Albantakis, L., Findlay, G., Marchman, R., & Tononi, G.
- Affiliations
- University of Wisconsin–Madison (US)
- Corresponding author
- Mayner, William G. P.
- Tononi, Giulio
- Venue
- PLOS Computational Biology
- Publisher
- Public Library of Science (PLoS)
- Published
- 2018-07-26
- Volume
- 14
- Issue
- 7
- Pages
- e1006343
- ISSN
- 1553-734X (ISSN-L)
- 1553-7358
- PMC
- PMC6080800
- OpenAlex
- W2779419474
- Cited by
- 118
- References
- 20
- Citations by year
- 2026: 14 · 2025: 29 · 2024: 14 · 2023: 12 · 2022: 7 · 2021: 13 · 2020: 16 · 2019: 12 · 2018: 1
- FWCI
- 5.37
- Type
- journal article
- Language
- en
- Update notices
- new_version (2018-08-07)
- Open access
- gold
- doi.org
- Licence
- Locations
- PLoS Computational Biology (publishedVersion, cc-by)
- Europe PMC (PubMed Central) (publishedVersion, cc-by)
- PubMed Central (publishedVersion, cc-by)
- PubMed (publishedVersion)
- arXiv (Cornell University) (submittedVersion)
- RePEc: Research Papers in Economics (submittedVersion)
- DOAJ (DOAJ: Directory of Open Access Journals) (submittedVersion, cc-by-sa)
- Figshare (submittedVersion, cc-by)
- arXiv (Cornell University) (cc-by)
- Funders
- Templeton World Charities Foundation (0067/AB41)
- National Institutes of Health (US) (NRSA T32 GM007507)
- Topics
- Physical Sciences › Physics and Astronomy › Statistical and Nonlinear Physics › Complex Systems and Dynamics
- Life Sciences › Neuroscience › Cognitive Neuroscience › Functional Brain Connectivity Studies
- Social Sciences › Arts and Humanities › History and Philosophy of Science › Philosophy of Biology and Scientific Explanation
- Keywords
- integrated information theory, causal structure, discrete dynamical systems, causal analysis, computational complexity, emergence, open source software, Python library
- MeSH terms
- Algorithms, Computer Simulation, Information Theory, Markov Chains, Software Design, User-Computer Interface
About these checks
Registry, retraction, Cites and statistics results are computed, not judged, with one exception: a printed reference that no index lists is read once by a model before it counts as a citation error. Claims are extracted by a model and kept only when their quote appears verbatim in the text; each cited source is then checked, with a model’s help, for whether it says what the claim relies on. Those verdicts can be wrong — read the claim’s quote and the cited source before relying on one.
Statistics and arithmetic are recomputed, not judged.
Confidence bands are shown only for fields calibrated on our annotated test set. None is calibrated yet, so no band is shown.
What counts as a claim ›How we measure confidence ›How we check this ›
Are you an author, or do you see a problem with this page? Request a review
Data sources
Bibliographic data: Semantic Scholar, OpenAlex, Crossref.
Contains information from the Semantic Scholar Academic Graph Datasets, made available under the ODC Attribution License (ODC-BY 1.0).
Semantic Scholar’s data is described in: Kinney, R., et al. (2023). The Semantic Scholar Open Data Platform. arXiv:2301.10140.