# Brain Connectivity Toolbox for Python version 0.6.0
Author: Roan LaPlante <rlaplant@nmr.mgh.harvard.edu>
Tested against python 2.7 and 3.9.
## Copyright information
This program strictly observes the tenets of fundamentalist Theravada Mahasi
style Buddhism. Any use of this program in violation of these aforementioned
tenets or in violation of the principles described in the Visuddhimagga Sutta
is strictly prohibited and punishable by extensive Mahayana style practice.
By being or not being mindful of the immediate present moment sensations
involved in the use of this program, you confer your acceptance of these terms
and conditions.
Note that the observation of the tenets of fundamentalist Theravada Mahasi
style Buddhism and the Visuddhimagga Sutta is optional as long as the terms and
conditions of the GNU GPLv3+ are upheld.
## Packages used
BCTPY is written in pure python and requires only `scipy` and `numpy`. `scipy` is required for a couple of functions for its statistical and linear algebra
packages which have some features not available in `numpy` alone. If you don't
have `scipy`, most functions that do not need `scipy` functionality will still work.
Note that graphs must be passed in as `numpy.array` rather than `numpy.matrix`. Other constraints/edge cases of the adjacency matrices (e.g. self-loops, negative weights) behave similarly to the matlab functions.
A small number of functions also depend on networkx. This notably includes Network-Based Statistic, a nonparametric test for differences in undirected weighted graphs from different populations. Ideally this dependency should be removed in the future.
Nosetests is used for the test suite. The test suite is not complete.
## About `bctpy` and other authors
BCT is a matlab toolbox with many graph theoretical measures off of which `bctpy`
is based. I did not write BCT (apart from small bugfixes I have submitted)
and a quality of life improvements that I have taken liberties to add.
With few exceptions, `bctpy` is a direct translation of matlab code to python.
`bctpy` should be considered beta software, with BCT being the gold standard by
comparison. I did my best to test all functionality in `bctpy`, but much of it is
arcane math that flies over the head of this humble programmer. There *are*
bugs lurking in `bctpy`, the question is not whether but how many. If you locate
bugs, please consider submitting pull requests.
Many thanks to Stefan Fuertinger for his assistance tracking down a number of
bugs. Stefan Fuertinger has a similar software package dealing with brain
network functionality at http://research.mssm.edu/simonyanlab/analytical-tools/
Many thanks to Chris Barnes for his assistance in documenting a number of issues and facilitating a number of test cases.
Credit for writing BCT (the matlab version) goes to the following list of
authors, especially Olaf Sporns and Mika Rubinov.
- Olaf Sporns
- Mikail Rubinov
- Yusuke Adachi
- Andrea Avena
- Danielle Bassett
- Richard Betzel
- Joaquin Goni
- Alexandros Goulas
- Patric Hagmann
- Christopher Honey
- Martijn van den Heuvel
- Rolf Kotter
- Jonathan Power
- Murray Shanahan
- Andrew Zalesky
In order to be a bit more compact I have removed the accreditations from the
docstrings each functions. This does not in any way mean that I wish to take
credit from the individual contributions. I have moved these accreditations
to the credits file.
Raw data
{
"_id": null,
"home_page": "https://github.com/aestrivex/bctpy",
"name": "bctpy",
"maintainer": "Roan LaPlante",
"docs_url": null,
"requires_python": "",
"maintainer_email": "rlaplant@nmr.mgh.harvard.edu",
"keywords": "",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/fa/45/5dd7980f7dc614e6afd6585938ea191d0aa9287df9b24324b6fd06d853ee/bctpy-0.6.0.tar.gz",
"platform": "any",
"description": "# Brain Connectivity Toolbox for Python version 0.6.0\n\nAuthor: Roan LaPlante <rlaplant@nmr.mgh.harvard.edu>\n\nTested against python 2.7 and 3.9.\n\n## Copyright information\n\nThis program strictly observes the tenets of fundamentalist Theravada Mahasi\nstyle Buddhism. Any use of this program in violation of these aforementioned\ntenets or in violation of the principles described in the Visuddhimagga Sutta\nis strictly prohibited and punishable by extensive Mahayana style practice.\nBy being or not being mindful of the immediate present moment sensations\ninvolved in the use of this program, you confer your acceptance of these terms\nand conditions.\n\nNote that the observation of the tenets of fundamentalist Theravada Mahasi\nstyle Buddhism and the Visuddhimagga Sutta is optional as long as the terms and\nconditions of the GNU GPLv3+ are upheld.\n\n## Packages used\n\nBCTPY is written in pure python and requires only `scipy` and `numpy`. `scipy` is required for a couple of functions for its statistical and linear algebra\npackages which have some features not available in `numpy` alone. If you don't\nhave `scipy`, most functions that do not need `scipy` functionality will still work.\n\nNote that graphs must be passed in as `numpy.array` rather than `numpy.matrix`. Other constraints/edge cases of the adjacency matrices (e.g. self-loops, negative weights) behave similarly to the matlab functions.\n\nA small number of functions also depend on networkx. This notably includes Network-Based Statistic, a nonparametric test for differences in undirected weighted graphs from different populations. Ideally this dependency should be removed in the future.\n\nNosetests is used for the test suite. The test suite is not complete.\n\n## About `bctpy` and other authors\n\nBCT is a matlab toolbox with many graph theoretical measures off of which `bctpy`\nis based. I did not write BCT (apart from small bugfixes I have submitted)\nand a quality of life improvements that I have taken liberties to add.\nWith few exceptions, `bctpy` is a direct translation of matlab code to python.\n\n`bctpy` should be considered beta software, with BCT being the gold standard by\ncomparison. I did my best to test all functionality in `bctpy`, but much of it is\narcane math that flies over the head of this humble programmer. There *are*\nbugs lurking in `bctpy`, the question is not whether but how many. If you locate\nbugs, please consider submitting pull requests.\n\nMany thanks to Stefan Fuertinger for his assistance tracking down a number of\nbugs. Stefan Fuertinger has a similar software package dealing with brain\nnetwork functionality at http://research.mssm.edu/simonyanlab/analytical-tools/\n\nMany thanks to Chris Barnes for his assistance in documenting a number of issues and facilitating a number of test cases.\n\nCredit for writing BCT (the matlab version) goes to the following list of\nauthors, especially Olaf Sporns and Mika Rubinov.\n\n- Olaf Sporns\n- Mikail Rubinov\n- Yusuke Adachi\n- Andrea Avena\n- Danielle Bassett\n- Richard Betzel\n- Joaquin Goni\n- Alexandros Goulas\n- Patric Hagmann\n- Christopher Honey\n- Martijn van den Heuvel\n- Rolf Kotter\n- Jonathan Power\n- Murray Shanahan\n- Andrew Zalesky\n\nIn order to be a bit more compact I have removed the accreditations from the\ndocstrings each functions. This does not in any way mean that I wish to take\ncredit from the individual contributions. I have moved these accreditations\nto the credits file.\n\n\n",
"bugtrack_url": null,
"license": "Visuddhimagga Sutta; GPLv3+",
"summary": "Brain Connectivity Toolbox for Python",
"version": "0.6.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "d57cb669f01e47d628f039e292961230",
"sha256": "de180b0fa3a0c8db2939b38b86d9ddceeef128b078f7de66f21252c308c52817"
},
"downloads": -1,
"filename": "bctpy-0.6.0-py3.9.egg",
"has_sig": false,
"md5_digest": "d57cb669f01e47d628f039e292961230",
"packagetype": "bdist_egg",
"python_version": "0.6.0",
"requires_python": null,
"size": 198718,
"upload_time": "2022-12-05T17:36:42",
"upload_time_iso_8601": "2022-12-05T17:36:42.733070Z",
"url": "https://files.pythonhosted.org/packages/e5/76/4b703c9cf3323624d58808b0827e015a9ef374b853e5f3b2edc480417856/bctpy-0.6.0-py3.9.egg",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "186c1c83e2290f7df5abe7d957a3a463",
"sha256": "36392049ec5a2ccae75a0cf89b21838fda41a351c31fe6c6622cfcff1c997933"
},
"downloads": -1,
"filename": "bctpy-0.6.0.tar.gz",
"has_sig": false,
"md5_digest": "186c1c83e2290f7df5abe7d957a3a463",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 95661,
"upload_time": "2022-12-05T17:36:44",
"upload_time_iso_8601": "2022-12-05T17:36:44.758541Z",
"url": "https://files.pythonhosted.org/packages/fa/45/5dd7980f7dc614e6afd6585938ea191d0aa9287df9b24324b6fd06d853ee/bctpy-0.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-05 17:36:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "aestrivex",
"github_project": "bctpy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "bctpy"
}
JSON
