|
Size: 5068
Comment:
|
Size: 5325
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| ''Authors: ***'' | ''Authors: Samuel Medina Villalon, Chinmay Chinara, Takfarinas Medani, Raymundo Cassani, Anand Joshi, Christian Bénar, Richard Leahy'' |
| Line 6: | Line 6: |
| Please note that this tutorial is intended for users already familiar with Brainstorm. It does not provide detailed explanations of the software's interface or theoretical foundations. For comprehensive introductory material, refer to the [[http://neuroimage.usc.edu/brainstorm/Tutorials#Get_started|Brainstorm introduction tutorials]]. | Please note that this tutorial is intended for users already familiar with Brainstorm. It does not provide detailed explanations of the software's interface or theoretical foundations. * For comprehensive introductory material, refer to the [[http://neuroimage.usc.edu/brainstorm/Tutorials#Get_started|Brainstorm introduction tutorials]]. * Make sure you complete the [[https://neuroimage.usc.edu/brainstorm/seeg/Introduction|CT to MRI co-registration]] and [[https://neuroimage.usc.edu/brainstorm/seeg/SeegContactLocalization|Contact localization and labeling]] advanced tutorial before proceeding any further. |
| Line 10: | Line 13: |
| <<TableOfContents(2,2)>> | <<TableOfContents(3,2)>> |
| Line 13: | Line 16: |
| {{attachment:gardel_logo.png||align="right",width="250px"}} |
|
| Line 15: | Line 20: |
| == Dataset description == Link to SEEG analysis dataset description. |
== Requirements == * Complete the [[https://neuroimage.usc.edu/brainstorm/seeg/Introduction|CT to MRI co-registration]] to have the data and the required anatomy set up. * Follow the tutorial [[https://neuroimage.usc.edu/brainstorm/seeg/SeegContactLocalization#Generate_isosurface|Contact localization and labeling]] to generate the isosurface from the CT with a threshold of '''2400''' Hounsefiled Unit. This threshold plays a key part in the automatic detection as the the better segmented the electrodes are the better is the detection. After much trial and error, 2400 threshold gave the best results. * GARDEL [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|brainstorm plugin]] needs to be installed for doing the automatic detection of the contacts. |
| Line 18: | Line 25: |
| == Download and installation == * '''Prerequisites''': * '''Brainstorm Installation''': Ensure you have a working copy of Brainstorm installed on your computer. * '''Familiarity with Brainstorm''': This tutorial assumes that you have completed all the [[https://neuroimage.usc.edu/brainstorm/Tutorials|Brainstorm introduction tutorials]] and are comfortable with its interface and basic functionalities. * '''SPM12 (Statistical Parametric Mapping)''' * '''Purpose''': SPM12 is required for: * Coregistration between pre-implantation MRI and post-implantation CT volumes. * Utilizing [[https://andysbrainbook.readthedocs.io/en/latest/SPM/SPM_Short_Course/SPM_04_Preprocessing/04_SPM_Segmentation.html|tissue segmentation masks]] to remove extracranial regions from the CT. * '''Installation''': * '''MATLAB Users''': If you are running Brainstorm within MATLAB, install SPM12 either as a [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|Brainstorm plugin]] or through a custom installation. * '''Standalone Brainstorm Users''': If you are using the standalone compiled version of Brainstorm, SPM12 functionalities are included in the executable, and no additional installation is necessary. * '''GARDEL''' [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|Brainstorm plugin]] needs to be installed for doing the automatic detection of the contacts. == Import the anatomy == Link to SEEG analysis tutorial to import the MRI and CT along with generating the CAT12 surfaces. '''TODO: Add relevant screenshots<<BR>><<BR>>''''''TODO: Talk about working in the CT space (better resolution -> better automatic localization)''' == Contact localization == === Generate Isosurface === * Link to SEEG analysis tutorial to create a thresholded mesh from the CT. * Talk about why this is required for automatic detection '''TODO: Add relevant screenshots''' === Automatic contact localization using GARDEL === |
== Automatic contact localization using GARDEL == |
| Line 45: | Line 27: |
| * Choose '''MRI+CT+IsoSurf''' from the popup menu (more details about the menu can be found [[https://neuroimage.usc.edu/brainstorm/Tutorials/SeizureFingerprinting#Start_implantation|here]]). This takes you to the functional tab. '''Subject01 > Implantation > SEEG/ECOG (0)''' channel gets created. All expected figures open up. Panel iEEG loads up in the panel viewer. * Click on '''Auto > GARDEL'''. Click '''Yes''' on the disclaimer that pops up. * In few minutes, you can see the electrodes being rendered live on the figures. While GARDEL is a great tool but there could be some bad detections due to factors mentioned in the disclaimer. It is always good to verify the results carefully. * If there are any bad detections, they can be post-processed using editing features available within Brainstorm. More details can be found [[https://neuroimage.usc.edu/brainstorm/seeg/SeegContactLocalization#Edit_the_contacts_positions|here]]. '''TODO: Show some bad detections with this tutorial data and steps how to correct them here''' '''TODO: Add relevant screenshots''' |
* Choose '''MRI+CT+IsoSurf''' from the popup menu (more details about the menu can be found [[https://neuroimage.usc.edu/brainstorm/seeg/SeegContactLocalization#Start_implantation|here]]). While any of the options can be chosen from the menu, this gives the option to visualize and interact both in 3D and 2D. * In the iEEG panel, click on '''Electrodes > Automatic localization > GARDEL'''. Click '''Yes''' on the disclaimer that pops up.<<BR>><<BR>> {{attachment:auto_gardel_menu.png||width="450"}} <<BR>><<BR>> {{attachment:2_disclaimer.png||width="350"}} * In few minutes, you can see the electrodes being rendered live on the figures.<<BR>><<BR>> {{attachment:1_gardel_detect.png||width="650"}} * While GARDEL is a great tool but there could be some bad detections (that can be seen above) due to factors mentioned in the disclaimer. It is always good to verify the results carefully. * This is a particularly complex case and it can be seen that there are that there are a lot of overlapping and concentrated electrodes that are mostly touching and they are difficult to separate. GARDEL does fail to detect them and would require manual correction. It can very well be achieved using the editing features available within Brainstorm. More details can be found [[https://neuroimage.usc.edu/brainstorm/seeg/SeegContactLocalization#Edit_the_contacts_positions|here]]. |
| Line 55: | Line 34: |
| === Forum discussions === | |
| Line 57: | Line 35: |
| * S. Medina Villalon, R. Paz, N. Toehri, S. Lagarde, F. Pizzo, B. Colombet, F. Bartolomei, R. Carron, C.-G. Bénar. [[https://doi.org/10.1016/j.jneumeth.2018.03.018|EpiTools, A software suite for presurgical brain mapping in epilepsy: Intracerebral EEG]]. <<BR>> Journal of Neuroscience Methods 2018. |
|
| Line 58: | Line 38: |
| * [[https://neuroimage.usc.edu/brainstorm/seeg/Introduction|CT to MRI co-registration]] * [[https://neuroimage.usc.edu/brainstorm/seeg/SeegContactLocalization|Contact localization and labeling]] * [[https://neuroimage.usc.edu/brainstorm/seeg/SeizureFingerprinting|Time-Frequency Fingerprint Analysis for Epileptogenic Zone Localization]] * [[https://neuroimage.usc.edu/brainstorm/Tutorials/Epileptogenicity|Epileptogenicity]] |
Automatic SEEG Contact Localization using GARDEL
Authors: Samuel Medina Villalon, Chinmay Chinara, Takfarinas Medani, Raymundo Cassani, Anand Joshi, Christian Bénar, Richard Leahy
This tutorial describes how to perform automatic SEEG contact localization in Brainstorm using GARDEL.
Please note that this tutorial is intended for users already familiar with Brainstorm. It does not provide detailed explanations of the software's interface or theoretical foundations.
For comprehensive introductory material, refer to the Brainstorm introduction tutorials.
Make sure you complete the CT to MRI co-registration and Contact localization and labeling advanced tutorial before proceeding any further.
NOT FOR CLINICAL USE:
The methods and software implementations presented in this tutorial have not been certified as medical devices. They are intended for research purposes only and should not be used for clinical decision-making.
Contents
Introduction
GARDEL (GUI for Automatic Registration and Depth Eectrode Localization) was developed by a multidisciplinary team as part of the EpiTools suite, led by Samuel Medina Villalon (Aix‑Marseille University & AP‑HM, Marseille), Rodrigo Manuel Paz (University of Buenos Aires–CONICET), Nicolas Roehri, Stanislas Lagarde, Fabrice Pizzo, Bruno Colombet, Fabrice Bartolomei, Romain Carron, and Christian Bénar, all contributing through INSERM and partnering institutions across France, Argentina, and Switzerland. This international group combined clinical neurophysiology and advanced imaging expertise to create GARDEL, enabling fully automatic detection and anatomical labeling of SEEG contacts thereby laying a strong foundation for streamlining SEEG analysis in research workflows.
Requirements
Complete the CT to MRI co-registration to have the data and the required anatomy set up.
Follow the tutorial Contact localization and labeling to generate the isosurface from the CT with a threshold of 2400 Hounsefiled Unit. This threshold plays a key part in the automatic detection as the the better segmented the electrodes are the better is the detection. After much trial and error, 2400 threshold gave the best results.
GARDEL brainstorm plugin needs to be installed for doing the automatic detection of the contacts.
Automatic contact localization using GARDEL
Right click on Subject01, and choose SEEG/ECOG implantation.
Choose MRI+CT+IsoSurf from the popup menu (more details about the menu can be found here). While any of the options can be chosen from the menu, this gives the option to visualize and interact both in 3D and 2D.
In the iEEG panel, click on Electrodes > Automatic localization > GARDEL. Click Yes on the disclaimer that pops up.
In few minutes, you can see the electrodes being rendered live on the figures.
- While GARDEL is a great tool but there could be some bad detections (that can be seen above) due to factors mentioned in the disclaimer. It is always good to verify the results carefully.
This is a particularly complex case and it can be seen that there are that there are a lot of overlapping and concentrated electrodes that are mostly touching and they are difficult to separate. GARDEL does fail to detect them and would require manual correction. It can very well be achieved using the editing features available within Brainstorm. More details can be found here.
Additional Documentation
Articles
S. Medina Villalon, R. Paz, N. Toehri, S. Lagarde, F. Pizzo, B. Colombet, F. Bartolomei, R. Carron, C.-G. Bénar. EpiTools, A software suite for presurgical brain mapping in epilepsy: Intracerebral EEG.
Journal of Neuroscience Methods 2018.