-
Notifications
You must be signed in to change notification settings - Fork 7
/
brainways.json
178 lines (178 loc) · 9.89 KB
/
brainways.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
{
"name": "brainways",
"display_name": "Brainways",
"visibility": "public",
"icon": "",
"categories": [],
"schema_version": "0.2.1",
"on_activate": null,
"on_deactivate": null,
"contributions": {
"commands": [
{
"id": "brainways.load_sample_project",
"title": "Load Brainways sample project",
"python_name": "brainways.ui._sample_project:load_sample_project",
"short_title": null,
"category": null,
"icon": null,
"enablement": null
},
{
"id": "brainways.load_sample_project_annotated",
"title": "Load Brainways sample annotated project",
"python_name": "brainways.ui._sample_project:load_sample_project_annotated",
"short_title": null,
"category": null,
"icon": null,
"enablement": null
},
{
"id": "brainways.make_qwidget",
"title": "Make Brainways widget",
"python_name": "brainways.ui.brainways_ui:BrainwaysUI",
"short_title": null,
"category": null,
"icon": null,
"enablement": null
},
{
"id": "brainways.read_bwp",
"title": "Read \".bwp\" files",
"python_name": "brainways.ui.napari_reader:get_reader",
"short_title": null,
"category": null,
"icon": null,
"enablement": null
}
],
"readers": [
{
"command": "brainways.read_bwp",
"filename_patterns": [
"*.bwp"
],
"accepts_directories": true
}
],
"writers": null,
"widgets": [
{
"command": "brainways.make_qwidget",
"display_name": "Brainways",
"autogenerate": false
}
],
"sample_data": [
{
"command": "brainways.load_sample_project",
"key": "sample_project",
"display_name": "Sample project"
},
{
"command": "brainways.load_sample_project_annotated",
"key": "sample_project_annotated",
"display_name": "Annotated sample project"
}
],
"themes": null,
"menus": {},
"submenus": null,
"keybindings": null,
"configuration": []
},
"package_metadata": {
"metadata_version": "2.1",
"name": "brainways",
"version": "0.1.15",
"dynamic": null,
"platform": null,
"supported_platform": null,
"summary": "Brainways",
"description": "# Brainways\n\n[![DOI](https://img.shields.io/badge/DOI-10.1101/2023.05.25.542252-green.svg)](https://doi.org/10.1101/2023.05.25.542252)\n[![License GNU GPL v3.0](https://img.shields.io/pypi/l/brainways.svg?color=green)](https://github.com/bkntr/brainways/raw/main/LICENSE)\n[![PyPI](https://img.shields.io/pypi/v/brainways.svg?color=green)](https://pypi.org/project/brainways)\n[![Python Version](https://img.shields.io/pypi/pyversions/brainways.svg?color=green)](https://python.org)\n[![tests](https://github.com/bkntr/brainways/workflows/tests/badge.svg)](https://github.com/bkntr/brainways/actions)\n[![codecov](https://codecov.io/gh/bkntr/brainways/branch/main/graph/badge.svg)](https://codecov.io/gh/bkntr/brainways)\n[![Documentation Status](https://readthedocs.org/projects/brainways/badge/?version=latest)](https://brainways.readthedocs.io/en/latest/?badge=latest)\n[![napari hub](https://img.shields.io/endpoint?url=https://api.napari-hub.org/shields/brainways)](https://napari-hub.org/plugins/brainways)\n\n<!-- markdownlint-disable MD026 -->\n## What Is Brainways?\n<!-- markdownlint-enable MD026 -->\n\nBrainways is an AI-based tool for automated registration, quantification and generation of brain-wide activity networks based on fluorescence in coronal slices.\n\n![Brainways UI](docs/assets/brainways-ui.gif)\n\n<!-- markdownlint-disable MD026 -->\n## Why Brainways?\n<!-- markdownlint-enable MD026 -->\n\nCoronal slice registration, cell quantification and whole-brain contrast analysis between experimental conditions should be made easily accessible from a single software, without requiring programming experience.\nCustomization should be made easy by having a highly flexible pythonic backend.\n\n## Getting Started\n\nTo install and run brainways, run the following in your python environment:\n\n```bash\npip install brainways\nbrainways ui\n```\n\nFollow our [getting started guide](https://brainways.readthedocs.io/en/latest/getting_started/) for more details.\n\n## How it works\n\nBrainways allows users to register, quantify and provide statistical contrast analysis by following several simple steps:\n\n1. Rigid registration of coronal slices to a 3D atlas.\n1. Non-rigid registration of coronal slices to a 3D atlas, to account for individual difference and imperfections in acquisition procedure.\n1. Cell detection (using [StarDist](https://github.com/stardist/stardist)).\n1. Quantification of cell counts per brain region.\n1. Statistical analysis:\n * ANOVA contrast analysis.\n * PLS (Partial Least Square) analysis.\n * Network graph creation.\n\n<!-- For a quick 10 minute overview of brainways, check out the demo presented to The Social Club community\nmeeting:\n\n[![Brainways Overview Demo](https://img.youtube.com/vi/aWDIQMbp1cc/0.jpg)](https://youtu.be/aWDIQMbp1cc?t=1m4s) -->\n\n## Architecture\n\nBrainways is implemented as three modules. `brainways.ui` contains the GUI implementation as a [napari](https://napari.org/stable/) plugin. `brainways.ui` is using `brainways` as its backend. All of the functionality is implemented in the brainways package. This separation was done to guarantee that brainways is a GUI-agnostic software, and can be fully accessed and manipulated through python code to allow custom complex usage scenarios. The code that was used to train, evaluate and run the automatic registration model resides in `brainways-reg-model`.\n\n## Development Status\n\nBrainways is being actively developed by Ben Kantor of Bartal lab, Tel Aviv University, Israel. Our releases can be found [here](https://github.com/bkntr/brainways/releases).\n\n## Citation\n\nIf you use brainways, please cite [Kantor and Bartal (2023)](https://doi.org/10.1101/2023.05.25.542252):\n\n @article{kantor2023brainways,\n title={Brainways: An Open-Source AI-based Software For Registration and Analysis of Fluorescent Markers on Coronal Brain Slices},\n author={Kantor, Ben and Ben-Ami Bartal, Inbal},\n journal={bioRxiv},\n pages={2023--05},\n year={2023},\n publisher={Cold Spring Harbor Laboratory}\n }\n\n## License\n\nDistributed under the terms of the [GNU GPL v3.0] license,\n\"brainways\" is free and open source software\n\n## Issues\n\nIf you encounter any problems, please [file an issue] along with a detailed description.\n\n[napari]: https://github.com/napari/napari\n[Cookiecutter]: https://github.com/audreyr/cookiecutter\n[@napari]: https://github.com/napari\n[MIT]: http://opensource.org/licenses/MIT\n[BSD-3]: http://opensource.org/licenses/BSD-3-Clause\n[GNU GPL v3.0]: http://www.gnu.org/licenses/gpl-3.0.txt\n[GNU LGPL v3.0]: http://www.gnu.org/licenses/lgpl-3.0.txt\n[Apache Software License 2.0]: http://www.apache.org/licenses/LICENSE-2.0\n[Mozilla Public License 2.0]: https://www.mozilla.org/media/MPL/2.0/index.txt\n[cookiecutter-napari-plugin]: https://github.com/napari/cookiecutter-napari-plugin\n\n[file an issue]: https://github.com/bkntr/brainways/issues\n\n[napari]: https://github.com/napari/napari\n[tox]: https://tox.readthedocs.io/en/latest/\n[pip]: https://pypi.org/project/pip/\n[PyPI]: https://pypi.org/\n",
"description_content_type": "text/markdown",
"keywords": null,
"home_page": "https://github.com/bkntr/brainways",
"download_url": null,
"author": "Ben Kantor",
"author_email": "[email protected]",
"maintainer": null,
"maintainer_email": null,
"license": "GPL-3.0",
"classifier": [
"Development Status :: 2 - Pre-Alpha",
"Framework :: napari",
"Intended Audience :: Developers",
"License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3 :: Only",
"Programming Language :: Python :: 3.9",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: Implementation :: CPython",
"Topic :: Scientific/Engineering :: Image Processing"
],
"requires_dist": [
"aicsimageio[base-imageio]==4.14.0",
"aicspylibczi",
"brainglobe-atlasapi",
"click",
"dacite",
"datasets",
"fsspec",
"huggingface-hub",
"importlib-resources",
"itk-elastix",
"kornia",
"napari[all]>=0.5.0",
"natsort",
"networkx",
"numpy<2.0.0",
"opencv-contrib-python-headless",
"opencv-python-headless",
"openpyxl",
"pandas",
"paquo",
"pingouin",
"qtpy",
"scikit-image",
"scikit-learn",
"scikit-posthocs",
"stardist",
"statsmodels",
"tensorflow",
"toml",
"torch",
"torchvision",
"lightning",
"tqdm",
"scyjava",
"pre-commit; extra == \"dev\"",
"py; extra == \"testing\"",
"pyqt5; extra == \"testing\"",
"pytest; extra == \"testing\"",
"pytest-cov; extra == \"testing\"",
"pytest-mock; extra == \"testing\"",
"pytest-qt<4.1.0; extra == \"testing\"",
"tox; extra == \"testing\""
],
"requires_python": ">=3.9",
"requires_external": null,
"project_url": [
"Bug Tracker, https://github.com/bkntr/brainways/issues",
"Documentation, https://github.com/bkntr/brainways#README.md",
"Source Code, https://github.com/bkntr/brainways",
"User Support, https://github.com/bkntr/brainways/issues"
],
"provides_extra": [
"dev",
"testing"
],
"provides_dist": null,
"obsoletes_dist": null
},
"npe1_shim": false
}