dmri-commit 2.0.1__tar.gz → 2.1.0__tar.gz
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.
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/LICENSE +79 -79
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/MANIFEST.in +6 -6
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/PKG-INFO +28 -28
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/README.md +48 -48
- dmri-commit-2.1.0/build/dmri_commit.egg-info/PKG-INFO +28 -0
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/build/dmri_commit.egg-info/SOURCES.txt +7 -1
- dmri-commit-2.1.0/build/dmri_commit.egg-info/dependency_links.txt +1 -0
- dmri-commit-2.1.0/build/dmri_commit.egg-info/requires.txt +7 -0
- dmri-commit-2.1.0/build/dmri_commit.egg-info/top_level.txt +1 -0
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/__init__.py +2 -2
- dmri-commit-2.1.0/commit/core.cpp +56282 -0
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/core.pyx +1374 -1157
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/info.py +32 -32
- dmri-commit-2.1.0/commit/models.py +98 -0
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/operator/__init__.py +0 -0
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/operator/config.py +6 -6
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/operator/operator.pyx +192 -191
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/operator/operator.pyxbld +39 -39
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/operator/operator_noLUT.c +187 -187
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/operator/operator_withLUT.c +2247 -2247
- dmri-commit-2.1.0/commit/proximals.pyx +198 -0
- dmri-commit-2.1.0/commit/solvers.py +364 -0
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/trk2dictionary/ProgressBar.h +86 -86
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/trk2dictionary/Vector.h +99 -99
- dmri-commit-2.1.0/commit/trk2dictionary/trk2dictionary.cpp +33264 -0
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/trk2dictionary/trk2dictionary.pyx +620 -598
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/commit/trk2dictionary/trk2dictionary_c.cpp +918 -853
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/setup.cfg +12 -12
- {dmri-commit-2.0.1 → dmri-commit-2.1.0}/setup.py +74 -73
- dmri-commit-2.0.1/commit/models.py +0 -32
- dmri-commit-2.0.1/commit/proximals.pyx +0 -141
- dmri-commit-2.0.1/commit/solvers.py +0 -443
|
@@ -1,79 +1,79 @@
|
|
|
1
|
-
################################################################################
|
|
2
|
-
COMMIT software license agreement
|
|
3
|
-
Version 2, 24 July 2023
|
|
4
|
-
################################################################################
|
|
5
|
-
|
|
6
|
-
------------------------------------PREAMBLE------------------------------------
|
|
7
|
-
This license agreement (“Agreement”) is a legal agreement between you and the
|
|
8
|
-
Diffusion Imaging and Connectivity Estimation laboratory (“DICE lab”) for the
|
|
9
|
-
use of the COMMIT software (“Software”). By downloading and/or using the
|
|
10
|
-
Software, you hereby accept and agree to all the terms and conditions of this
|
|
11
|
-
Agreement. As used in this Agreement, “you” refers to any individual or
|
|
12
|
-
organization that uses the Software.
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
------------------------------TERMS AND CONDITIONS------------------------------
|
|
16
|
-
[1] License Grant
|
|
17
|
-
Subject to all the terms and conditions of this Agreement, the DICE lab hereby
|
|
18
|
-
grants you a worldwide, non-exclusive, non-transferable, limited license to
|
|
19
|
-
copy, use, modify, and redistribute the Software solely for research and
|
|
20
|
-
educational purposes, free of charge.
|
|
21
|
-
|
|
22
|
-
[2] Commercial use
|
|
23
|
-
You may not use the Software and/or any work based on or using the Software for
|
|
24
|
-
any commercial purpose, including but not limited to selling, licensing,
|
|
25
|
-
distributing, renting, or leasing the Software for profit. If you want to use
|
|
26
|
-
the Software for commercial purposes, you may contact the DICE lab to obtain a
|
|
27
|
-
commercial license agreement. The DICE lab may consider offering a commercial
|
|
28
|
-
license, subject to negotiation of appropriate terms and conditions, including
|
|
29
|
-
but not limited to the payment of a license fee and compliance with any
|
|
30
|
-
additional restriction on the use of the Software.
|
|
31
|
-
|
|
32
|
-
[3] Attributions and Acknowledgments
|
|
33
|
-
You agree to provide an acknowledgement identifying the Software and referencing
|
|
34
|
-
its use in any publication, presentation, research result, and product related
|
|
35
|
-
to or arising from the use of the Software. You also agree to give proper
|
|
36
|
-
attribution to the original Software and reproduce this Agreement in any
|
|
37
|
-
modified and/or redistributed work based on the Software.
|
|
38
|
-
|
|
39
|
-
[4] Patents
|
|
40
|
-
If you plan to file a patent application based on or using the Software, you
|
|
41
|
-
must contact the DICE lab. The DICE lab may have certain rights or restrictions
|
|
42
|
-
related to such patents that need to be addressed before filing the application.
|
|
43
|
-
|
|
44
|
-
[5] Compliance with Law
|
|
45
|
-
In exercising your rights under this Agreement, you agree to comply with all
|
|
46
|
-
applicable governmental laws and regulations, including but not limited to the
|
|
47
|
-
use, export, and transmission of the Software. You are solely responsible for
|
|
48
|
-
ensuring that your use of the Software complies with such laws and regulations.
|
|
49
|
-
The DICE lab is not responsible for any violations of such laws or regulations
|
|
50
|
-
by you.
|
|
51
|
-
|
|
52
|
-
[6] Warranty
|
|
53
|
-
The Software is provided "AS IS" without warranty of any kind, express or
|
|
54
|
-
implied, including but not limited to the warranties of merchantability, fitness
|
|
55
|
-
for a particular purpose and non-infringement of third-party rights. The
|
|
56
|
-
Software may also contain errors and is subject to further development and
|
|
57
|
-
revision. The DICE lab does not guarantee the accuracy of the Software or any
|
|
58
|
-
result or data arising from the use of the Software.
|
|
59
|
-
|
|
60
|
-
[7] Disclaimers
|
|
61
|
-
The Software has been designed for research purposes only and has not been
|
|
62
|
-
reviewed or approved by the Food and Drug Administration or by any other agency.
|
|
63
|
-
You acknowledge and agree that clinical applications are neither recommended nor
|
|
64
|
-
advised.
|
|
65
|
-
|
|
66
|
-
[8] Limitation of Liability
|
|
67
|
-
In no event shall the DICE lab be liable to any party for any direct, indirect,
|
|
68
|
-
special, incidental, exemplary, or consequential damages, however caused and
|
|
69
|
-
under any theory of liability, arising in any way related to the Software, even
|
|
70
|
-
if the DICE lab has been advised of the possibility of such damages. Except to
|
|
71
|
-
the extent prohibited by law or regulation, you assume all risk and liability
|
|
72
|
-
for your use of the Software. You also agree to indemnify and hold harmless the
|
|
73
|
-
DICE lab from and against all claims, suits, actions, demands, and judgments
|
|
74
|
-
arising from your use or misuse of the Software.
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
------------------------------------CONTACT-------------------------------------
|
|
78
|
-
If you have any question about the terms of this Agreement, you may contact the
|
|
79
|
-
head of the DICE lab Alessandro Daducci at alessandro.daducci@univr.it
|
|
1
|
+
################################################################################
|
|
2
|
+
COMMIT software license agreement
|
|
3
|
+
Version 2, 24 July 2023
|
|
4
|
+
################################################################################
|
|
5
|
+
|
|
6
|
+
------------------------------------PREAMBLE------------------------------------
|
|
7
|
+
This license agreement (“Agreement”) is a legal agreement between you and the
|
|
8
|
+
Diffusion Imaging and Connectivity Estimation laboratory (“DICE lab”) for the
|
|
9
|
+
use of the COMMIT software (“Software”). By downloading and/or using the
|
|
10
|
+
Software, you hereby accept and agree to all the terms and conditions of this
|
|
11
|
+
Agreement. As used in this Agreement, “you” refers to any individual or
|
|
12
|
+
organization that uses the Software.
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
------------------------------TERMS AND CONDITIONS------------------------------
|
|
16
|
+
[1] License Grant
|
|
17
|
+
Subject to all the terms and conditions of this Agreement, the DICE lab hereby
|
|
18
|
+
grants you a worldwide, non-exclusive, non-transferable, limited license to
|
|
19
|
+
copy, use, modify, and redistribute the Software solely for research and
|
|
20
|
+
educational purposes, free of charge.
|
|
21
|
+
|
|
22
|
+
[2] Commercial use
|
|
23
|
+
You may not use the Software and/or any work based on or using the Software for
|
|
24
|
+
any commercial purpose, including but not limited to selling, licensing,
|
|
25
|
+
distributing, renting, or leasing the Software for profit. If you want to use
|
|
26
|
+
the Software for commercial purposes, you may contact the DICE lab to obtain a
|
|
27
|
+
commercial license agreement. The DICE lab may consider offering a commercial
|
|
28
|
+
license, subject to negotiation of appropriate terms and conditions, including
|
|
29
|
+
but not limited to the payment of a license fee and compliance with any
|
|
30
|
+
additional restriction on the use of the Software.
|
|
31
|
+
|
|
32
|
+
[3] Attributions and Acknowledgments
|
|
33
|
+
You agree to provide an acknowledgement identifying the Software and referencing
|
|
34
|
+
its use in any publication, presentation, research result, and product related
|
|
35
|
+
to or arising from the use of the Software. You also agree to give proper
|
|
36
|
+
attribution to the original Software and reproduce this Agreement in any
|
|
37
|
+
modified and/or redistributed work based on the Software.
|
|
38
|
+
|
|
39
|
+
[4] Patents
|
|
40
|
+
If you plan to file a patent application based on or using the Software, you
|
|
41
|
+
must contact the DICE lab. The DICE lab may have certain rights or restrictions
|
|
42
|
+
related to such patents that need to be addressed before filing the application.
|
|
43
|
+
|
|
44
|
+
[5] Compliance with Law
|
|
45
|
+
In exercising your rights under this Agreement, you agree to comply with all
|
|
46
|
+
applicable governmental laws and regulations, including but not limited to the
|
|
47
|
+
use, export, and transmission of the Software. You are solely responsible for
|
|
48
|
+
ensuring that your use of the Software complies with such laws and regulations.
|
|
49
|
+
The DICE lab is not responsible for any violations of such laws or regulations
|
|
50
|
+
by you.
|
|
51
|
+
|
|
52
|
+
[6] Warranty
|
|
53
|
+
The Software is provided "AS IS" without warranty of any kind, express or
|
|
54
|
+
implied, including but not limited to the warranties of merchantability, fitness
|
|
55
|
+
for a particular purpose and non-infringement of third-party rights. The
|
|
56
|
+
Software may also contain errors and is subject to further development and
|
|
57
|
+
revision. The DICE lab does not guarantee the accuracy of the Software or any
|
|
58
|
+
result or data arising from the use of the Software.
|
|
59
|
+
|
|
60
|
+
[7] Disclaimers
|
|
61
|
+
The Software has been designed for research purposes only and has not been
|
|
62
|
+
reviewed or approved by the Food and Drug Administration or by any other agency.
|
|
63
|
+
You acknowledge and agree that clinical applications are neither recommended nor
|
|
64
|
+
advised.
|
|
65
|
+
|
|
66
|
+
[8] Limitation of Liability
|
|
67
|
+
In no event shall the DICE lab be liable to any party for any direct, indirect,
|
|
68
|
+
special, incidental, exemplary, or consequential damages, however caused and
|
|
69
|
+
under any theory of liability, arising in any way related to the Software, even
|
|
70
|
+
if the DICE lab has been advised of the possibility of such damages. Except to
|
|
71
|
+
the extent prohibited by law or regulation, you assume all risk and liability
|
|
72
|
+
for your use of the Software. You also agree to indemnify and hold harmless the
|
|
73
|
+
DICE lab from and against all claims, suits, actions, demands, and judgments
|
|
74
|
+
arising from your use or misuse of the Software.
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
------------------------------------CONTACT-------------------------------------
|
|
78
|
+
If you have any question about the terms of this Agreement, you may contact the
|
|
79
|
+
head of the DICE lab Alessandro Daducci at alessandro.daducci@univr.it
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
include README.md
|
|
2
|
-
include LICENSE
|
|
3
|
-
|
|
4
|
-
recursive-include commit *.h
|
|
5
|
-
recursive-include commit *.cpp
|
|
6
|
-
recursive-include commit *.pyx
|
|
1
|
+
include README.md
|
|
2
|
+
include LICENSE
|
|
3
|
+
|
|
4
|
+
recursive-include commit *.h
|
|
5
|
+
recursive-include commit *.cpp
|
|
6
|
+
recursive-include commit *.pyx
|
|
7
7
|
recursive-include commit *.c
|
|
@@ -1,28 +1,28 @@
|
|
|
1
|
-
Metadata-Version: 2.1
|
|
2
|
-
Name: dmri-commit
|
|
3
|
-
Version: 2.0
|
|
4
|
-
Summary: Convex Optimization Modeling for Microstructure Informed Tractography (COMMIT)
|
|
5
|
-
Home-page: https://github.com/daducci/COMMIT
|
|
6
|
-
Author: Alessandro Daducci
|
|
7
|
-
Author-email: alessandro.daducci@univr.it
|
|
8
|
-
License: Proprietary license
|
|
9
|
-
License-File: LICENSE
|
|
10
|
-
Requires-Dist: setuptools>=46.1
|
|
11
|
-
Requires-Dist: Cython>=0.29
|
|
12
|
-
Requires-Dist: numpy>=1.12
|
|
13
|
-
Requires-Dist: scipy>=1.0
|
|
14
|
-
Requires-Dist: dipy>=1.0
|
|
15
|
-
Requires-Dist: dmri-dicelib
|
|
16
|
-
Requires-Dist: dmri-amico>=2.0.1
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
========
|
|
20
|
-
COMMIT
|
|
21
|
-
========
|
|
22
|
-
|
|
23
|
-
The reconstructions recovered with existing tractography algorithms are not really quantitative even though diffusion MRI is a quantitative modality by nature. As a matter of fact, several techniques have been proposed in recent years to estimate, at the voxel level, intrinsic micro-structural features of the tissue, such as axonal density and diameter, by using multi-compartment models.
|
|
24
|
-
Convex Optimization Modeling for Microstructure Informed Tractography (COMMIT) implements a novel framework to re-establish the link between tractography and tissue micro-structure.
|
|
25
|
-
|
|
26
|
-
Starting from an input set of candidate fiber-tracts, which can be estimated using standard fiber-tracking techniques, COMMIT models the diffusion MRI signal in each voxel of the image as a linear combination of the restricted and hindered contributions generated in every location of the brain by these candidate tracts. Then, COMMIT seeks for the effective contribution of each of them such that they globally fit the measured signal at best.
|
|
27
|
-
|
|
28
|
-
These weights can be easily estimated by solving a convenient global convex optimization problem and using efficient algorithms. Results clearly demonstrated the benefits of the proposed formulation, opening new perspectives for a more quantitative and biologically-plausible assessment of the structural connectivity in the brain.
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: dmri-commit
|
|
3
|
+
Version: 2.1.0
|
|
4
|
+
Summary: Convex Optimization Modeling for Microstructure Informed Tractography (COMMIT)
|
|
5
|
+
Home-page: https://github.com/daducci/COMMIT
|
|
6
|
+
Author: Alessandro Daducci
|
|
7
|
+
Author-email: alessandro.daducci@univr.it
|
|
8
|
+
License: Proprietary license
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Requires-Dist: setuptools>=46.1
|
|
11
|
+
Requires-Dist: Cython>=0.29
|
|
12
|
+
Requires-Dist: numpy>=1.12
|
|
13
|
+
Requires-Dist: scipy>=1.0
|
|
14
|
+
Requires-Dist: dipy>=1.0
|
|
15
|
+
Requires-Dist: dmri-dicelib>=1.0.3
|
|
16
|
+
Requires-Dist: dmri-amico>=2.0.1
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
========
|
|
20
|
+
COMMIT
|
|
21
|
+
========
|
|
22
|
+
|
|
23
|
+
The reconstructions recovered with existing tractography algorithms are not really quantitative even though diffusion MRI is a quantitative modality by nature. As a matter of fact, several techniques have been proposed in recent years to estimate, at the voxel level, intrinsic micro-structural features of the tissue, such as axonal density and diameter, by using multi-compartment models.
|
|
24
|
+
Convex Optimization Modeling for Microstructure Informed Tractography (COMMIT) implements a novel framework to re-establish the link between tractography and tissue micro-structure.
|
|
25
|
+
|
|
26
|
+
Starting from an input set of candidate fiber-tracts, which can be estimated using standard fiber-tracking techniques, COMMIT models the diffusion MRI signal in each voxel of the image as a linear combination of the restricted and hindered contributions generated in every location of the brain by these candidate tracts. Then, COMMIT seeks for the effective contribution of each of them such that they globally fit the measured signal at best.
|
|
27
|
+
|
|
28
|
+
These weights can be easily estimated by solving a convenient global convex optimization problem and using efficient algorithms. Results clearly demonstrated the benefits of the proposed formulation, opening new perspectives for a more quantitative and biologically-plausible assessment of the structural connectivity in the brain.
|
|
@@ -1,48 +1,48 @@
|
|
|
1
|
-
[](https://pypi.org/project/dmri-commit/)
|
|
2
|
-
[](#)
|
|
3
|
-
[](https://github.com/daducci/COMMIT/blob/master/LICENSE)
|
|
4
|
-
[](#)
|
|
5
|
-
[](https://ieeexplore.ieee.org/document/6884830)
|
|
6
|
-
|
|
7
|
-
[](#)
|
|
8
|
-
[](#)
|
|
9
|
-
[](#)
|
|
10
|
-
[](#)
|
|
11
|
-
[](#)
|
|
12
|
-
[](https://twitter.com/intent/follow?screen_name=ADaducci)
|
|
13
|
-
|
|
14
|
-
# COMMIT
|
|
15
|
-
|
|
16
|
-
The reconstructions recovered with existing tractography algorithms are not really quantitative even though diffusion MRI is a quantitative modality. COMMIT stands for *Convex Optimization for Microstructure Informed Tractography* and is a **powerful framework for enhancing the anatomical accuracy of the reconstructions** by combining tractography with microstructural features of the neuronal tissue.
|
|
17
|
-
|
|
18
|
-
<img align="right" src="https://github.com/daducci/COMMIT/wiki/images/filtering_methods.png" height="225">
|
|
19
|
-
|
|
20
|
-
**How?** Starting from an input set of candidate fiber-tracts estimated using standard fiber-tracking techniques, COMMIT models the diffusion MRI signal in each voxel of the image as a *linear combination* of the restricted and hindered contributions generated in every location of the brain by these candidate tracts. Then, COMMIT seeks for the effective contribution of each of them such that they globally fit the measured signal at best.
|
|
21
|
-
These weights can be *efficiently estimated by solving a convenient linear system*.
|
|
22
|
-
|
|
23
|
-
Results clearly demonstrated the benefits of the proposed formulation, opening new perspectives for a more quantitative and biologically-plausible assessment of the structural connectivity of the brain. See the [references](https://github.com/daducci/COMMIT/wiki/References) for more information.
|
|
24
|
-
|
|
25
|
-
<p align="center">
|
|
26
|
-
<img src="https://github.com/daducci/COMMIT/wiki/images/COMMIT_example.png" height="450">
|
|
27
|
-
</p>
|
|
28
|
-
|
|
29
|
-
## Main features
|
|
30
|
-
|
|
31
|
-
- Very efficient: COMMIT is implemented in Python but the core of the algorithm is implemented in C++ and using **multi-thread programming** for efficient parallel computation.
|
|
32
|
-
- Accepts and works with **any input tractogram** (i.e. set of fiber tracts).
|
|
33
|
-
- Can easily implement and consider **any multi-compartment model** available in the literature: possibility to account for restricted, hindered as well as isotropic contributions into the signal forward model.
|
|
34
|
-
- **Low memory** consumption using optimized sparse data structures, e.g. it can easily run on a standard laptop with 8GB RAM a full-brain tractogram from the HCP data (1M fibers, 3 shells, 1.25 mm^3 resolution).
|
|
35
|
-
- **Soon**: **GPU implementation** for even faster model fitting.
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
## Documentation
|
|
39
|
-
|
|
40
|
-
More information/documentation, as well as a series of tutorials, can be found in the [wiki pages](https://github.com/daducci/COMMIT/wiki/Home).
|
|
41
|
-
|
|
42
|
-
### Installation
|
|
43
|
-
To install COMMIT, refer to the [installation guide](https://github.com/daducci/COMMIT/wiki/Installation).
|
|
44
|
-
|
|
45
|
-
### Getting started
|
|
46
|
-
|
|
47
|
-
To get started with the COMMIT framework, have a look at [this tutorial](https://github.com/daducci/COMMIT/wiki/Getting-started), which will guide you through the main steps of the processing.
|
|
48
|
-
|
|
1
|
+
[](https://pypi.org/project/dmri-commit/)
|
|
2
|
+
[](#)
|
|
3
|
+
[](https://github.com/daducci/COMMIT/blob/master/LICENSE)
|
|
4
|
+
[](#)
|
|
5
|
+
[](https://ieeexplore.ieee.org/document/6884830)
|
|
6
|
+
|
|
7
|
+
[](#)
|
|
8
|
+
[](#)
|
|
9
|
+
[](#)
|
|
10
|
+
[](#)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://twitter.com/intent/follow?screen_name=ADaducci)
|
|
13
|
+
|
|
14
|
+
# COMMIT
|
|
15
|
+
|
|
16
|
+
The reconstructions recovered with existing tractography algorithms are not really quantitative even though diffusion MRI is a quantitative modality. COMMIT stands for *Convex Optimization for Microstructure Informed Tractography* and is a **powerful framework for enhancing the anatomical accuracy of the reconstructions** by combining tractography with microstructural features of the neuronal tissue.
|
|
17
|
+
|
|
18
|
+
<img align="right" src="https://github.com/daducci/COMMIT/wiki/images/filtering_methods.png" height="225">
|
|
19
|
+
|
|
20
|
+
**How?** Starting from an input set of candidate fiber-tracts estimated using standard fiber-tracking techniques, COMMIT models the diffusion MRI signal in each voxel of the image as a *linear combination* of the restricted and hindered contributions generated in every location of the brain by these candidate tracts. Then, COMMIT seeks for the effective contribution of each of them such that they globally fit the measured signal at best.
|
|
21
|
+
These weights can be *efficiently estimated by solving a convenient linear system*.
|
|
22
|
+
|
|
23
|
+
Results clearly demonstrated the benefits of the proposed formulation, opening new perspectives for a more quantitative and biologically-plausible assessment of the structural connectivity of the brain. See the [references](https://github.com/daducci/COMMIT/wiki/References) for more information.
|
|
24
|
+
|
|
25
|
+
<p align="center">
|
|
26
|
+
<img src="https://github.com/daducci/COMMIT/wiki/images/COMMIT_example.png" height="450">
|
|
27
|
+
</p>
|
|
28
|
+
|
|
29
|
+
## Main features
|
|
30
|
+
|
|
31
|
+
- Very efficient: COMMIT is implemented in Python but the core of the algorithm is implemented in C++ and using **multi-thread programming** for efficient parallel computation.
|
|
32
|
+
- Accepts and works with **any input tractogram** (i.e. set of fiber tracts).
|
|
33
|
+
- Can easily implement and consider **any multi-compartment model** available in the literature: possibility to account for restricted, hindered as well as isotropic contributions into the signal forward model.
|
|
34
|
+
- **Low memory** consumption using optimized sparse data structures, e.g. it can easily run on a standard laptop with 8GB RAM a full-brain tractogram from the HCP data (1M fibers, 3 shells, 1.25 mm^3 resolution).
|
|
35
|
+
- **Soon**: **GPU implementation** for even faster model fitting.
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
## Documentation
|
|
39
|
+
|
|
40
|
+
More information/documentation, as well as a series of tutorials, can be found in the [wiki pages](https://github.com/daducci/COMMIT/wiki/Home).
|
|
41
|
+
|
|
42
|
+
### Installation
|
|
43
|
+
To install COMMIT, refer to the [installation guide](https://github.com/daducci/COMMIT/wiki/Installation).
|
|
44
|
+
|
|
45
|
+
### Getting started
|
|
46
|
+
|
|
47
|
+
To get started with the COMMIT framework, have a look at [this tutorial](https://github.com/daducci/COMMIT/wiki/Getting-started), which will guide you through the main steps of the processing.
|
|
48
|
+
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: dmri-commit
|
|
3
|
+
Version: 2.1.0
|
|
4
|
+
Summary: Convex Optimization Modeling for Microstructure Informed Tractography (COMMIT)
|
|
5
|
+
Home-page: https://github.com/daducci/COMMIT
|
|
6
|
+
Author: Alessandro Daducci
|
|
7
|
+
Author-email: alessandro.daducci@univr.it
|
|
8
|
+
License: Proprietary license
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Requires-Dist: setuptools>=46.1
|
|
11
|
+
Requires-Dist: Cython>=0.29
|
|
12
|
+
Requires-Dist: numpy>=1.12
|
|
13
|
+
Requires-Dist: scipy>=1.0
|
|
14
|
+
Requires-Dist: dipy>=1.0
|
|
15
|
+
Requires-Dist: dmri-dicelib>=1.0.3
|
|
16
|
+
Requires-Dist: dmri-amico>=2.0.1
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
========
|
|
20
|
+
COMMIT
|
|
21
|
+
========
|
|
22
|
+
|
|
23
|
+
The reconstructions recovered with existing tractography algorithms are not really quantitative even though diffusion MRI is a quantitative modality by nature. As a matter of fact, several techniques have been proposed in recent years to estimate, at the voxel level, intrinsic micro-structural features of the tissue, such as axonal density and diameter, by using multi-compartment models.
|
|
24
|
+
Convex Optimization Modeling for Microstructure Informed Tractography (COMMIT) implements a novel framework to re-establish the link between tractography and tissue micro-structure.
|
|
25
|
+
|
|
26
|
+
Starting from an input set of candidate fiber-tracts, which can be estimated using standard fiber-tracking techniques, COMMIT models the diffusion MRI signal in each voxel of the image as a linear combination of the restricted and hindered contributions generated in every location of the brain by these candidate tracts. Then, COMMIT seeks for the effective contribution of each of them such that they globally fit the measured signal at best.
|
|
27
|
+
|
|
28
|
+
These weights can be easily estimated by solving a convenient global convex optimization problem and using efficient algorithms. Results clearly demonstrated the benefits of the proposed formulation, opening new perspectives for a more quantitative and biologically-plausible assessment of the structural connectivity in the brain.
|
|
@@ -3,13 +3,18 @@ MANIFEST.in
|
|
|
3
3
|
README.md
|
|
4
4
|
setup.cfg
|
|
5
5
|
setup.py
|
|
6
|
+
./build/dmri_commit.egg-info/PKG-INFO
|
|
7
|
+
./build/dmri_commit.egg-info/SOURCES.txt
|
|
8
|
+
./build/dmri_commit.egg-info/dependency_links.txt
|
|
9
|
+
./build/dmri_commit.egg-info/requires.txt
|
|
10
|
+
./build/dmri_commit.egg-info/top_level.txt
|
|
6
11
|
commit/__init__.py
|
|
12
|
+
commit/core.cpp
|
|
7
13
|
commit/core.pyx
|
|
8
14
|
commit/info.py
|
|
9
15
|
commit/models.py
|
|
10
16
|
commit/proximals.pyx
|
|
11
17
|
commit/solvers.py
|
|
12
|
-
commit/trk2dictionary/trk2dictionary.pyx
|
|
13
18
|
commit/operator/__init__.py
|
|
14
19
|
commit/operator/config.py
|
|
15
20
|
commit/operator/operator.pyx
|
|
@@ -18,5 +23,6 @@ commit/operator/operator_noLUT.c
|
|
|
18
23
|
commit/operator/operator_withLUT.c
|
|
19
24
|
commit/trk2dictionary/ProgressBar.h
|
|
20
25
|
commit/trk2dictionary/Vector.h
|
|
26
|
+
commit/trk2dictionary/trk2dictionary.cpp
|
|
21
27
|
commit/trk2dictionary/trk2dictionary.pyx
|
|
22
28
|
commit/trk2dictionary/trk2dictionary_c.cpp
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
commit
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
__all__ = ['core','models','solvers','trk2dictionary']
|
|
2
|
-
from .info import __version__
|
|
1
|
+
__all__ = ['core','models','solvers','trk2dictionary']
|
|
2
|
+
from .info import __version__
|
|
3
3
|
from .core import Evaluation, setup
|