{ "info": { "author": "Brett Calcott", "author_email": "brett.calcott@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Topic :: Scientific/Engineering :: Mathematics" ], "description": "============================================\n``causalinfo``: Information on Causal Graphs \n============================================\n\n.. image:: https://badge.fury.io/py/causalinfo.png\n :target: http://badge.fury.io/py/causalinfo\n\n`causalinfo` is a Python library to aid in experimenting with different\n*information measures on causal graphs*---a combination of information\ntheory with recent work on causal graphs [Pearl2000]_. These information\nmeasures can used to ascertain the degree to which one variable controls or\nexplains other variables in the graph. The use of these measures has important\nconnections to work on causal explanation in philosophy of science, and to\nunderstanding information processing in biological networks. \n\nThe library is a work in progress, and will be extended as research continues.\n\nWhat does it do?\n----------------\n\n`causalinfo` has been written primarily for interactive use within `IPython\nNotebook`_. You can create variables and assign probability distributions to\nthem, or relate them to other variables using conditional probabilities.\nSeveral related variables can be combined into a directed acyclic graph, which\ncan generate a joint distribution for all variables under observation, or\nunder controlled interventions on certain variables. You can also calculate\nvarious information measures between variables in the graph whilst controlling\nother variables. These include correlative measures, such as Mutual\nInformation, but also causal measures, such as Information Flow\n[AyPolani2008]_, and Causal Specificity [GriffithsEtAl2015]_.\n\nFor some brief examples of how to use the library, please see the IPython Notebooks\nthat are included:\n\n* Introduction_. A short introduction to some of the things you can do with\n the library.\n\n* Rain_. Performing some interventions on a causal graph; an example from\n Judea Pearl's book.\n\n* Signaling_. Measuring Causation in Signaling Networks. Some examples from\n [CalcottEtAl2016]_.\n\n* `Information Flow`_. Measuring the flow of information in Causal networks\n from [AyPolani2008]_.\n\n.. _Introduction: https://github.com/brettc/causalinfo/blob/master/notebooks/introduction.ipynb\n\n.. _Rain: https://github.com/brettc/causalinfo/blob/master/notebooks/rain.ipynb\n\n.. _Signaling: https://github.com/brettc/causalinfo/blob/master/notebooks/signaling.ipynb\n\n.. _`Information Flow`: https://github.com/brettc/causalinfo/blob/master/notebooks/ay_polani.ipynb\n\n\n.. TODO: Add a getting started guide\n.. Getting Started\n ---------------\n .. code:: bash \n pip install causalinfo\n curl https://raw.githubusercontent.com/brettc/causalinfo/master/notebooks/introduction.ipynb \n\nSome Caveats\n------------\n\nThe library is not meant for large scale analysis. The code has been written\nto offload as much as possible on to other libraries (such as Pandas_ and\nNetworkx_), and to allow easy inspection of what is going on within `IPython\nNotebook`_, thus it is not optimized for speed. Calculating the joint\ndistribution for a causal graph with many variables can become very *slow*\n(especially if the variables have many states). \n\n\nAuthorship\n----------\n\nAll code was written by `Brett Calcott`_.\n\n\nAcknowledgments\n---------------\n\nThis work is part of the research project on the `Causal Foundations of\nBiological Information`_ at the `University of Sydney`_, Australia. The work\nwas made possible through the support of a grant from the Templeton World\nCharity Foundation. The opinions expressed are those of the author and do not\nnecessarily reflect the views of the Templeton World Charity Foundation. \n\nLicense\n-------\n\nMIT licensed. See the bundled LICENSE_ file for more details.\n\n\n.. Miscellaneous Links------------\n\n.. _LICENSE: https://github.com/brettc/causalinfo/blob/master/LICENSE\n\n.. _`Brett Calcott`: http://brettcalcott.com\n\n.. _`University of Sydney`: http://sydney.edu.au/ \n\n.. _`IPython Notebook`: http://ipython.org/notebook.html \n\n.. _Pandas: http://pandas.pydata.org/\n\n.. _Networkx: https://networkx.github.io/ \n\n.. _`Causal Foundations of Biological Information`: http://sydney.edu.au/foundations_of_science/research/causal_foundations_biological_information.shtml \n\n\nReferences\n----------\n\n.. [AyPolani2008] Ay, N., & Polani, D. (2008). Information flows in causal\n networks. Advances in Complex Systems, 11(01), 17\u201341.\n\n.. [GriffithsEtAl2015] Griffiths, P. E., Pocheville, A., Calcott, B., Stotz, K., \n Kim, H., & Knight, R. (2015). Measuring Causal Specificity. Philosophy of Science, 82(October), 529\u2013555.\n\n.. [CalcottEtAl2016] Calcott, B., Griffiths, P. E., Pocheville, A.\n (Forthcoming). Signals that Make a Difference. British Journal for Philosophy of Science.\n\n.. [Pearl2000] Pearl, J. (2000). Causality. Cambridge University Press. \n\n\n.. vim: fo=tcroqn tw=78", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github/brettc/causalinfo/", "keywords": "causal,information,network", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "causalinfo", "package_url": "https://pypi.org/project/causalinfo/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/causalinfo/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github/brettc/causalinfo/" }, "release_url": "https://pypi.org/project/causalinfo/1.2.0/", "requires_dist": null, "requires_python": null, "summary": "Information Measures on Causal Graphs.", "version": "1.2.0" }, "last_serial": 2555292, "releases": { "1.0.0": [], "1.1.0": [ { "comment_text": "", "digests": { "md5": "04d695987dc3edc95490cfd6513be37d", "sha256": "09296183c76983e5a1ad11c9d2510070a1515d3fa509d396b4b844061afb2194" }, "downloads": -1, "filename": "causalinfo-1.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "04d695987dc3edc95490cfd6513be37d", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 22715, "upload_time": "2015-11-17T03:17:20", "url": "https://files.pythonhosted.org/packages/1f/0c/4db65243a1f52c85e7566a48ea48eb682f4e6d7940613269e383325661e6/causalinfo-1.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "55d75bda1cf271cccef39579bc4c3196", "sha256": "5c36ad91f9488ddb6e9561fdd59224931c5953710b0c0c951ec9d941cafdd4ec" }, "downloads": -1, "filename": "causalinfo-1.1.0.tar.gz", "has_sig": false, "md5_digest": "55d75bda1cf271cccef39579bc4c3196", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18232, "upload_time": "2015-11-17T03:17:25", "url": "https://files.pythonhosted.org/packages/d6/95/27d28a0875dae4da0ab918f07056e2e1340f39da2b8abe641c2e6e2318f3/causalinfo-1.1.0.tar.gz" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "73c8d43dd8a3397cf03986cd1c6d27e5", "sha256": "279ad19e0fac74e52ae3471407eb3b28814f6b182c2fc78703571471c15fcbf2" }, "downloads": -1, "filename": "causalinfo-1.2.0.tar.gz", "has_sig": false, "md5_digest": "73c8d43dd8a3397cf03986cd1c6d27e5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18830, "upload_time": "2017-01-05T08:24:48", "url": "https://files.pythonhosted.org/packages/13/9b/64e3e61fa2132e13d7a513dff272eeaae7ff72aeaba24c870787590696dc/causalinfo-1.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "73c8d43dd8a3397cf03986cd1c6d27e5", "sha256": "279ad19e0fac74e52ae3471407eb3b28814f6b182c2fc78703571471c15fcbf2" }, "downloads": -1, "filename": "causalinfo-1.2.0.tar.gz", "has_sig": false, "md5_digest": "73c8d43dd8a3397cf03986cd1c6d27e5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18830, "upload_time": "2017-01-05T08:24:48", "url": "https://files.pythonhosted.org/packages/13/9b/64e3e61fa2132e13d7a513dff272eeaae7ff72aeaba24c870787590696dc/causalinfo-1.2.0.tar.gz" } ] }