3288
Comment:
|
10544
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
## page was renamed from brainsuiteBDP | |
Line 2: | Line 3: |
= Estimation of brain's tissues anisortopy using Brainsuite Diffusion Pipline = | = FEM tensors estimation with BrainSuite = |
Line 7: | Line 8: |
Describe brainsuite here : here we will describe the process of the brain tissues anisotrpy estimation and the different functions that brainstorm offers. | In this tutorial, we describe the process of the estimation of the realistic conductivity tensors for the brain tissues using the [[http://brainsuite.org/|BrainSuite software]]. The main purpose is to generate the conductivity tensor for the FEM computation as introduced on [[https://neuroimage.usc.edu/brainstorm/Tutorials/Duneuro|this page]]. |
Line 9: | Line 10: |
This tutorial explains how to use Brainsuite to estimate the anisotropy of the brain tissues. | The realistic tensors are estimated from the Diffusion-Weighted Images (DWI). For this purpose, Brainstorm calls internally the BrainSuite software to compute the diffusion tensors on each brain voxel. Afterward, the Effective Medium Approach (EMA) is applied to convert the diffusion tensors to the conductivity tensors. |
Line 11: | Line 12: |
refer to this page | The following section shows the users how to do it from the Brainstorm graphical interface. |
Line 13: | Line 14: |
[[https://neuroimage.usc.edu/brainstorm/Tutorials/SegBrainSuite?highlight=(anand)|https://neuroimage.usc.edu/brainstorm/Tutorials/SegBrainSuite?highlight=%28anand%29]] --(model using the '''finite element method''' ('''FEM'''). The FEM methods use the realistic volume mesh of the head generated from the segmentation of the MRI. The FEM models provides more accurate results than the spherical forward models, and more realistic geometry and tissue propriety than the BEM methods.)-- --(The scope of this page is limited to a '''basic example''' (head model with 3 layers), more advanced options for head model generation and forward model options are discussed in the tutorial about FEM mesh generation. We assume that you have already followed the introduction tutorials (or at least the head modeling tutorial), we will not discuss the general principles of forward modeling here.)-- |
Further documentation about previous usage of Brainsuite within Brainstorm can be found in this [[https://neuroimage.usc.edu/brainstorm/Tutorials/SegBrainSuite|page]]. |
Line 21: | Line 18: |
== Installation == | == Requirement == * You have already followed all the introduction tutorials * You have a working copy of Brainstorm installed on your computer * For the DWI data, only the NIfTi files are supported == Brainsuite Installation == |
Line 23: | Line 25: |
Line 24: | Line 27: |
1. Note that you will be using Surface/Volume Registration (SVReg) to do the surface segmentation, so you need to install a compatible [[http://www.mathworks.com/products/compiler/mcr|MATLAB Compiler Runtime]](2015b for BrainSuite 18a). You may ignore any instructions about "Setting up BDP" if you are not planning on using BrainSuite for diffusion imaging. 1. Start BrainSuite (if it is not already open following installation). |
|
Line 27: | Line 28: |
== Requirement == | 1. Note that you will be using BrainSuite Diffusion Pipeline(BDP), so you need to install a compatible [[http://www.mathworks.com/products/compiler/mcr|MATLAB Compiler Runtime]](last version). |
Line 29: | Line 30: |
* You have already followed all the introduction tutorials * You have already generated the FEM mesh as explained here (link to the FEM mesh) * You have a working copy of Brainstorm installed on your computer. * Get the open access reference data set from''' '''here''' link todataset of Ernie / simnibs''' |
1. Start BrainSuite to check if the installation (It's not required to open BrainSuite to run this tutorial). |
Line 34: | Line 32: |
The BrainSuite installation folder must be informed in the Brainstorm preferences: | 1. The BrainSuite installation folder should be informed in the Brainstorm preferences |
Line 36: | Line 34: |
{{https://user-images.githubusercontent.com/6920058/81406567-1c785400-913a-11ea-9048-28c7459af7da.png|image|font-size="10pt"}} | {{attachment:brainsuiteInstalation.JPG||height="250",width="650"}} |
Line 38: | Line 36: |
---- == Dataset == In this tutorial, we use the Brainsuite dataset example available on the BrainSuite [[http://brainsuite.org/tutorials/|tutorial webpage]]. User can also download directly these data from these links: [[http://brainsuite.org/WebTutorialData/BrainSuiteTutorialSVReg_Sept16.zip|MRI T1w]] and [[http://brainsuite.org/WebTutorialData/DWI_Feb15.zip|MRI DWI]] |
|
Line 39: | Line 40: |
The first file contains the T1 MRI data, with the name '2523412.nii.gz'. as in this figure, | |
Line 40: | Line 42: |
== Import data == Onc you have imported the MRI and generated a FEM mesh. |
{{attachment:vierMriFolder.JPG||height="130",width="580"}} |
Line 43: | Line 44: |
== BDP == | The second file is the DWI and should contain at least three files |
Line 45: | Line 46: |
{{attachment:vierDWIFolder.JPG||height="150",width="580"}} | |
Line 46: | Line 48: |
Where the *.bval is a text file that contains the value of the gradient, and the *.bvec is also a text file that contains the orientation of the gradient. The nii.gz file is the NifTi file of the DWI where the images are stored. | |
Line 47: | Line 50: |
then right-click on the subject folder > Convert DWI to DTI, select DWI+bvec+bval: | == Realistic condctivity tensors == === Load the T1 MRI data to brainstorm === First, you need to create a new subject in your protocol, let call it the 'BrainSuiteSubject'. Then import the T1 MRI of the subject and set the fiducials points as explained in the [[https://neuroimage.usc.edu/brainstorm/Tutorials/ImportAnatomy|previous tutorial]]. |
Line 49: | Line 54: |
{{https://user-images.githubusercontent.com/6920058/81406299-9b20c180-9139-11ea-85ef-25278a78826f.png|image|font-size="10pt"}} | The T1 MRI is required since all the BDP uses the T1 space for its computation. Furthermore, this is required since it will be used to align the tensors to the FEM mesh later. |
Line 51: | Line 56: |
Then follow the popup windows by selecting DWI, bval and bval | {{attachment:mri.JPG||height="100",width="250"}} |
Line 53: | Line 58: |
== From diffusion tensor to conductivity tensor == == FEM head model == == Simulated tensors == |
=== Diffusion tensor generation (DTI) from DWI === In this step, Brainstorm calls the Brainsuite internally, and the diffusion tensors are computed. Right-click on the subject and then select the item "Convert DWI to DTI". {{attachment:dwi2dti.jpg||height="300",width="550"}} Then follow the popup windows by selecting the DWI, you may need to extract the zip file before. {{attachment:importDWI.JPG||height="280",width="650"}} If the bval, and bval files are in the same folder, Brainstorm will detect them automatically, otherwise, the user will be asked to browse the files one by one (as it's the case in this tutorial). Brainstorm calls internally the BrainSuite process, and compute the diffusion tensors. At the end of this process, a new node will appear in the Brainstorm database with the name 'DTI-EIT'. This name refers to, DTI: diffusion tensors images, and EIG for eigenvalue, since the eigenvalues and eigenvectors are computed at voxel and stored in Brainstorm database. {{attachment:mriAndDTI-EIG.JPG||height="100",width="230"}} If you check the structure of the file DTI-EIG, by right click -> File and then 'Display file contents', the following figure is displayed. {{attachment:EIG-hardDisc.JPG||height="200",width="450"}} The size of the matrix is 128x256x256x12, where the first 3 values are the same as the size of the T1 MRI and 12 corresponds to the 3 eigenvectors components (9) and eigenvalues (3) === Conductivity tensor generation from DTI === The Effective Medium Approach is applied to convert the diffusion tensors to the conductivity tensors. ==== FEM mesh head model ==== This step requires the FEM mesh of the head model. You can generate the FEM head model from the MRI data as explained on [[https://neuroimage.usc.edu/brainstorm/Tutorials/FemMesh|this page]]. For the following, we used the SimNibs FEM mesh generation. The following figure shows the FEM mesh obtained with the SimNibs method using the T1 MRI. {{attachment:Mri&femMeshView.JPG|Mri&femMeshView.JPG|height="300",width="260"}} {{attachment:femMeshView.JPG||height="300",width="280"}} Note that this mesh is obtained only from the T1, the use of the T2 is highly recommended if it's available, as recommended in the [[https://neuroimage.usc.edu/brainstorm/Tutorials/FemMesh|FEM mesh tutorial]]. ==== Computation of FEM mesh tensors ==== Once the FEM mesh and the DTI tensors are available in the Brainstorm database, the next step for the FEM tensors can be performed by the following: - Right-click on the FEM mesh - Compute FEM tensors {{attachment:menuGenerateFemTensors.png||height="280",width="250"}} Brainstorm checks the available tissues in the FEM head model and displays the following panel {{attachment:FEMConductivitiesIsoPanel.JPG||height="220",width="250"}} This panel lists the tissues available in the FEM head model and assigns a default value of the conductivity for each compartment. Users can change these values to their own if needed. DTI values can be used to generate conductivity tensors for the white matter (and in some cases for the grey matter). Please, note that the DWI can be used only for the brain tissues and not for the outers compartments (skull and skin) In this tutorial (and in most cases) we select the white matter. Select the WM anisotropy and keep all the other tissues as isotropic, then these additional options appear asking for the method to use. {{attachment:FEMConductivitiesAnisoPanel.JPG||height="300",width="250"}} The available methods are: - Effective Medium approach (EMA) - Effective Medium approach with volume constraints (EMA + VC) - Simulated or the artificial anisotropy Only the two first methods require the DTI. More information about these methods can be found on these references [ref1][ref2] and in our main paper [link] In this tutorial, we use the method "EMA + VC", where the final tensors are constrained to fits the volume of the equivalent isotropic tensor volume. ==== Visulation of FEM mesh tensors ==== Once the FEM tensors are successfully computed, they are stored in the FEM head node. By right-clicking on the FEM head, new menu items are added that gives the possibilities to display the FEM tensors either as ellipsoids or as vectors in the direction of the main eigenvector. {{attachment:menuDisplayTensors.jpg||height="300",width="250"}} The tensors can be displayed either on the FEM mesh or overlaid on the MRI. The following figures show an example of the obtained tensors displayed on the white matter. {{attachment:meshViewTensorsLines.JPG||height="300",width="350"}} {{attachment:meshViewTensorsTensorsTops.JPG||height="300",width="350"}} On the left, the tensors as a line on the direction of the main eigenvector. On the right, the tensors displayed as ellipsoids. The orientation of the tensor is color-coded as follows: red for right-left, green for anterior-posterior, and blue for superior-inferior. Note that the quality of the tensors depends on the DWI data and the number of acquisition direction. Users can also display the tensors on specific tissues, for example on the white matter (left figure) or overlay on the MRI (right figure). {{attachment:meshViewTensorsLinesWM2.JPG||height="300",width="350"}} {{attachment:tensorsOnMri.JPG||height="300",width="300"}} ==== Recommendation ==== In the case where the user wants to use generate isotropic tensors, then the DTI is not required. In the case where more than one FEM head model is in the database, the highlighted one in the green color will be used. <<TAG(Advanced)>> == Artificial/simulated conductivity tensors == In the case where the DWI is not available, or in the case where the users desire to evaluate the effect of the conductivity change on the head model, the artificial conductivity can be used. Users can reach this option by following this tutorial and select the third method in this panel. {{attachment:artificialTensors.JPG||height="450",width="280"}} Two approaches are integrated within Brainstorm. Either Wang's constraint or the volume's constraint (Wolters). The common feature between these methods is the ratio between the transversal and longitudinal conductivity ratio. A common example is the skull anisotropy simulation, where the longitudinal conductivity can be higher than the transversal conductivity, the ratio can vary from 2 to 10 [ref]. In this tutorial, we keep all the tissue as isotropic, except the skull, we use a ratio of 0.1 and select the volume constraint. The following figures show the results of this example. {{attachment:skullAniso.JPG||height="250",width="300"}} {{attachment:skullAniso2.JPG||height="250",width="300"}} |
FEM tensors estimation with BrainSuite
Authors: Takfarinas Medani, Francois Tadel, Anand Joshi and Richard Leahy
[TUTORIAL UNDER WRITING: NOT READY FOR PUBLIC USE]
In this tutorial, we describe the process of the estimation of the realistic conductivity tensors for the brain tissues using the BrainSuite software. The main purpose is to generate the conductivity tensor for the FEM computation as introduced on this page.
The realistic tensors are estimated from the Diffusion-Weighted Images (DWI). For this purpose, Brainstorm calls internally the BrainSuite software to compute the diffusion tensors on each brain voxel. Afterward, the Effective Medium Approach (EMA) is applied to convert the diffusion tensors to the conductivity tensors.
The following section shows the users how to do it from the Brainstorm graphical interface.
Further documentation about previous usage of Brainsuite within Brainstorm can be found in this page.
Contents
Requirement
- You have already followed all the introduction tutorials
- You have a working copy of Brainstorm installed on your computer
- For the DWI data, only the NIfTi files are supported
Brainsuite Installation
Download the latest version of BrainSuite from http://www.brainsuite.org/download.
Install it on your computer by following the instructions in BrainSuite's quick start installation guide.
Note that you will be using BrainSuite Diffusion Pipeline(BDP), so you need to install a compatible MATLAB Compiler Runtime(last version).
Start BrainSuite to check if the installation (It's not required to open BrainSuite to run this tutorial).
The BrainSuite installation folder should be informed in the Brainstorm preferences
Dataset
In this tutorial, we use the Brainsuite dataset example available on the BrainSuite tutorial webpage. User can also download directly these data from these links: MRI T1w and MRI DWI
The first file contains the T1 MRI data, with the name '2523412.nii.gz'. as in this figure,
The second file is the DWI and should contain at least three files
Where the *.bval is a text file that contains the value of the gradient, and the *.bvec is also a text file that contains the orientation of the gradient. The nii.gz file is the NifTi file of the DWI where the images are stored.
Realistic condctivity tensors
Load the T1 MRI data to brainstorm
First, you need to create a new subject in your protocol, let call it the 'BrainSuiteSubject'. Then import the T1 MRI of the subject and set the fiducials points as explained in the previous tutorial.
The T1 MRI is required since all the BDP uses the T1 space for its computation. Furthermore, this is required since it will be used to align the tensors to the FEM mesh later.
Diffusion tensor generation (DTI) from DWI
In this step, Brainstorm calls the Brainsuite internally, and the diffusion tensors are computed.
Right-click on the subject and then select the item "Convert DWI to DTI".
Then follow the popup windows by selecting the DWI, you may need to extract the zip file before.
If the bval, and bval files are in the same folder, Brainstorm will detect them automatically, otherwise, the user will be asked to browse the files one by one (as it's the case in this tutorial).
Brainstorm calls internally the BrainSuite process, and compute the diffusion tensors.
At the end of this process, a new node will appear in the Brainstorm database with the name 'DTI-EIT'. This name refers to, DTI: diffusion tensors images, and EIG for eigenvalue, since the eigenvalues and eigenvectors are computed at voxel and stored in Brainstorm database.
If you check the structure of the file DTI-EIG, by right click -> File and then 'Display file contents', the following figure is displayed.
The size of the matrix is 128x256x256x12, where the first 3 values are the same as the size of the T1 MRI and 12 corresponds to the 3 eigenvectors components (9) and eigenvalues (3)
Conductivity tensor generation from DTI
The Effective Medium Approach is applied to convert the diffusion tensors to the conductivity tensors.
FEM mesh head model
This step requires the FEM mesh of the head model. You can generate the FEM head model from the MRI data as explained on this page.
For the following, we used the SimNibs FEM mesh generation. The following figure shows the FEM mesh obtained with the SimNibs method using the T1 MRI.
Note that this mesh is obtained only from the T1, the use of the T2 is highly recommended if it's available, as recommended in the FEM mesh tutorial.
Computation of FEM mesh tensors
Once the FEM mesh and the DTI tensors are available in the Brainstorm database, the next step for the FEM tensors can be performed by the following:
- Right-click on the FEM mesh - Compute FEM tensors
Brainstorm checks the available tissues in the FEM head model and displays the following panel
This panel lists the tissues available in the FEM head model and assigns a default value of the conductivity for each compartment. Users can change these values to their own if needed.
DTI values can be used to generate conductivity tensors for the white matter (and in some cases for the grey matter). Please, note that the DWI can be used only for the brain tissues and not for the outers compartments (skull and skin)
In this tutorial (and in most cases) we select the white matter. Select the WM anisotropy and keep all the other tissues as isotropic, then these additional options appear asking for the method to use.
The available methods are:
- Effective Medium approach (EMA)
- Effective Medium approach with volume constraints (EMA + VC)
- Simulated or the artificial anisotropy
Only the two first methods require the DTI. More information about these methods can be found on these references [ref1][ref2] and in our main paper [link]
In this tutorial, we use the method "EMA + VC", where the final tensors are constrained to fits the volume of the equivalent isotropic tensor volume.
Visulation of FEM mesh tensors
Once the FEM tensors are successfully computed, they are stored in the FEM head node. By right-clicking on the FEM head, new menu items are added that gives the possibilities to display the FEM tensors either as ellipsoids or as vectors in the direction of the main eigenvector.
The tensors can be displayed either on the FEM mesh or overlaid on the MRI. The following figures show an example of the obtained tensors displayed on the white matter.
On the left, the tensors as a line on the direction of the main eigenvector. On the right, the tensors displayed as ellipsoids. The orientation of the tensor is color-coded as follows: red for right-left, green for anterior-posterior, and blue for superior-inferior.
Note that the quality of the tensors depends on the DWI data and the number of acquisition direction.
Users can also display the tensors on specific tissues, for example on the white matter (left figure) or overlay on the MRI (right figure).
Recommendation
In the case where the user wants to use generate isotropic tensors, then the DTI is not required. In the case where more than one FEM head model is in the database, the highlighted one in the green color will be used.
Artificial/simulated conductivity tensors
In the case where the DWI is not available, or in the case where the users desire to evaluate the effect of the conductivity change on the head model, the artificial conductivity can be used.
Users can reach this option by following this tutorial and select the third method in this panel.
Two approaches are integrated within Brainstorm. Either Wang's constraint or the volume's constraint (Wolters). The common feature between these methods is the ratio between the transversal and longitudinal conductivity ratio.
A common example is the skull anisotropy simulation, where the longitudinal conductivity can be higher than the transversal conductivity, the ratio can vary from 2 to 10 [ref]. In this tutorial, we keep all the tissue as isotropic, except the skull, we use a ratio of 0.1 and select the volume constraint. The following figures show the results of this example.