- Hippocampus Segmentation Docker
- hdbet Extraction Docker
- haca3 Harmonization Docker
- WMH Segmentation Docker
GPU Model: NVIDIA A40
NVIDIA Driver Version: 535.161.08
Supply CUDA Version: 12.2
CPU RAM: 65368064 KiB total
Run-time on GPU: 13 s per subject
(Optional) These will improve the model's performance, and conversely, not performing the task may lead to poor results.
1. N4 Bias Correction
2. Registration
- Bias Field in MRI image refers to the non-uniformity of signal intensity (illumination distortion) within the image.
- These bias fields are caused by various factors such as the device, scanning environment, and characteristics of biological tissue, and they affect the global brightness pattern of the image.
- It is necessary to improve the illumination uniformity of MRI and increase the accuracy of Hippocampus segmentation. This standardizes the model input data by reducing the variation of illumination intensity within the image.
N4 Bias field correction principle
- Each patient or subject's MRI may have different posture, size, and orientation when scanned. These differences make it difficult to directly compare the brain structure of one subject with that of another.
- Align the input data to a standard space to ensure that model can more accurately segment the hippocampus structure of various subjects. In general, it is recommended to align to the Montreal Neurological Institute (MNI) space.
Images before and after alignment with MNI template
(Red color: MNI Template)
docker run -it --network host --gpus all -v [Segmentation Subject Files Path]:/mnt hippo_seg /bin/bash
cd /seg ⋯ Segmentation Execution Code Path Access Command
sh deepseg1.sh ../mnt/ ⋯ Code Execution Command
It is saved in thed path of the executable target file.
(Red color: Segmented Hippocampus)
GPU Model: NVIDIA A40
NVIDIA Driver Version: 535.161.08
Supply CUDA Version: 12.2
CPU RAM: 65368064 KiB total
Run-time on GPU: 43 s per subject
(Optional) These will improve the model's performance, and conversely, not performing the task may lead to poor results.
1. N4 Bias Correction
2. Registration
- Bias Field in MRI image refers to the non-uniformity of signal intensity (illumination distortion) within the image.
- These bias fields are caused by various factors such as the device, scanning environment, and characteristics of biological tissue, and they affect the global brightness pattern of the image.
- It is necessary to improve the illumination uniformity of MRI and increase the accuracy of Hippocampus segmentation. This standardizes the model input data by reducing the variation of illumination intensity within the image.
N4 Bias field correction principle
- Each patient or subject's MRI may have different posture, size, and orientation when scanned. These differences make it difficult to directly compare the brain structure of one subject with that of another.
- Align the input data to a standard space to ensure that model can more accurately segment the hippocampus structure of various subjects. In general, it is recommended to align to the Montreal Neurological Institute (MNI) space.
Images before and after alignment with MNI template
(Red color: MNI Template)
docker run -it --network host --gpus all -v [Extraction Subject Files Path]:/mnt vnmd/hdbet_bdsp /bin/bash
cd HD_BET ⋯ Extraction Execution Code Path Access Command
hd-bet -i /mnt/ ⋯ Extraction Execution Command (Output result data at the input data path)
hd-bet -i /mnt/ -o /mnt/[output_path] ⋯ Extraction Execution Command (Output result data to a specified path)
When executing the 'hd-bet -i /mnt/', it is saved in the execution target file path.
When executing the 'hd-bet -i /mnt/ -o /mnt/[output_path]', it is saved in '/mnt/[output_path]'.
(Red color: Extracted Brain)
GPU Model: NVIDIA A40
NVIDIA Driver Version: 535.161.08
Supply CUDA Version: 12.2
CPU RAM: 63836.0 MiB total
Run-time on GPU: 10 s per subject
(Essential) This steps are essential for the performance of the model, and if not performed, you will definitely get poor results.
1. N4 Bias Correction
2. MNI152 Registration
- Bias Field in MRI image refers to the non-uniformity of signal intensity (illumination distortion) within the image.
- These bias fields are caused by various factors such as the device, scanning environment, and characteristics of biological tissue, and they affect the global brightness pattern of the image.
- It is necessary to improve the illumination uniformity of MRI and increase the accuracy of Hippocampus segmentation. This standardizes the model input data by reducing the variation of illumination intensity within the image.
N4 Bias field correction principle
- Each patient or subject's MRI may have different posture, size, and orientation when scanned. These differences make it difficult to directly compare the brain structure of one subject with that of another.
- Align the input data to a standard space to ensure that model can more accurately segment the hippocampus structure of various subjects.
Images before and after alignment with MNI template
(Red color: MNI Template)
docker run --rm --gpus all -it -v [Harmonization Subject Files Path]:/workspace haca3cna_v2
cd .. ⋯ Access Path
python reshape.py /workspace/ ⋯ execute code to zero pad an image to the MNI152 template
# Harmonization Execution Command
haca3-test --in-path /workspace/D11004_COR_3D_T1_FSPGR_20151015083508_9_N4_resample_lin.nii.gz --target-image /workspace/N110132_Sag_IR-FSPGR_20220316124202_3_N4_lin.nii.gz --harmonization-model /pretrained_weights/CNA_onlyT1w_model.pt --fusion-model /pretrained_weights/fusion.pt --out-path /workspace/D11004_COR_3D_T1_FSPGR_20151015083508_9_N4_resample_lin.nii.gz --intermediate-out-dir /workspace/intermidate
GPU Model: NVIDIA A40
NVIDIA Driver Version: 535.161.08
Supply CUDA Version: 12.3
CPU RAM: 65368064 KiB total
Run-time on GPU: 10 s per subject
(Essential) This steps are essential for the performance of the model, and if not performed, you will definitely get poor results.
1. N4 Bias Correction
2. T1, FLAIR Co-Registration
3. Brain Extraction (ROBEX, HD-BET, ...)
- Use the flirt commnad by default.
- flirt -dof 6 -in subject_T1.nii -ref subject_FLAIR.nii -out subject_T1_to_FLAIR -omat subject_T1_to_FLAIR.mat
Ex) flirt -dof 6 -in /nasdata3/cohort_FLAIR_2022-1/T1_N4/GH/L1_GH_04935_native_N4.nii -ref /nasdata3/cohort_FLAIR_2022-1/FLAIR/GH/L1_GH_04935/L1_GH_04935_FLAIR.nii -out /nasdata3/cohort_FLAIR_2022-1/FLAIR/GH/L1_GH_04935/T1_to_FLAIR -omat /nasdata3/cohort_FLAIR_2022-1/FLAIR/GH/L1_GH_04935/T1_to_FLAIR.mat
- Bias Field in MRI image refers to the non-uniformity of signal intensity (illumination distortion) within the image.
- These bias fields are caused by various factors such as the device, scanning environment, and characteristics of biological tissue, and they affect the global brightness pattern of the image.
- It is necessary to improve the illumination uniformity of MRI and increase the accuracy of Hippocampus segmentation. This standardizes the model input data by reducing the variation of illumination intensity within the image.
N4 Bias field correction principle
- Co-registration is necessary when alignment between brain images taken at different times, modalities, or conditions is required. For example, when comparing MRI data of the same patient or analyzing changes over time even in images of the same modality, the location, size, and orientation of each image may be different. These differences hinder direct comparison or integrated analysis of image data.
- Co-registration solves this problem by aligning all images to the same coordinate system so that the same anatomical structures appear in the same locations. This enables integrated analysis of multimodal data, observation of temporal changes, and comparison between groups.
- Co-registration is performed to align FLAIR images to the same coordinate system as T1 images, thereby precisely matching the anatomical structures between the two images. This allows for more precise segmentation of white matter lesion signals appearing in FLAIR by utilizing structural information from T1.
Co-Registration before and after
(Red color: T1-weight image / Brain: FLAIR image)
-
In WMH (White Matter Hyperintensities) segmentation, Brain Extraction is an important preprocessing step that separates only brain tissue and removes non-brain tissues such as skull, sacrum, and air. In magnetic resonance imaging sequences such as FLAIR, non-brain tissues can appear as high-intensity signals, which can be easily confused with lesions. Removing these non-brain tissues through brain region extraction allows the model to focus on lesions, thereby improving segmentation accuracy.
-
In addition, brain region extraction increases computational efficiency by removing non-brain regions, enables standardization for comparison between data, and reduces noise to clearly distinguish the boundary between lesions and non-lesions. As a result, this process greatly improves the reliability and accuracy of WMH segmentation, making it essential for improving the quality of analysis and research results.
Example of brain region extraction results using the HD-BET model
(Red color: Extracted Brain)
docker run -it --network host --gpus all -v [Segmentation Subject Files Path]:/mnt pgs_wmh_gpu_v1 /bin/bash
# WMH segmentation Execution Command Format
python WMHs_segmentation_PGS_gpu_division.py /mnt/[subject_brain.nii] /mnt/[subject_brain_mask.nii] /mnt/[subject_FLAIR.nii] /mnt/[subject_WMH.nii] [GPU_number] ⋯
# WMH segmentation Execution Command Format Example
python WMHs_segmentation_PGS_gpu_division.py /mnt/${sub_fold}_brain.nii /mnt/${sub_fold}_brain_mask.nii /mnt/${sub_fold}_FLAIR.nii /mnt/${sub_fold}/${sub_fold}_WMH.nii 5