DeepParcellation Package

DeepParcellation: fast and accurate brain MRI parcellation by deep learning

Contributions

The project was initiated by Dr. Lim (abysslover) and Dr. Choi (yooha1003).
The code is written by Dr. Lim at Gwangju Alzheimer's & Related Dementias (GARD) Cohort Research Center (GARD CRC), Chosun University.
This research was conducted in collaborations with the following people: Eun-Cheon Lim¹, Uk-Su Choi¹, Yul-Wan Sung², Kun-Ho Lee¹ and Jungsoo Gim¹.

Gwangju Alzheimer's & Related Dementias (GARD) Cohort Research Center, Chosun University, Gwangju, Republic of Korea
Kansei Fukushi Research Institute, Tohoku Fukushi University, Sendai, Miyagi, Japan

The manuscript will be available in the future.

Getting Started

A step-by-step tutorial is provided in the following sections.

Prerequisites

You should install CUDA-enabled GPU cards with at least 8GB GPU memory manufactured by nVidia, e.g., Titan XP.

Prepare T1-weighted MR images

Convert MR images to Neuroimaging Informatics Technology Initiative (NIfTI) format.
The parent directory name of a NIfTI file path will be used as Subject Id during prediction.
You can specify either an input path of the NIfTI file or input direcotry of many NIfTI files.

Install DeepParcellation

Install Anaconda
- Download an Anaconda distribution: Link
Create a Conda environment

	conda create -n deepparc python=3.8 -y

Install DeepParcellation (CPU mode)

	conda activate deepparc
	pip install deepparcellation

Install DeepParcellation (GPU mode)

	conda activate deepparc
	pip install deepparcellation
	conda install cudnn=7.6.5 -c anaconda -y
	conda install cudatoolkit=10.1.243 -c conda-forge -y
	pip uninstall tensorflow -y
	pip install tensorflow-gpu==2.2.0
	pip uninstall keras -y
	conda install keras-gpu=2.4.3 -c anaconda -y

Install DeepParcellation (Force)

	conda activate deepparc
	pip install --force --no-dependencies deepparcellation

Run DeepParcellation

	conda activate deepparc
	deepparcellation -o=/tmp/test --i=./subject-0-0000/test.nii.gz
	or
	deepparcellation -o=/tmp/test --i=./

NOTE:

You must always activate the conda enviroment before running DeepParcellation if you opened a new console.
You should install DeepParcellation with force parameter when all the other dependencies were manually met, i.e., you have installed tensorflow-macos, tensorflow-metal dependencies for Apple M1 chips.

Contact

Please contact abysslover@gmail.com if you have any questions about DeepParcellation.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deepparcellation-1.0.35.tar.gz (34.4 kB view details)

Uploaded Sep 9, 2021 Source

File details

Details for the file deepparcellation-1.0.35.tar.gz.

File metadata

Download URL: deepparcellation-1.0.35.tar.gz
Upload date: Sep 9, 2021
Size: 34.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.3.0 pkginfo/1.7.1 requests/2.24.0 setuptools/52.0.0.post20210125 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.8.8

File hashes

Hashes for deepparcellation-1.0.35.tar.gz
Algorithm	Hash digest
SHA256	`530bf5075a5a6de9d111bf5922389fdbaf2e9ec52dac4cf9228cd0c5671319af`
MD5	`1b23e4e5b4ad109dc5b20aa7efa5c82d`
BLAKE2b-256	`a45fdec062edb3ac4c7f96947a377f7ef0dc362d2cafae63df1760d4c679c4f0`