clabtoolkit 0.3.3__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- clabtoolkit/__init__.py +5 -0
- clabtoolkit/bidstools.py +2260 -0
- clabtoolkit/config/bids.json +147 -0
- clabtoolkit/config/config.json +58 -0
- clabtoolkit/config/lobes.json +112 -0
- clabtoolkit/config/stats_mapping.json +140 -0
- clabtoolkit/config/viz_views.json +268 -0
- clabtoolkit/connectivitytools.py +0 -0
- clabtoolkit/dicomtools.py +941 -0
- clabtoolkit/dwitools.py +1999 -0
- clabtoolkit/freesurfertools.py +5378 -0
- clabtoolkit/imagetools.py +2734 -0
- clabtoolkit/misctools.py +5204 -0
- clabtoolkit/morphometrytools.py +2970 -0
- clabtoolkit/networktools.py +351 -0
- clabtoolkit/parcellationtools.py +3239 -0
- clabtoolkit/pipelinetools.py +1187 -0
- clabtoolkit/plottools.py +682 -0
- clabtoolkit/qcqatools.py +1305 -0
- clabtoolkit/segmentationtools.py +356 -0
- clabtoolkit/surfacetools.py +2785 -0
- clabtoolkit/visualizationtools.py +5575 -0
- clabtoolkit-0.3.3.dist-info/METADATA +212 -0
- clabtoolkit-0.3.3.dist-info/RECORD +28 -0
- clabtoolkit-0.3.3.dist-info/WHEEL +5 -0
- clabtoolkit-0.3.3.dist-info/licenses/AUTHORS.rst +13 -0
- clabtoolkit-0.3.3.dist-info/licenses/LICENSE +16 -0
- clabtoolkit-0.3.3.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,212 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: clabtoolkit
|
|
3
|
+
Version: 0.3.3
|
|
4
|
+
Summary: A comprehensive toolkit for neuroimaging data processing and analysis
|
|
5
|
+
Author-email: Yasser Alemán-Gómez <yasseraleman@protonmail.com>
|
|
6
|
+
Maintainer-email: Yasser Alemán-Gómez <yasseraleman@protonmail.com>
|
|
7
|
+
License-Expression: Apache-2.0
|
|
8
|
+
Project-URL: Homepage, https://github.com/connectomicslab/clabtoolkit
|
|
9
|
+
Project-URL: Repository, https://github.com/connectomicslab/clabtoolkit
|
|
10
|
+
Project-URL: Documentation, https://clabtoolkit.readthedocs.io
|
|
11
|
+
Project-URL: Bug Tracker, https://github.com/connectomicslab/clabtoolkit/issues
|
|
12
|
+
Keywords: neuroimaging,image-processing,bids,freesurfer,connectivity
|
|
13
|
+
Classifier: Development Status :: 4 - Beta
|
|
14
|
+
Classifier: Intended Audience :: Science/Research
|
|
15
|
+
Classifier: Intended Audience :: Developers
|
|
16
|
+
Classifier: Natural Language :: English
|
|
17
|
+
Classifier: Operating System :: OS Independent
|
|
18
|
+
Classifier: Programming Language :: Python :: 3
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
23
|
+
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
|
|
24
|
+
Classifier: Topic :: Scientific/Engineering :: Image Processing
|
|
25
|
+
Requires-Python: >=3.9
|
|
26
|
+
Description-Content-Type: text/x-rst
|
|
27
|
+
License-File: LICENSE
|
|
28
|
+
License-File: AUTHORS.rst
|
|
29
|
+
Requires-Dist: nibabel>=5.3.2
|
|
30
|
+
Requires-Dist: numpy>=1.23.5
|
|
31
|
+
Requires-Dist: pandas>=2.3.1
|
|
32
|
+
Requires-Dist: pydicom>=3.0.1
|
|
33
|
+
Requires-Dist: rich>=14.1.0
|
|
34
|
+
Requires-Dist: scipy>=1.16.0
|
|
35
|
+
Requires-Dist: setuptools>=80.9.0
|
|
36
|
+
Requires-Dist: scikit-image>=0.25.2
|
|
37
|
+
Requires-Dist: h5py>=3.14.0
|
|
38
|
+
Requires-Dist: matplotlib>=3.10.3
|
|
39
|
+
Requires-Dist: pyvista>=0.45.3
|
|
40
|
+
Requires-Dist: nilearn>=0.12.0
|
|
41
|
+
Requires-Dist: joblib>=1.5.1
|
|
42
|
+
Provides-Extra: dev
|
|
43
|
+
Requires-Dist: pytest>=8.4.1; extra == "dev"
|
|
44
|
+
Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
|
|
45
|
+
Requires-Dist: black>=25.1.0; extra == "dev"
|
|
46
|
+
Requires-Dist: ruff>=0.12.5; extra == "dev"
|
|
47
|
+
Requires-Dist: mypy>=1.17.0; extra == "dev"
|
|
48
|
+
Requires-Dist: pre-commit>=4.2.0; extra == "dev"
|
|
49
|
+
Requires-Dist: tox>=4.28.1; extra == "dev"
|
|
50
|
+
Requires-Dist: termcolor>=3.1.0; extra == "dev"
|
|
51
|
+
Requires-Dist: tabulate>=0.9.0; extra == "dev"
|
|
52
|
+
Provides-Extra: docs
|
|
53
|
+
Requires-Dist: sphinx>=8.2.3; extra == "docs"
|
|
54
|
+
Requires-Dist: sphinx-rtd-theme>=3.0.2; extra == "docs"
|
|
55
|
+
Requires-Dist: myst-parser>=4.0.1; extra == "docs"
|
|
56
|
+
Provides-Extra: test
|
|
57
|
+
Requires-Dist: pytest>=8.4.1; extra == "test"
|
|
58
|
+
Requires-Dist: pytest-cov>=6.2.1; extra == "test"
|
|
59
|
+
Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
|
|
60
|
+
Dynamic: license-file
|
|
61
|
+
|
|
62
|
+
========================
|
|
63
|
+
Connectomics Lab Toolkit
|
|
64
|
+
========================
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
.. image:: https://img.shields.io/pypi/v/clabtoolkit.svg
|
|
68
|
+
:target: https://pypi.python.org/pypi/clabtoolkit
|
|
69
|
+
|
|
70
|
+
.. image:: https://github.com/connectomicslab/clabtoolkit/actions/workflows/ci.yml/badge.svg
|
|
71
|
+
:target: https://github.com/connectomicslab/clabtoolkit/actions/workflows/ci.yml
|
|
72
|
+
|
|
73
|
+
.. image:: https://readthedocs.org/projects/clabtoolkit/badge/?version=latest
|
|
74
|
+
:target: https://clabtoolkit.readthedocs.io/en/latest/?version=latest
|
|
75
|
+
:alt: Documentation Status
|
|
76
|
+
|
|
77
|
+
.. image:: https://img.shields.io/pypi/pyversions/clabtoolkit.svg
|
|
78
|
+
:target: https://pypi.python.org/pypi/clabtoolkit
|
|
79
|
+
|
|
80
|
+
.. image:: https://codecov.io/gh/connectomicslab/clabtoolkit/branch/main/graph/badge.svg
|
|
81
|
+
:target: https://codecov.io/gh/connectomicslab/clabtoolkit
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
A comprehensive Python toolkit for neuroimaging data processing and analysis, specifically designed for working with brain connectivity data, BIDS datasets, and various neuroimaging formats.
|
|
85
|
+
|
|
86
|
+
* **Free software**: Apache Software License 2.0
|
|
87
|
+
* **Documentation**: https://clabtoolkit.readthedocs.io
|
|
88
|
+
* **Source Code**: https://github.com/connectomicslab/clabtoolkit
|
|
89
|
+
* **Python versions**: 3.9+
|
|
90
|
+
|
|
91
|
+
Installation
|
|
92
|
+
------------
|
|
93
|
+
|
|
94
|
+
Install from PyPI::
|
|
95
|
+
|
|
96
|
+
pip install clabtoolkit
|
|
97
|
+
|
|
98
|
+
For development installation::
|
|
99
|
+
|
|
100
|
+
git clone https://github.com/connectomicslab/clabtoolkit.git
|
|
101
|
+
cd clabtoolkit
|
|
102
|
+
pip install -e .[dev]
|
|
103
|
+
|
|
104
|
+
Features
|
|
105
|
+
--------
|
|
106
|
+
|
|
107
|
+
**BIDS Tools** (``clabtoolkit.bidstools``)
|
|
108
|
+
* BIDS dataset validation and manipulation
|
|
109
|
+
* Entity extraction from BIDS filenames
|
|
110
|
+
* Conversion between BIDS formats
|
|
111
|
+
* Metadata handling for neuroimaging datasets
|
|
112
|
+
|
|
113
|
+
**Connectivity Tools** (``clabtoolkit.connectivitytools``)
|
|
114
|
+
* Brain connectivity matrix analysis
|
|
115
|
+
* Network-based statistics
|
|
116
|
+
* Graph theory metrics computation
|
|
117
|
+
* Connectivity visualization utilities
|
|
118
|
+
|
|
119
|
+
**FreeSurfer Tools** (``clabtoolkit.freesurfertools``)
|
|
120
|
+
* FreeSurfer output parsing and processing
|
|
121
|
+
* Surface-based analysis utilities
|
|
122
|
+
* Cortical thickness and morphometry tools
|
|
123
|
+
* Integration with FreeSurfer workflows
|
|
124
|
+
|
|
125
|
+
**Image Processing Tools** (``clabtoolkit.imagetools``)
|
|
126
|
+
* Neuroimaging data I/O operations
|
|
127
|
+
* Image registration and transformation
|
|
128
|
+
* Quality control and preprocessing utilities
|
|
129
|
+
* Multi-modal image processing
|
|
130
|
+
|
|
131
|
+
**Parcellation Tools** (``clabtoolkit.parcellationtools``)
|
|
132
|
+
* Brain parcellation scheme handling
|
|
133
|
+
* Region-of-interest (ROI) extraction
|
|
134
|
+
* Atlas-based analysis tools
|
|
135
|
+
* Custom parcellation creation
|
|
136
|
+
|
|
137
|
+
**Surface Tools** (``clabtoolkit.surfacetools``)
|
|
138
|
+
* Surface mesh processing and analysis
|
|
139
|
+
* Cortical surface manipulation
|
|
140
|
+
* Surface-based statistics
|
|
141
|
+
* Visualization of surface data
|
|
142
|
+
|
|
143
|
+
**DWI Tools** (``clabtoolkit.dwitools``)
|
|
144
|
+
* Diffusion-weighted imaging analysis
|
|
145
|
+
* Tractography processing utilities
|
|
146
|
+
* DTI and advanced diffusion modeling
|
|
147
|
+
* White matter analysis tools
|
|
148
|
+
|
|
149
|
+
**Quality Control Tools** (``clabtoolkit.qcqatools``)
|
|
150
|
+
* Automated quality assessment
|
|
151
|
+
* Image artifact detection
|
|
152
|
+
* Quality metrics computation
|
|
153
|
+
* Reporting and visualization
|
|
154
|
+
|
|
155
|
+
**Visualization Tools** (``clabtoolkit.visualizationtools``)
|
|
156
|
+
* Brain visualization utilities
|
|
157
|
+
* Interactive plotting capabilities
|
|
158
|
+
* Publication-ready figures
|
|
159
|
+
* Multi-modal data visualization
|
|
160
|
+
|
|
161
|
+
Quick Start
|
|
162
|
+
-----------
|
|
163
|
+
|
|
164
|
+
.. code-block:: python
|
|
165
|
+
|
|
166
|
+
import clabtoolkit.bidstools as bids
|
|
167
|
+
import clabtoolkit.connectivitytools as conn
|
|
168
|
+
|
|
169
|
+
# Load BIDS configuration
|
|
170
|
+
config = bids.load_bids_json()
|
|
171
|
+
|
|
172
|
+
# Extract entities from BIDS filename
|
|
173
|
+
entities = bids.str2entity("sub-01_ses-M00_T1w.nii.gz")
|
|
174
|
+
print(entities) # {'sub': '01', 'ses': 'M00', 'suffix': 'T1w', 'extension': 'nii.gz'}
|
|
175
|
+
|
|
176
|
+
# Process connectivity data
|
|
177
|
+
# conn_matrix = conn.load_connectivity_matrix("path/to/connectivity.mat")
|
|
178
|
+
|
|
179
|
+
Contributing
|
|
180
|
+
------------
|
|
181
|
+
|
|
182
|
+
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
|
|
183
|
+
|
|
184
|
+
1. Fork the repository
|
|
185
|
+
2. Create your feature branch (``git checkout -b feature/amazing-feature``)
|
|
186
|
+
3. Commit your changes (``git commit -m 'Add some amazing feature'``)
|
|
187
|
+
4. Push to the branch (``git push origin feature/amazing-feature``)
|
|
188
|
+
5. Open a Pull Request
|
|
189
|
+
|
|
190
|
+
Testing
|
|
191
|
+
-------
|
|
192
|
+
|
|
193
|
+
Run tests with::
|
|
194
|
+
|
|
195
|
+
pytest
|
|
196
|
+
|
|
197
|
+
Run tests with coverage::
|
|
198
|
+
|
|
199
|
+
pytest --cov=clabtoolkit
|
|
200
|
+
|
|
201
|
+
Changelog
|
|
202
|
+
---------
|
|
203
|
+
|
|
204
|
+
See `HISTORY.rst <HISTORY.rst>`_ for a detailed changelog.
|
|
205
|
+
|
|
206
|
+
Credits
|
|
207
|
+
-------
|
|
208
|
+
|
|
209
|
+
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
|
|
210
|
+
|
|
211
|
+
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
|
|
212
|
+
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
clabtoolkit/__init__.py,sha256=ZakJBM5wXefQWTCRFXFWBVSvku_mSMcHO8GOEJ1P3Fo,160
|
|
2
|
+
clabtoolkit/bidstools.py,sha256=7fbUVFQM4ITKy094kPrzOEVX10MsxAH0wycnyF0VPwE,79882
|
|
3
|
+
clabtoolkit/connectivitytools.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
4
|
+
clabtoolkit/dicomtools.py,sha256=00OG_Djgh_WO_VgOGWDackbqINOhoNV-YGXoWnJ0_NI,33772
|
|
5
|
+
clabtoolkit/dwitools.py,sha256=Fbw-mVav5-U0fuUmJU02jMqSeaM0xGsumOKqDXcl8Jc,75465
|
|
6
|
+
clabtoolkit/freesurfertools.py,sha256=wzZrUT3rVwofwiX8yb-zXaUpi8qvBFqqIkVf-WvGTGs,202674
|
|
7
|
+
clabtoolkit/imagetools.py,sha256=8N4zRcPTPo0oQrmbCOWIQw4cvDO6mKBR_Y_J6D_aV2I,94603
|
|
8
|
+
clabtoolkit/misctools.py,sha256=XWBFFkR0EB5QhiqCZE-FHWpEtJfc2U_S_w8eGhPDDak,181275
|
|
9
|
+
clabtoolkit/morphometrytools.py,sha256=FXsGNSAouBgLm32xvKCsiyW7DHd5CarjH2zwzAOZifk,117902
|
|
10
|
+
clabtoolkit/networktools.py,sha256=Py9eJUWZZbW0soEEBaESGxceYyqZxHzSv_loLQ8rtrM,12455
|
|
11
|
+
clabtoolkit/parcellationtools.py,sha256=ogZKDnqhJ8IpIeV7wI2NRdF0-uMB6BcR1Jgsz_qDY1w,117071
|
|
12
|
+
clabtoolkit/pipelinetools.py,sha256=XWbrbhpz0xf_5t-KdMI0P_iLHjV9bZBZXJirRplatEU,43135
|
|
13
|
+
clabtoolkit/plottools.py,sha256=ZVMrhYHOjKnMvd-x7x8NwfupfG-7961PqdijERjYmmU,23054
|
|
14
|
+
clabtoolkit/qcqatools.py,sha256=eQ8xtC1I8Lg8ddWGEj8HIEcEell4MbHMWkqAj8-C9QE,43631
|
|
15
|
+
clabtoolkit/segmentationtools.py,sha256=yjFMygzNQs3SMWe88fjFiP060KIg_wbZj9N9qLgF5yA,11952
|
|
16
|
+
clabtoolkit/surfacetools.py,sha256=8FWMQqCSNhnBd0Br-8wkyeVNZRcnXrAlFHpiQFbM-eU,104113
|
|
17
|
+
clabtoolkit/visualizationtools.py,sha256=X6lGknfD_iQ73vixgYH630-EO8URZyfhYwQqv07lT1I,221468
|
|
18
|
+
clabtoolkit/config/bids.json,sha256=speSXS4vYhNebpZMOGi6EcP2XVEaYFUc0DQfMjR6rsc,4993
|
|
19
|
+
clabtoolkit/config/config.json,sha256=WJceIvMtjjqNUO9ErdSsI58EzL70NdTPOFxEdX_9MZE,1553
|
|
20
|
+
clabtoolkit/config/lobes.json,sha256=MET74iQOLiHeUqWfRzCG5pokRWlYD4D6xmcOuQBAHzI,3298
|
|
21
|
+
clabtoolkit/config/stats_mapping.json,sha256=aBcPaHFHiYBBkyEqJtlEeD2tKYaLz0X6r7HFtqq3jY8,3560
|
|
22
|
+
clabtoolkit/config/viz_views.json,sha256=HBYoEYmATqWlSTyyjrflGsXGlt31f1HTnw1kD7r9cJs,9315
|
|
23
|
+
clabtoolkit-0.3.3.dist-info/licenses/AUTHORS.rst,sha256=fpjTswxi0TRnuhObNlfskakOe_LFaV3e8gTKwMKxj-E,174
|
|
24
|
+
clabtoolkit-0.3.3.dist-info/licenses/LICENSE,sha256=_3fydWOdl2KwgpBhwxA9fEM_OSAx7tqscFfI2CFQNN4,593
|
|
25
|
+
clabtoolkit-0.3.3.dist-info/METADATA,sha256=MsxPfepsRaBHDBoeY6ZY7DW78UguHB_PsK_muXk4TB0,7372
|
|
26
|
+
clabtoolkit-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
27
|
+
clabtoolkit-0.3.3.dist-info/top_level.txt,sha256=IRupDQtUtkWaqYEB8cXB3UhWTa2EYcWoIEARPnGjY9k,12
|
|
28
|
+
clabtoolkit-0.3.3.dist-info/RECORD,,
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
Apache Software License 2.0
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024, Yasser Alemán-Gómez
|
|
4
|
+
|
|
5
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
you may not use this file except in compliance with the License.
|
|
7
|
+
You may obtain a copy of the License at
|
|
8
|
+
|
|
9
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
|
|
11
|
+
Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
See the License for the specific language governing permissions and
|
|
15
|
+
limitations under the License.
|
|
16
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
clabtoolkit
|