{ "info": { "author": "Olivier Morelle", "author_email": "morelle@uni-bonn.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Natural Language :: English", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering" ], "description": "=======\nbonndit\n=======\n\n\n.. image:: https://img.shields.io/pypi/v/bonndit.svg\n :target: https://pypi.python.org/pypi/bonndit\n\n.. image:: https://travis-ci.com/MedVisBonn/bonndit.svg?token=FqhWHkwE6EPeAZDNegqx&branch=master\n :target: https://travis-ci.com/MedVisBonn/bonndit\n\n.. image:: https://readthedocs.org/projects/bonndit/badge/?version=latest\n :target: https://bonndit.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n\nThe bonndit package contains the latest diffusion imaging tools developed at the University of Bonn. This early release focuses on our framework for single and multi tissue deconvolution using constrained higher-order tensor fODFs. In addition, it includes code for fitting the Diffusional Kurtosis (DKI) model. More will follow as time permits.\n\n\n* Free software: GNU General Public License v3\n* Documentation: https://bonndit.readthedocs.io.\n\nInstallation\n------------\nTo install bonndit, run the following command\n\n.. code-block:: console\n\n $ pip install bonndit\n\nFeatures\n--------\n* :code:`stdeconv`: Script to calculate white matter response function and fiber orientation distribution functions (fODFs) from a single shell diffusion signal.\n* :code:`mtdeconv`: Script to calculate multi tissue response functions and fiber orientation distribution functions (fODFs) from multi shell or DSI signals.\n* :code:`kurtosis`: Script to fit a kurtosis model using quadratic cone programming to guarantee a minimum diffusivity. It also calculates kurtosis measures based on the fitted model.\n* All functionality implemented in an object oriented manner.\n* Multiprocessing support implemented in the underlying infrastructure for faster computations\n* Logs written to your output directory\n\n\nGetting Started\n---------------\nFor calculating the multi-tissue response functions and the fODFs for given data run the following command:\n\n.. code-block:: console\n\n $ mtdeconv -i /path/to/your/data --verbose True\n\nThe specified folder should contain the following files:\n\n* :code:`bvecs`: b-vectors\n* :code:`bvals`: b-values\n* :code:`data.nii.gz`: The diffusion weighted data\n* :code:`dti_FA.nii.gz`: Diffusion tensor Fractional Anisotropy map\n* :code:`fast_pve_0.nii.gz`: CSF mask\n* :code:`fast_pve_1.nii.gz`: GM mask\n* :code:`fast_pve_2.nii.gz`: WM mask\n* :code:`dti_V1.nii.gz`: The first eigenvector of the diffusion tensor\n\nThe :code:`dti_*` files can be generated using FSL's :code:`dtifit`. The :code:`fast_*` files can be generated from coregistered T1 weighted images using FSL's :code:`fast`.\n\nOptional, but recommended to greatly speed up computation:\n\n* :code:`mask.nii.gz`: Binary mask, specifying brain voxels in which to estimate the model\n\n\nIf you want to see a list of parameters type the following:\n\n.. code-block:: console\n\n $ mtdeconv -h\n\nReference\n----------\n\nIf you use our software as part of a scientific project, please cite the corresponding publications. The method implemented in :code:`stdeconv` and :code:`mtdeconv` was first introduced in\n\n* Michael Ankele, Lek-Heng Lim, Samuel Groeschel, Thomas Schultz: Fast and Accurate Multi-Tissue Deconvolution Using SHORE and H-psd Tensors. In: Proc. Medical Image Analysis and Computer-Aided Intervention (MICCAI) Part III, pp. 502-510, vol. 9902 of LNCS, Springer, 2016\n\nIt was refined and extended in\n\n* Michael Ankele, Lek-Heng Lim, Samuel Groeschel, Thomas Schultz: Versatile, Robust, and Efficient Tractography With Constrained Higher-Order Tensor fODFs. In: Int'l J. of Computer Assisted Radiology and Surgery, 12(8):1257-1270, 2017\n\nThe use of quadratic cone programming to make the kurtosis fit more stable which is implemented in :code:`kurtosis` has been explained in the methods section of\n\n* Samuel Groeschel, G. E. Hagberg, T. Schultz, D. Z. Balla, U. Klose, T.-K. Hauser, T. N\u00e4gele, O. Bieri, T. Prasloski, A. MacKay, I. Kr\u00e4geloh-Mann, K. Scheffler: Assessing white matter microstructure in brain regions with different myelin architecture using MRI. In: PLOS ONE 11(11):e0167274, 2016\n\nPDFs can be obtained from the respective publisher, or the academic homepage of Thomas Schultz: http://cg.cs.uni-bonn.de/en/people/prof-dr-thomas-schultz/\n\nAuthors\n-------\n\n* **Michael Ankele** - *Initial work* - [momentarylapse] (https://github.com/momentarylapse)\n\n* **Thomas Schultz** - *Initial work* - [ThomasSchultz] (https://github.com/ThomasSchultz)\n\n* **Olivier Morelle** - *Code curation, documentation and test* [Oli4] (https://github.com/Oli4)\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n\n\n=======\nHistory\n=======\n\n0.1.2 (2019-02-06)\n-------------------\n\n* 'mtdeconv': If response is available, files needed for the computation of the response are not loaded.\n\n0.1.1 (2019-02-06)\n------------------\n\n* First release on PyPI.\n\n0.1.0 (2019-02-06)\n------------------\n\n* Making repository public on Github\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/MedVisBonn/bonndit", "keywords": "bonndit", "license": "GNU General Public License v3", "maintainer": "", "maintainer_email": "", "name": "bonndit", "package_url": "https://pypi.org/project/bonndit/", "platform": "", "project_url": "https://pypi.org/project/bonndit/", "project_urls": { "Homepage": "https://github.com/MedVisBonn/bonndit" }, "release_url": "https://pypi.org/project/bonndit/0.1.2/", "requires_dist": [ "nibabel", "numpy", "pandas", "dipy", "scipy", "tqdm", "cvxopt", "mpmath" ], "requires_python": "", "summary": "The bonndit package contains the latest diffusion imaging tools developed at the University of Bonn.", "version": "0.1.2" }, "last_serial": 4869708, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "89bfd3dc25902ec663e4de46e68a2d0b", "sha256": "065f09464a34f2dc9047b6dec34e7631aa19911bfe4018147205eadff9854c7f" }, "downloads": -1, "filename": "bonndit-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "89bfd3dc25902ec663e4de46e68a2d0b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 64012, "upload_time": "2019-02-06T12:40:13", "url": "https://files.pythonhosted.org/packages/de/ec/c250e9bf384e47df46be1900426b5876b993dd68e9cef6cc7919dcfffbfe/bonndit-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "fd8c377d50a3f067022f6c105c6dab3b", "sha256": "c9049676ec8e39a2672b017d1a188d7f5a334b3fff0128ba7f7f6cb5ee02a72e" }, "downloads": -1, "filename": "bonndit-0.1.1.tar.gz", "has_sig": false, "md5_digest": "fd8c377d50a3f067022f6c105c6dab3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 154655, "upload_time": "2019-02-06T12:40:15", "url": "https://files.pythonhosted.org/packages/86/ae/5aad212b52322641b1cfcfd6b223d370e4de2d24f4f7a90083ce50098391/bonndit-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "6c9349034a8c876e040e2f139f5c7948", "sha256": "bebfb474cc98f74ad4bde6b6f608db10d21a6dd2238cde69c3b52a4b56130083" }, "downloads": -1, "filename": "bonndit-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "6c9349034a8c876e040e2f139f5c7948", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 64148, "upload_time": "2019-02-26T13:44:57", "url": "https://files.pythonhosted.org/packages/4c/7a/e70a143e1655cf9362acbb66d43996eee01d5e64251195367ad0a58b3627/bonndit-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "954558e466d1677b7812883c502688fb", "sha256": "57e2aadfde04d0b74f665aeac28bd35f9f3e6bd1062b8f26f578baaf2a3c0754" }, "downloads": -1, "filename": "bonndit-0.1.2.tar.gz", "has_sig": false, "md5_digest": "954558e466d1677b7812883c502688fb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 155105, "upload_time": "2019-02-26T13:44:59", "url": "https://files.pythonhosted.org/packages/f6/1e/f04916ccb161e7d07eb41fe2c08639fbdc9a9317f29f73af6a8d2696f181/bonndit-0.1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6c9349034a8c876e040e2f139f5c7948", "sha256": "bebfb474cc98f74ad4bde6b6f608db10d21a6dd2238cde69c3b52a4b56130083" }, "downloads": -1, "filename": "bonndit-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "6c9349034a8c876e040e2f139f5c7948", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 64148, "upload_time": "2019-02-26T13:44:57", "url": "https://files.pythonhosted.org/packages/4c/7a/e70a143e1655cf9362acbb66d43996eee01d5e64251195367ad0a58b3627/bonndit-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "954558e466d1677b7812883c502688fb", "sha256": "57e2aadfde04d0b74f665aeac28bd35f9f3e6bd1062b8f26f578baaf2a3c0754" }, "downloads": -1, "filename": "bonndit-0.1.2.tar.gz", "has_sig": false, "md5_digest": "954558e466d1677b7812883c502688fb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 155105, "upload_time": "2019-02-26T13:44:59", "url": "https://files.pythonhosted.org/packages/f6/1e/f04916ccb161e7d07eb41fe2c08639fbdc9a9317f29f73af6a8d2696f181/bonndit-0.1.2.tar.gz" } ] }