Hello everyone, my name is Daniel Ridani. I am a first-year PhD student at Polytechnique Montreal, majoring in biomedical engineering. I did my Bachelor's in general physics and my Master's in biomedical engineering, where I fell in love with this field and decided to pursue a PhD. Currently, I am working on quantitative MRI, specifically quantitative susceptibility mapping (QSM). In my research, I focus on studying the susceptibility contributions from iron and myelin and developing methods to effectively separate them. Brain Hack School has given me the opportunity to improve my Python skills and explore new topics such as deep learning and machine learning.
My project aims to validate χ-separation algorithm using realistic in silico head phantom simulation. Susceptibility denoted as (χ), is a measure of how easily a material can be magnetized in response to an external magnetic field. Positive susceptibility implies that the material's spin aligns its magnetic moment parallel to the main field, while negative susceptibility indicates an opposing alignment. The main two sources of susceptibility are myelin (χ<0) and iron (χ>0) and they co-exist in almost every region in the human brain. Using the susceptibility, we can generate maps known as Quantitative susceptibility mapping (QSM) which does not have a ground truth. In the absence of ground truth for QSM, efforts have been made (QSM reconstruction challenge 2.0) [1] to create a phantom that can serve as a reference standard for validation. QSM measures the total susceptibility rather than the distinct positive and negative susceptibility sources, hence, to address this, χ-separation techniques, are employed to separate the two susceptibility sources [2]. The distinction between positive and negative sources of susceptibility plays a crucial role in understanding the underlying physiological processes and their implications for brain function. The ability to accurately discern and differentiate between these sources contributes significantly to the reliability of the assessments conducted in this study. The aforementioned phantom can be utilized to validate the accuracy of the χ-separation results.
- Get more familiar with χ-separation limitation.
- Validate χ-separation algorithm using ground truth data (phantom simulations).
- Implement python scripts to analyze and visualize the results.
- Create a GitHub repo to share my results.
- Gain a deeper understanding of susceptibility contribution in the human brain.
- Develop the skill to manage a small project in a short period.
- Improve my programming skill using the BrainHack school modules.
- Share my knowledge with others to encourage open science.
- χ-separation GUI developed by Hyeong-Geol Shin et al.
- QSM reconstruction challenge 2.0 code for Gradient Echo (GRE) simulations of custom phantoms.
- Git and GitHub for Version Control.
- Python Packages: "matplotlib" [3], "seaborn" [4], "pandas" [5].
The dataset used in this study was simulated using the Matlab code from the QSM reconstruction challenge 2.0 article developed by José P. Marques et al. This article also provided susceptibility values for 10 different regions in the brain.
A summary of the susceptibility values is as follows [6]:
| Brain Regions | Susceptibility (ppm) |
|---|---|
| Caudate Nucleus | 0.044 |
| Globus Pallidus | 0.1305 |
| Putamen | 0.038 |
| Red Nucleus | 0.1 |
| Dentate Nucleus | 0.152 |
| Substanial Nigra | 0.111 |
| Thalamus | 0.02 |
| White Matter | -0.03 |
| Grey Matter | 0.02 |
| CSF | 0.019 |
Table 1: Susceptibility values of different brain region
At the end of this project, we will have:
- A phantom for χ-separation used as a ground truth.
- Detailed project workflow documented in a GitHub repository.
- Executable python scripts for data visualization and analysis.
- Markdown file providing comprehensive project details.
To generate the phantoms used in this study, two experiments were performed:
- The first experiment involved assigning variable values to each voxel within a specific region, with the mean value ± standard deviation being used for analysis.
- The second experiment, a uniform value was assigned to every voxel within the same region. This approach will help reduce the complexity of the phantom model to see if the complexity of the phantom is a limitation of χ-separation.
χ-separation requires three main inputs:
-
Magnitude image.
-
Frequency shift (Δf): This map can be obtained from the phase image after we apply a couple of processing steps that will be explained in the next section.
-
R'2 map (R'2 = R*2 - R2 ): In order to obtain an R'2 map, you will need to follow these steps. First, acquire two different scan sequences: Gradient-echo (GRE) and Spin-echo (SE). From each sequence, generate magnitude images. Next, perform an exponential fitting on the magnitude images separately. This will provide you with T*2 and T2 maps for the GRE and SE sequences, respectively. To calculate R*2, take the inverse of T*2 (denoted as 1⁄T*2). Similarly, calculate R2 by taking the inverse of T2 (denoted as 1⁄T2). Finally, obtain R'2 by subtracting R2 from R*2.
Figure 1 represents the entire pipeline used to get two separate images of iron and myelin. The custom phantom (χTotalSimulated) is simulated into GRE data to give magnitude and phase images. The magnitude image is used to extract a binary mask to identify the region of interest and an R*2 using an exponential fitting. Since χ-separation requires an R'2 map and the simulation only provides GRE data an approximation adapted from Alexey V. Dimov et al was used to estimate the R'2 map [7]. In his work he found a strong correlation between R*2 and R'2 maps and establish a relation between them: R*2 = αR'2. Afterward a phase unwrapping algorithm is applied on the phase image to obtain the true phase followed by a background field removal to remove the induced background field from the region of interest and finally a dipole inversion technique is applied to estimate the local susceptibility. At this point we apply the χ-separation algorithm to separate the positive (χPositiveMeasured) and negative (χNegativeMeasured) susceptibilities. Finally, the positive and negative susceptibility maps are combined to obtain the total susceptibility (χTotalMeasured), which will be used for comparing the susceptibility values before and after χ-separation.
Figure 2 represents the phantom maps that will be used as ground truth. This figure present two sets of maps: the first (a, b and c) has a variable assessment of brain region values and the second (d, e and f) has a uniform assessment of brain region values. The figure presented in this study exemplifies the comparative analysis of variable and uniform assessments. The findings of these experiments will shed light on the limitations of χ-separation when it comes to the complexity of the used model.
Figures 3 provide a compelling visual representation of the clear separation observed between positive and negative sources of susceptibility in the assessment of brain regions. Notably, the measured maps obtained through x-separation exhibit an resemblance to the ground truth, validating their accuracy and reliability in both the evaluation of variability and uniformity within the brain regions of interest which demonstrates the successful separation of positive and negative susceptibility sources in the assessment of brain regions. Through a meticulous comparison of the measured maps with the ground truth, it becomes evident that the applied x-separation method effectively captures the details of the brain regions under investigation. The similarity observed between the measured maps and the ground truth maps validates the effectiveness of the employed methodology and strengthens confidence in the obtained results.
Figure 4 presents the quantitative comparative analysis between simulated and measured susceptibility values for both variable and uniform assessment of brain region values. Each plot includes a y=x line to facilitate visual comparison and evaluate the consistency between measured and simulated data. This comparison is important to demonstrate the validity of the χ-separation algorithm. Ideally, the measured values should be equal to the simulated values, thus, the closer the value of the slope is to 1 the more accurate the measured values are to the simulated values. On the firs hand, when we took a variable assessment of brain region values approach the linear regression results of Figure A are as follows: slope=0.77, R2=0.98 when comparing QSM vs χTotalSimulated; slope=0.39, R2=0.98 when comparing χTotalMeasured vs χTotalSimulated; slope=0.36, R2=0.99 when comparing χPositiveMeasured vs χPositiveSimulated and finally slope=0.15, R2=0.53 when comparing χNegativeMeasured vs χNegativeSimulated. On the other hand, when we took a uniform assessment of brain region values approach to make the model less complex, the linear regression results of Figure B are as follows: slope=0.89, R2=0.99 when comparing QSM vs χTotalSimulated; slope=0.45, R2=0.99 when comparing χTotalMeasured vs χTotalSimulated; slope=0.41, R2=0.99 when comparing χPositiveMeasured vs χPositiveSimulated and finally slope=0.28, R2=0.70 when comparing χNegativeMeasured vs χNegativeSimulated. An immediate rise in the value of correlation and slope was observed when the model was simplified at a small rate.
- χ-separation is a great and easy tool to use that allows us to separate myelin from iron.
- Simulations are important to obtain the ground truth and validate the measured values.
- χ-separation showed great visual results compared to the simulated maps but it poorly performed numerically, especially when it comes to negative susceptibility.
- χ-separation performed better when the χ-model was simpler, which could be one of the algorithm's limitations.
- Using Python for data visualization and analysis is easy and produces the best plots.
- Other χ-separation limitations should be explored
- Other separation algorithms should be studied.
- Add microstructure information to the algorithm to make it more accurate (such as myelin fiber orientations)
Regarding the objectives, learning tools, and deliverables, I consider the project to be a successful endeavor. It has resulted in the creation of a comprehensive pipeline that encompasses all the necessary steps, starting from raw data processing and leading to the visualization of results. Furthermore, the project has successfully incorporated the targeted tools, enabling me to gain proficiency in their utilization. The deliverables of the project have been met, as evidenced by the provision of a detailed project walkthrough and the availability of reproducible Python scripts for future use.
Requirements:
- Download χ-separation code from GitHub, you can find the repository here. It have a well documented manual on how to use the GUI.
- Download QSM reconstruction challenge 2.0 simulation code. you can find the files here. Note that you will have to request access in order to download the file, but it's really simple you just have to connect to your ORCID account. In case you don't have an ORCID-ID you can create one here
- Download and install python packages for data visualization and analysis you will need three: Seaborn, Matplotlib, Pandas. You can install them use these command line:
pip install seaborn||pip install matplotlib||pip install pandas - Download qMRLab software for data fitting. you can find the software here [8].
- Matlab
Once all the files are installed, carefully read the manuals that are provided by the developers as well as this report. I suggest also to read their corresponding articles so you can have an idea on how the algorithms work. You can find the link for the χ-separation article here, and the link for the QSM reconstruction challenge 2.0 here.
After reading everything, you have a general idea of what you should expect from these codes. First, open your simulation file and create your custom phantom. You can do that by changing, for example, the values of each region of the brain provided by a file named "parameters.mat", which will contain susceptibility values used as a reference for your work denoted as "chiref", "chiref" will present the total susceptibility, I suggest adding two more columns named "chipos" and "chineg" so you can add your positive and negative susceptibilities (always make sure that chiref=chipos+chineg). Now RUN the file named MacroCreateSusceptibiltyPhantom.m that will call the main function CreateOwnRealisticPhantom.m. Now before running you might want to consider one of these two options:
- Run the code through chiref, chipos, chineg individually. (By default, the code will use chiref since we manually added chipos and chineg so to run the code over the values of chipos and chineg you will have to change in
CreateOwnRealisticPhantom.mevery chiref into chipos or chineg). - Change the code! You can automatically get the chipos and chineg then add them together and save the results as chiref. Here is my suggestion: 1) Make a copy of the original code so you don't lose it. 2) Open
CreateOwnRealisticPhantom.mand change every chiref to chipos. 3) Copy-paste almost all the code and now change it to chineg. At this point you should have the exact code repeated twice once for chipos and once for chineg. 4) To get chiref add these few lines at the end:
%Calculation of ChiTotal from ChiNeg and ChiPos
% File paths of the two NIfTI images to be loaded
ChiNegPath = 'data/chimodel/ChiNeg.nii';
ChiPosPath = 'data/chimodel/ChiPos.nii';
% Load the first NIfTI image
chineg = load_untouch_nii(ChiNegPath);
chinegdata = chineg.img;
% Load the second NIfTI image
chipos = load_untouch_nii(ChiPosPath);
chiposdata = chipos.img;
% Perform addition of the two images
Chitotal = chinegdata + chiposdata;
% Save the result as a NIfTI image
resultNii = chineg; % Use image1 as a template for header information
resultNii.img = Chitotal; % Assign the result to the image data
% File path to save the result NIfTI image
resultPath = 'data/chimodel/Chi.nii';
% Save the result NIfTI image
save_untouch_nii(resultNii, resultPath);
% Display a message upon successful save
disp('Result NIfTI image saved successfully.');Now we have 3 images chiref saved as Chi.nii, chipos saved as ChiPos.nii and chineg saved as ChiNeg.nii. For the next step (data simulation) use only the Chi.nii file since the ChiPos.nii and ChiNeg.nii are only used for comparison reasons. Open MacroCreateSimulationData.m file, after you make sure you used the parameters you want, run the file and wait until the simulation ends. This simulation will result in multiple phase and magnitude images each correspond to it's TE time. You can use this file here to concatenate the files into one file named Magnitude_data.nii.gz and Phase_data.nii.gz. Now go ahead and open χ-separation GUI and follow the instruction to get the separated images. Note that you can use this code here to calculate an estimation of R'2 map.
In order to create susceptibility maps and other maps that have constant regions as I did in this project you can use this python code here to create uniform χ susceptibility maps and this code here to create other uniform maps that you will need in this work (read the code to understand which maps I am talking about).
The final step is to make the plots that I showed in the results section. To do this you will have first to download this .csv file here that will contain all the values used to plot the figures and you can find the code here which is a Jupyter Notebook code.
IMPORTANT NOTE: Always make sure that everything is on the same path (requirements and data)
I would like to thank the Brank Hack School 2023 for organizing this course and for their support. The course has been highly beneficial, and I would like to express my appreciation to Dr. Eva Alonso Ortiz for delivering excellent instructions.
-
Marques, José P., et al. "QSM reconstruction challenge 2.0: A realistic in silico head phantom for MRI data simulation and evaluation of susceptibility mapping procedures." Magnetic Resonance in Medicine 86.1 (2021): 526-542.
-
Shin, Hyeong-Geol, et al. "χ-separation: Magnetic susceptibility source separation toward iron and myelin mapping in the brain." Neuroimage 240 (2021): 118371.
-
Waskom, M. Seaborn: Statistical Data Visualization. Retrieved from https://seaborn.pydata.org/
-
Hunter, J. D. (2007). Matplotlib: A 2D graphics environment. Computing in Science & Engineering, 9(3), 90-95. https://doi.org/10.1109/MCSE.2007.55
-
McKinney, W. (2010). Data Structures for Statistical Computing in Python. In Proceedings of the 9th Python in Science Conference (pp. 56-61). https://doi.org/10.25080/Majora-92bf1922-00a
-
Krebs, Nikolaus, et al. "Assessment of trace elements in human brain using inductively coupled plasma mass spectrometry." Journal of Trace Elements in Medicine and Biology 28.1 (2014): 1-7.
-
Dimov, Alexey V., et al. "Susceptibility source separation from gradient echo data using magnitude decay modeling." Journal of Neuroimaging 32.5 (2022): 852-859.
-
Karakuzu, A., Boudreau, M., Duval, T., Boshkovski, T., Leppert, I. R., Cabana, J. F., … & Stikov, N. (2020). qMRLab: Quantitative MRI analysis, under one umbrella. Journal of Open Source Software, 5(53), 2343. doi: 10.21105/joss.02343.