5794
Comment:
|
11962
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
This page will explain the differents options available within brainstorm to generate the FEM mesh. | = Realistic head model: FEM mesh generation = '''[TUTORIAL UNDER DEVELOPMENT: NOT READY FOR PUBLIC USE]''' |
Line 3: | Line 4: |
Describe meshGeneration here. | ''Authors: Takfarinas Medani '' |
Line 5: | Line 6: |
<<TableOfContents(2,2)>> | |
Line 6: | Line 8: |
== Introduction == This tutorial present the methods integrated to brainstorm used to generate the FEM mesh. |
|
Line 7: | Line 11: |
==== SimNIBS Installation ==== Please follow the instructions on this [[https://simnibs.github.io/simnibs/build/html/installation/simnibs_installer.html|webapge]]''__ (new brainstom page that explain how to generate the head model is under development)__'' |
The FEM mesh is required for the finite element method computation. The FEM computation could be used for most of the known modalities : EEG/MEG forward problem, TMS or TDSC stimulation and for intracranial meodalities like sEEG and ECOG. |
Line 10: | Line 13: |
in order to do the SimNibs software shoud be installed in your computer. | In this tutorial, we present the different methods available with brainstorm to generate the FEM mesh and how to use them from the brainstorm GUI. |
Line 12: | Line 15: |
==== Iso2Mesh Installation ==== If iso2mesh is not installed in your computer, Brainstrom will download the last release from this [[https://neuroimage.usc.edu/brainstorm/http://iso2mesh.sourceforge.net/cgi-bin/index.cgi?Download|webpage]] and install it when it'is needed. However, you can also download the iso2mesh from the [[https://github.com/fangq/iso2mesh|github]] and add it to your matlab path. |
== Mesh tools == Brainstorm integrates a list of the open-source tools. These tools are commonly used by the FEM community to generate either tetrahedral or hexahedra mesh. |
Line 15: | Line 18: |
==== Brain2Mesh Installation [TODO] ==== ==== Brainsuite Installation [TODO] ==== == FEM surfaces / Volume generation == === Volume mesh generation from Brainstorm === The most modern software that are used to generate the volume mesh head model are integrated within brainstorm with an easy graphical interface to use call these tools. |
Here is the list of the available methods in brainstorm: |
Line 21: | Line 20: |
Right click on the subject and then "Generate FEM Mesh" | - [[http://iso2mesh.sourceforge.net/cgi-bin/index.cgi?Doc/FunctionList|iso2mesh]]: this option merges the brainstorm surfaces available on the subject and then generarte the tetrahedral mesh. |
Line 23: | Line 22: |
{{attachment:menuGenerateFemMesh.PNG|height="40",width="150"}} | - [[http://mcx.space/brain2mesh/|Brain2mesh]]: this option uses the MRI available on the subject, then it calls [[https://www.fil.ion.ucl.ac.uk/spm/software/spm12/|SPM]]segmentation of the volume into 5 tissues (white, gray, scf, skull and skin). After that it calls iso2mesh (internally) to generate the tetrahedral mesh. |
Line 25: | Line 24: |
The available options are : | - [[https://simnibs.github.io/simnibs/build/html/index.html|SimNibs]] : this option, recomended for realistic model, calls the [[https://simnibs.github.io/simnibs/build/html/documentation/command_line/headreco.html|headreco]]process, it uses the MRIs of the subject, and then calls SPM and [[http://www.neuro.uni-jena.de/cat/|CAT]] for the segmentation. Then the mesh generation is performed internally by integrated tools (netgen, gmesh and meshfixe). |
Line 27: | Line 26: |
. {{attachment:FemMeshMethods.PNG|height="50",width="100"}} | - [[http://www.fieldtriptoolbox.org/|Fieldtrip]] : this option call the Fieldtrip pipline, based on the segmentation of the MRI then the hexahedral mesh generation. |
Line 29: | Line 28: |
"Iso2mesh" : This option merges the brainstorm surfaces available on the subject and then generarte the tetrahedral mesh. | You can display the full list and a short description by right click on the MRI of the subject and then click the item "Generate FEM Mesh" |
Line 31: | Line 30: |
"Brain2Mesh" : This options uses the MRIs available on the subjects, then it calls the SPM segmentation of the volume into 5 tissus (white, gray, scf, skull and skin). After that it converts into a tetrahedral mesh. | {{attachment:meshMethods.JPG||height="400",width="350"}} |
Line 33: | Line 32: |
"SimNibs" : The recommended option, it calls the headreco {ref} and generate a FEM head model | == iso2mesh == iso2mesh is a matlab /octave-based mesh generation and processing toolbox. It can [[http://iso2mesh.sourceforge.net/cgi-bin/index.cgi?Doc/Workflow|create 3D tetrahedral finite element (FE) mesh from surfaces, 3D binary and gray-scale volumetric images]] such as segmented MRI/CT scans. |
Line 35: | Line 35: |
"FieldTrip" : (in progress) "Roast" : (in progress) | === Requirement === it If iso2mesh is not installed in your computer, Brainstrom will download the last release from this [[https://neuroimage.usc.edu/brainstorm/http://iso2mesh.sourceforge.net/cgi-bin/index.cgi?Download|webpage]] and install it when it'is needed. However, you can also download the iso2mesh from the [[https://github.com/fangq/iso2mesh|github]] and add it to your matlab path. |
Line 37: | Line 38: |
"headreco" : | === When and how to use it === iso2mesh is used as the basic option by brainstorm to generate FEM mesh from surfaces mesh. |
Line 39: | Line 41: |
https://simnibs.github.io/simnibs/build/html/documentation/command_line/headreco.html | Assuming the situation where you have surfaces mesh of your subject available and you have already computed the [[https://neuroimage.usc.edu/brainstorm/Tutorials/TutBem?highlight=(bem)|OpenMeeg]]forward problem. If you want to use the duneuro FEM to compute the forward model, you need to generate the FEM mesh from a similar surface used by OpenMeeg Here is the way to do it : |
Line 41: | Line 43: |
This function is part of the SimNibs software: | 1. Richt click on the subject : In this way, brainstorm will load the inner, outer and the head from the subject data. if any of these surfaces is missing, an error will be displayed. 1. Select the 'Generate FEM mesh' item, 1. Select the iso2mesh option, 1. Set the iso2mesh parameters, |
Line 43: | Line 48: |
https://simnibs.github.io/simnibs/build/html/index.html | 1. These options are used by the surf2mesh function. Select either '''MergeMesh''' or '''MergeSurf.''' 1. '''Max tetrahedral volum''' : is the maximum volume of the tetrahedral element in the mesh. '''Pourcentage of the element to keep''': parameter between 0-100%, it used to keep or not the original input surface nodes. |
Line 45: | Line 52: |
=== headreco === | Also, a full example is explained in this [[https://neuroimage.usc.edu/brainstorm/Duneuro?highlight=(duneuro)|page]]. . {{attachment:iso2meshProcess.JPG||height="380",width="720"}} Here is a view of mesh obtained with different values of the Max volume = [10, 1, 0.1, 0.01] with a keep ratio = 100%. {{attachment:IcbmMeshModels.jpg||height="420",width="700"}} [[https://neuroimage.usc.edu/brainstorm/reviewMEEGForward?highlight=(duneuro)|From our experience]], a value of 0,1 for the tetrahedral volume achieves similar results as the OpenMeeg computed from the same surfaces. We have also noticed that the result with v = 0,001 is almost similar to v = 0,01. Increasing the mesh resolution needs more time to generate the mesh, more time to perform the FEM computation and of course more memory to store the mesh in the disc. '''<<TAG(Advanced)>>''' If intersections are present on the surfaces mesh, the iso2mesh FEM mesh generation fails (tetgen) and an error will be displayed on the screen. If you face this problem, you need to check the surfaces and/or regenerate new surfaces from the MRI. === other application === You can also select any surface mesh, or multiple surfaces (with Shift key), on the brainstorm anatomy windows and then generate tetrahedral mesh by following the same steps explained above. Here are some examples using only 2 tissues. This option could be useful for investigation of tissue influence on the EEG/MEG on the forwad solution or on the source localization, or analyzing only SEEG within brain volume ... {{attachment:otherMesh.JPG||height="320",width="600"}} == brain2mesh == Brain2Mesh is a MATLAB/Octave based 3D mesh generation toolbox dedicated to the creation of high-quality multi-layered brain mesh models. === Requirement === Brain2Mesh is developed by the same team that developed the iso2mesh toolbox. Therefore iso2mesh is required. So if these toolboxes are not available on your computer, Brainstorm will download the last release and install it when it's needed. You may also need the [[https://www.fil.ion.ucl.ac.uk/spm/software/spm12/|SPM12 toolbox]]. Brain2mesh is used only to generate tetrahedral mesh from the segmentation output. Therefore a segmentation of the MRI will be performed by SPM when this option is called. More parameters will be added in the next version. If you are using this method you can request our support to help you or to add these parameters asap. === When and how to use it === This option is used when you have the individual MRI of the subject either T1 or T1 and T2. As said before, the SPM toolbox is required. The time required for this option is around 1 hour. here is the view of the obtained mesh from a T1 MRI {{attachment:brain2meshModel.JPG||height="450",width="600"}} As this option is based on the [[http://mcx.space/brain2mesh/|brain2mesh toolbox]], we keep the default options. We will add more flexibility to control these option in the next future. However, if you want to use this option and you need suppot, we can help... just post your question on the forum or email us. == Fieldtrip == This option call the [[http://www.fieldtriptoolbox.org/tutorial/headmodel_eeg_fem/|process]] of MRI segmentation (function ft_volumesegment) and hexahedral mesh generation (ft_meshprepare) integrated within simbio toolbox. === Requirement === To use this option, the [[http://www.fieldtriptoolbox.org/getting_started/|Fieldtrip]]and [[https://www.fil.ion.ucl.ac.uk/spm/software/spm12/|SPM toolbox]] should be in your matlab. === When and how to use it === The mesh generation process is faster. It converts all the voxels to hexahedral mesh. Only the hexahedral mesh is available for this method. You can either call this option from the MRI data or from any segmentation data available on the subject. This option can be called by two processes, either from the MRI or from any segmented tissue available on the brainstorm database. Right-click on the MRI (or the tissues), then "Generate FEM Mesh" then select Fieldtrip option. There are two parameters that the user needs to set, the downsampling of the volume and the node shift ratio. {{attachment:fieldTripMeshCall.jpg||height="380",width="650"}} If you have the MRI of the subject and Adaptative hexahedral mesh {{attachment:ernieFieldtrip.JPG||height="450",width="450"}} == SimNIBS == === Installation === Please follow the instructions on this [[https://simnibs.github.io/simnibs/build/html/installation/simnibs_installer.html|webapge]]''__ (new brainstorm page that explains how to generate the head model is under development)__'' in order to do the SimNibs software should be installed on your computer. === FEM Head model generation with SimNibs === This method used the SimNibs software. So to call this process, you need to download and install the SimNibs software, the process of the installation is explained in the SimNibs webpage : https://simnibs.github.io/simnibs/build/html/installation/simnibs_installer.html. When you have installed SimNibs, Brainstorm can call the main function used for the mesh generation frm the main graphical interface. Depemding on your computer performances, this process will take between 2 to 5 hours. We highly recommend to close all other running process and application on our computer in order to speed this process. 1- Create new subject within the current protocole 2- Load the T1 of the subject to the brainstorm database. 3- Associate a T2 mri to the subject if it's available (this is better for csf/skull/scalp segmentation) 4- Right click on the subject, select the "Generate FEM mesh" . Select "SIMNIBS", and choose "Tetrahedral element" and keep the other options to the default value. |
Line 48: | Line 136: |
=== Surface mesh generation from volume mesh === | https://www.fil.ion.ucl.ac.uk/spm/software/spm12/ == Tissue anisotropy estimation == === Brainsuite Installation [TODO] === |
Line 50: | Line 141: |
In this part you can generate your FEM mesh from surfaces that you can get fron the segmentation software (brainSuite, FreeSurfer ....). This process will - merge the surfaces, - check the self intersecting - fixe the size of the mesh - generate the volum mesh - visual checking ... - TODO : may be we can add some mesh auqlity measures ?? |
|
Line 77: | Line 152: |
* f there is a MRI file with the string "T2" in the subject anatomy folder, it will use it | * If there is a MRI file with the string "T2" in the subject anatomy folder, it will use it |
Line 79: | Line 154: |
=== FEM Head model generation with SimNibs === This method used the SimNibs software. So to call this process, you need to download and install the SimNibs software, the process of the installation is explained in the SimNibs webpage : https://simnibs.github.io/simnibs/build/html/installation/simnibs_installer.html. When you have installed SimNibs, Brainstorm can call the main function used for the mesh generation frm the main graphical interface. Depemding on your computer performances, this process will take between 2 to 5 hours. We highly recommend to close all other running process and application on our computer in order to speed this process. - Explain here the main steps with screenshots : 1- Create new subject within the current protocole 2- Load the T1 of the subject to the brainstorm database. 3- Associate a T2 mri to the subject if it's available (this is better for csf/skull/scalp segmentation) 4- Right click on the subject, select the "Generate FEM mesh" . Select "SIMNIBS", and choose "Tetrahedral element" and keep the other options to the default value. 5- When this process is finished, a new node will appear in the data base, which hase he name "FEM xxxV, (simNibs, yLayers)". This is the FEM mesh model generated from the T1. |
Realistic head model: FEM mesh generation
[TUTORIAL UNDER DEVELOPMENT: NOT READY FOR PUBLIC USE]
Authors: Takfarinas Medani
Introduction
This tutorial present the methods integrated to brainstorm used to generate the FEM mesh.
The FEM mesh is required for the finite element method computation. The FEM computation could be used for most of the known modalities : EEG/MEG forward problem, TMS or TDSC stimulation and for intracranial meodalities like sEEG and ECOG.
In this tutorial, we present the different methods available with brainstorm to generate the FEM mesh and how to use them from the brainstorm GUI.
Mesh tools
Brainstorm integrates a list of the open-source tools. These tools are commonly used by the FEM community to generate either tetrahedral or hexahedra mesh.
Here is the list of the available methods in brainstorm:
- iso2mesh: this option merges the brainstorm surfaces available on the subject and then generarte the tetrahedral mesh.
- Brain2mesh: this option uses the MRI available on the subject, then it calls SPMsegmentation of the volume into 5 tissues (white, gray, scf, skull and skin). After that it calls iso2mesh (internally) to generate the tetrahedral mesh.
- SimNibs : this option, recomended for realistic model, calls the headrecoprocess, it uses the MRIs of the subject, and then calls SPM and CAT for the segmentation. Then the mesh generation is performed internally by integrated tools (netgen, gmesh and meshfixe).
- Fieldtrip : this option call the Fieldtrip pipline, based on the segmentation of the MRI then the hexahedral mesh generation.
You can display the full list and a short description by right click on the MRI of the subject and then click the item "Generate FEM Mesh"
iso2mesh
iso2mesh is a matlab /octave-based mesh generation and processing toolbox. It can create 3D tetrahedral finite element (FE) mesh from surfaces, 3D binary and gray-scale volumetric images such as segmented MRI/CT scans.
Requirement
it If iso2mesh is not installed in your computer, Brainstrom will download the last release from this webpage and install it when it'is needed. However, you can also download the iso2mesh from the github and add it to your matlab path.
When and how to use it
iso2mesh is used as the basic option by brainstorm to generate FEM mesh from surfaces mesh.
Assuming the situation where you have surfaces mesh of your subject available and you have already computed the OpenMeegforward problem. If you want to use the duneuro FEM to compute the forward model, you need to generate the FEM mesh from a similar surface used by OpenMeeg Here is the way to do it :
- Richt click on the subject : In this way, brainstorm will load the inner, outer and the head from the subject data. if any of these surfaces is missing, an error will be displayed.
- Select the 'Generate FEM mesh' item,
- Select the iso2mesh option,
- Set the iso2mesh parameters,
- These options are used by the surf2mesh function.
Select either MergeMesh or MergeSurf.
Max tetrahedral volum : is the maximum volume of the tetrahedral element in the mesh. Pourcentage of the element to keep: parameter between 0-100%, it used to keep or not the original input surface nodes.
Also, a full example is explained in this page.
Here is a view of mesh obtained with different values of the Max volume = [10, 1, 0.1, 0.01] with a keep ratio = 100%.
From our experience, a value of 0,1 for the tetrahedral volume achieves similar results as the OpenMeeg computed from the same surfaces. We have also noticed that the result with v = 0,001 is almost similar to v = 0,01. Increasing the mesh resolution needs more time to generate the mesh, more time to perform the FEM computation and of course more memory to store the mesh in the disc.
If intersections are present on the surfaces mesh, the iso2mesh FEM mesh generation fails (tetgen) and an error will be displayed on the screen. If you face this problem, you need to check the surfaces and/or regenerate new surfaces from the MRI.
other application
You can also select any surface mesh, or multiple surfaces (with Shift key), on the brainstorm anatomy windows and then generate tetrahedral mesh by following the same steps explained above.
Here are some examples using only 2 tissues. This option could be useful for investigation of tissue influence on the EEG/MEG on the forwad solution or on the source localization, or analyzing only SEEG within brain volume ...
brain2mesh
Brain2Mesh is a MATLAB/Octave based 3D mesh generation toolbox dedicated to the creation of high-quality multi-layered brain mesh models.
Requirement
Brain2Mesh is developed by the same team that developed the iso2mesh toolbox. Therefore iso2mesh is required. So if these toolboxes are not available on your computer, Brainstorm will download the last release and install it when it's needed.
You may also need the SPM12 toolbox. Brain2mesh is used only to generate tetrahedral mesh from the segmentation output. Therefore a segmentation of the MRI will be performed by SPM when this option is called.
More parameters will be added in the next version. If you are using this method you can request our support to help you or to add these parameters asap.
When and how to use it
This option is used when you have the individual MRI of the subject either T1 or T1 and T2. As said before, the SPM toolbox is required. The time required for this option is around 1 hour. here is the view of the obtained mesh from a T1 MRI
As this option is based on the brain2mesh toolbox, we keep the default options. We will add more flexibility to control these option in the next future. However, if you want to use this option and you need suppot, we can help... just post your question on the forum or email us.
Fieldtrip
This option call the process of MRI segmentation (function ft_volumesegment) and hexahedral mesh generation (ft_meshprepare) integrated within simbio toolbox.
Requirement
To use this option, the Fieldtripand SPM toolbox should be in your matlab.
When and how to use it
The mesh generation process is faster. It converts all the voxels to hexahedral mesh. Only the hexahedral mesh is available for this method. You can either call this option from the MRI data or from any segmentation data available on the subject.
This option can be called by two processes, either from the MRI or from any segmented tissue available on the brainstorm database.
Right-click on the MRI (or the tissues), then "Generate FEM Mesh" then select Fieldtrip option. There are two parameters that the user needs to set, the downsampling of the volume and the node shift ratio.
If you have the MRI of the subject and
Adaptative hexahedral mesh
SimNIBS
Installation
Please follow the instructions on this webapge (new brainstorm page that explains how to generate the head model is under development)
in order to do the SimNibs software should be installed on your computer.
FEM Head model generation with SimNibs
This method used the SimNibs software. So to call this process, you need to download and install the SimNibs software, the process of the installation is explained in the SimNibs webpage : https://simnibs.github.io/simnibs/build/html/installation/simnibs_installer.html.
When you have installed SimNibs, Brainstorm can call the main function used for the mesh generation frm the main graphical interface. Depemding on your computer performances, this process will take between 2 to 5 hours. We highly recommend to close all other running process and application on our computer in order to speed this process.
1- Create new subject within the current protocole
2- Load the T1 of the subject to the brainstorm database.
3- Associate a T2 mri to the subject if it's available (this is better for csf/skull/scalp segmentation)
4- Right click on the subject, select the "Generate FEM mesh"
- Select "SIMNIBS", and choose "Tetrahedral element" and keep the other options to the default value.
The headreco function is fully integrated to brainstorm. With this option, brainstorm can reconstructs a tetrahedral head mesh from T1- and T2-weighted structural MR images. It runs also with only a T1w image, but it will achieve more reliable skull segmentations when a T2w image is supplied.
https://www.fil.ion.ucl.ac.uk/spm/software/spm12/
Tissue anisotropy estimation
Brainsuite Installation [TODO]
Volume generation from surface files
Volume generation from T1/T2 MRI data
You can also generate your own FEM head model and then load it to brainstorm. However the automatic head model generation from from imaging techniques are not accurate and most of the time visual checking are needed and manual correction are required.
==> this depends lagely on the quality of the T1/T2 MRI image(https://simnibs.github.io/simnibs/build/html/tutorial/head_meshing.html).
This step is based on the "roast" toolbox (link to roast : https://github.com/andypotatohy/roast
) that we adapted for the MEEG forward computation. If you want to generate your own FEM head model from an MRI, you will need to download these file (link), then run the bst process as explained here.
- If there is a MRI file with the string "T2" in the subject anatomy folder, it will use it
- Otherwise, if you select explicitly two MRI files with CTRL+Click, it will use the first one as the T1 and the second one as the T2 (this needs to be documented in the tutorial)
FEM Head model template
- Load the FEM volumic mesh (template created from ICBM T1 MRI using SimNibs)
- Load the surface mesh (template created also from ICBM using ICBM ) and then generates the volume mesh (either tetra or hexa) by calling the tetgen process cia iso2mesh toolbox (if hexa are desired, the tetra mesh will be converted to hexa ... )
https://github.com/brainstorm-tools/brainstorm3/issues/185#issuecomment-576749612
Head model based on the level set approach
TODO and Validate