Differences between revisions 121 and 200 (spanning 79 versions)

iEEG Contact Localization

Authors: Chinmay Chinara, Takfarinas Medani, Raymundo Cassani, Anand Joshi.

Detection, localization and labelling of SEEG depth electrodes is a vital step in studying brain activity.

Note that the operations used here are not detailed, the goal of this tutorial is not to introduce Brainstorm to new users. For in-depth explanations of the interface and theoretical foundations, please refer to the introduction tutorials.

NOT FOR CLINICAL USE:
The performance characteristics of the methods and software implementation presented in this tutorial have not been certified as medical devices and should be used for research purposes only.

Contents

Dataset description
Download and installation
Import the anatomy
Electrode labeling and contact localization (Manual)
Electrode labeling and contact localization (Automatic)
Appendix
Additional Documentation

Dataset description

License

This tutorial dataset (sEEG and MRI data) remains property of the Cleveland Clinic, Ohio, USA. Its use and transfer outside the Brainstorm tutorials, e.g. for research purposes, is prohibited without written consent. For questions, please contact Kenneth Taylor, PhD ( taylork2@ccf.org ).

SEEG recordings

The depth electrodes used in this example dataset are PMT SEEG Depth Electrodes, with the following specifications:

Diameter: 0.8 mm
Contact length: 2 mm
Insulator length: 1.5 mm
Distance between the center of two contacts: 3.5 mm
Between 8 and 16 contacts on each electrode

Files

tutorial_seeg_implantation/

preMRI.nii: MRI before the implantation of the sEEG.
postCT.nii: CT after the implantation of the sEEG.
All the anatomical images have been de-identified with defacing from Brainstorm.

Download and installation

Requirements: You have already followed all the introduction tutorials and you have a working copy of Brainstorm installed on your computer.
BrainSuite (optional): Make sure you have the latest version of BrainSuite installed. Follow steps as per the BrainSuite for Brainstorm tutorial. This is required to perform skull stripping when importing CT below in order to remove extracranial regions from the CT.
SPM: If you are running Brainstorm from the MATLAB environment, you need to have the SPM12 toolbox installed on your computer, as a Brainstorm plugin or a custom installation.
With the stand-alone compiled version of Brainstorm: all the needed SPM scripts have been compiled and included in the executable. This is required for two purposes:
- Coregistration between pre-implantation MRI and post-implantation CT volumes.
- Use mask from SPM based tissue segmentation to remove extracranial regions from the CT.
ct2mrireg: To have an alternate way of doing the coregistration between pre-implantation MRI and post-implantation CT volumes, you need to have the ct2mrireg plugin installed on your computer, as a Brainstorm plugin. It can be found under the menu Plugins > Anatomy > ct2mrireg. If using Brainstorm with MATLAB, please install the Image Processing Toolbox.
Download the dataset:
- Go to the Download page of this website, and download the file: tutorial_seeg_implantation.zip.
- Unzip it in a folder that is not in any of the Brainstorm folders (program folder or database folder).
Brainstorm:
- Start Brainstorm
- Select the menu File > Create new protocol. Name it "TutorialSeegImplantation" and select the options:
  "No, use individual anatomy",
  "No, use one channel file per acquisition run".

Import the anatomy

Pre-implantation MRI

Right-click on the TutorialSeegImplantation folder > New subject > Subject01.
Keep the default options you defined for the protocol.
Switch to the Anatomy view of the protocol.
Right-click on the subject node > Import MRI.
Set the file format: MRI: NIfTI-1 (*.nii;*.nii.gz).
Select: tutorial_seeg_implantation/preMRI.nii
The MRI viewer opens automatically. Click on "Click here to compute MNI normalization", option "maff8". This method is embedded in Brainstorm and does not require the installation of SPM12. However, it requires the automatic download of the file SPM12 Tissue Probability Maps. If you do not have access to internet, see the instructions on the Installation page. It is based on an affine co-registration with the MNI ICBM152 template from the SPM software, described in the following article: Ashburner J, Friston KJ, Unified segmentation, NeuroImage 2005..
Click on Save to close the MRI viewer. New node name preMRI is created.

Post-implantation CT

The pre-implantation MRI will be used as the anatomical reference for this subject. We will now import a second scan done after the SEEG implantation, on which we can see the SEEG contacts. In this dataset, the post-implantation volume is a CT scan (contacts hypersignal appear in white).

Right-click on the subject node > Import CT.
Select: tutorial_seeg_implantation/postCT.nii
Choose No for the NIfTI Scaling. The data scaling feature allows the storage in a wider range than what would be allowed by the datatype. For more info check here.
Choose Yes for the transformation for MRI orientation.
Choose SPM for coregistration.
Choose Yes for reslicing so that the CT voxel dimensions match those of the MRI.
Choose SPM for skull stripping to remove any non-brain tissues as we need just the electrodes inside the brain.
The MRI viewer opens automatically, showing the post-implantation CT volume as a colored layer on top of the previous volume. Adjust the transparency and amplitude threshold of this layer in the section Data options of the Surface tab, adjust its colormap with the popup menu of the figure. Use this display to validate that the coregistration of the two volume is correct, all the parts of the head must align well.
New node named postCT_spm_reslice_masked_spm is created. The postfix _spm_reslice_masked_spm indicates the different processes it has gone through. Rename the node to postCT for simplicity. This will not change the associated file in the database. To see the history of the processes, right click on postCT > File > View file history.
To just view the CT File, right click on postCT > Display > MRI Viewer.

Generate isoSurface

This creates a thresholded mesh from the CT to separate the contacts out from rest of the CT. This aids the user towards localization of the electrodes and its contacts more accurately.

Right click on postCT > CT segmentation > Generate threshold mesh from CT.
This will bring the Generate isosurface window. This window shows 4 values: the Background level, White level, Max Intensity and the suggested Set isoValue, all of them given in the Hounsfield Unit (HU) scale. The first 3 values are calculated automatically from the histogram of the CT and are displayed for reference to help the user to decide on what to set the isoValue for getting a good thresholded mesh. The editable isoValue field shows an estimated best guess based on mean of White Level and Max Intensity. Just let that value be and press OK.
An isosurface is generated showing the contact as blobs overlayed on the 3D MRI slices. The Thresh slider under Surface options can be used to fine tune and regenerate mesh with different isoValues.

Electrode labeling and contact localization (Manual)

Get started

Right click on Subject01, and choose SEEG/ECOG implantation.
The SEEG/ECOG implantation menu pops to choose which modalities you want to use for doing your implantation with. Choose MRI+CT+IsoSurf. This takes you to the functional tab. Subject01 > Implantation > SEEG/ECOG (0) channel gets created. An MRI Viewer loads up with the CT overlayed on the MRI. A 3D figure loads up with isoSurface and 3D MRI. Panel iEEG loads up in the panel viewer. Move around the 3D slices to get a clear view of the contacts so that they can be clicked on.

Go to section Panel iEEG in Appendix to know more about the panel and its features.

Create electrodes and plot contacts manually

After performing steps above, we will have the Panel iEEG along with the MRI Viewer and 3D figures open. We will be working on the electrode marked below.
On Panel iEEG Click on the + (Add new electrode). This opens up the Add electrode window. Enter anything under Electrode label based on your convention. For this e.g., enter A and press OK.
This creates an electrode A in selected state, and at the bottom the Electrode configuration section of the panel becomes active. Select the following:
- Type: SEEG
- Model: Choose PMT 2102-16-091/2102-16-101 from the drop down list. This will automatically set the other parameters in the section. More details for these parameters can be found in the advanced section here.
Set tip: Click the button (shortcut: Ctrl+P) and choose the contact (deepest contact) for the electrode in the isosurface in 3D figure which is going to be set as the tip. This should plot a yellow crosshair marker point on the blob and also update the MRI Viewer's crosshair. At the bottom in Panel iEEG click Set tip and the button turns green indicating that the tip has been set. This point in 3D is at the centroid of the blob which gives a more accurate location of the contact compared to the same if chosen from the MRI.

If the contact blobs are joined then you can adjust using the Thresh slider as mentioned in the Generate isoSurface section to separate the blobs from one another.

Set skull entry: Choose the point in the isoSurface in 3D figure which is going to be set as the skull entry. This point can be any of the contacts other than the tip preferably closer to the skull so that we get an orientation of the electrode. This should plot a yellow crosshair marker point on the blob and also update the MRI Viewer's crosshair. At the bottom in Panel iEEG click Set skull entry and the button turns green indicating that the entry point has been set. The properties used for setting the position of the contacts are the contact spacing, the tip of the electrode and the entry point in the skull. Contact #i is placed along the electrode at (i-1)*contact_spacing millimeters from the tip of the electrode. The MRI Viewer gets updated with the an electrode based on the above configuration.
Click on Contacts > Save Modifications to update the channel information.
When you are done with everything, click on Save in the MRI Viewer. It saves the new channel file and updates the number of channels in the database explorer. Also, while closing the windows a prompt appears asking to save the changes. Just click Yes for everything.

In some cases, additional correction of the contacts may be required. To edit the individual contacts refer to the Edit contact positions section below.

Edit contact positions

TODO: Add the dataset used for curved electrode contact editing.

Until now, we have seen cases where the trajectory of an electrode always follows a straight line but practically that is not the case as there could be bending introduced when the neurosurgeon inserts the electrode. In such cases we need to move most of the intermediate contacts to more appropriate positions.

Let's take the case of a curved electrode. If no figures are loaded then right click on your Subject > SEEG/ECOG implantation. Click Continue for working on the existing implantation. Choose MRI+CT+IsoSurf to show the figures. Select the 3D figure and toggle between the electrode ( ) and sphere ( ) modes to get the figures as under using buttons in Panel iEEG. Keep it in the sphere mode for better visibility. The contacts definitely need to be corrected and moved to their right positions.
Display the contact labels in 3D figure by right clicking Channels > Display labels. It can be seen that the contacts A2-A15 are incorrect. Let us first correct contact A2.
Since the isoSurface blobs are the correct ones, we can use them as ground truth guide to correct the contacts. Click the button (shortcut: Ctrl+P) and choose the correct blob. That places a yellow crosshair on the blob and updates the MRI Viewer crosshair as well.
Without clicking anywhere else, move your courser to the MRI Viewer, right click and go to Electrodes > Set electrode position (or press Ctrl+S). From the Set electrode position window choose A2 and press OK. This will update the position of A2 only in the MRI Viewer.
Click on Save and it closes all the windows and updates the channel file and number of channels in the database explorer.
Right click on the Subject > SEEG/ECOG implantation. Click Continue for working on the existing implantation. Choose MRI+CT+IsoSurf to show all the figures. Select the 3D figure and in the Panel iEEG, choose the sphere ( ) mode for display. You will now see the updated contact in the 3D figure as well.
Follow the above steps to update all the remaining contacts as required. Unfortunately, Brainstorm currently does not have a way to handle curved electrodes display yet: if you move the contacts, the electrode remains represented as a straight line. This is a display issue only, which has no impact on any computation, but we hope to improve it at some point.
We have a functionality called line fitting that can help better view the trajectory in the 3D figure with sphere ( ) display mode. Choose the electrode and click Contacts > Show/Hide line fit through contacts.

Electrode labeling and contact localization (Automatic)

This is currently under preparation. In the meantime, you can refer to this abstract:
Automatic SEEG Contact Localization and Labeling using Brainstorm presented at AES 2024.

Appendix

Panel iEEG

When opening SEEG/ECOG recordings, the panel iEEG is added to the Brainstorm window. You can use it to edit the display properties of the depth electrodes. In this interface, "electrode" refers to entire depth electrode implanted in the head of the patient while "contact" refers to recording sites on the electrode. There are multiple contacts on an electrode, and one contact corresponds to one channel of data in the channel file and the recordings.
SEEG depth electrodes are graphical objects, they are defined independently from the SEEG contacts available in the channel file and recordings. A contact/channel is associated to a depth electrode using the Group property of the channel, accessible with a right-click on the channel file > Edit channel file.
In this example, the depth electrodes available in the Panel iEEG have been manually set by using this Panel features. In the convention used here, the contact names must start with one or more letters (the name of the electrode) followed by a number representing the index of the contact on the electrode. Contact #1 is at the tip of the electrode, and is therefore the deeper contact of the electrode. If the convention used in your recordings is different, you may have to edit the electrodes properties in order to get them displayed correctly.
Buttons in the toolbar:
- Coordinates (millimeters) radio buttons: Users can switch between the different coordinate systems (SCS, MRI, World, MNI) to change the coordinate values of the contacts.
- (Add new electrode): Adds an entry for a new depth electrode. The new electrode will not be displayed until you set its properties and position. This will not add or remove SEEG contacts or channels of data.
- (Remove selected electrodes): Deletes a depth electrode from the list, but does not modify the list of SEEG contacts or channels of data.
- (Select surface point): Activates coordinate selection in 3D figure window. (Shortcut: Ctrl+P)
- (Set color for selected electrodes): Self explanatory.
- (Show/hide selected electrodes): To hide an electrode in the 3D figures and MRI viewer, select it in the list then click on this button. Select all the electrodes with the standard shortcut Ctrl+A.
- Display contacts as: (Depth electrodes) / (Spheres).
- Contacts > Set default positions: For each of the selected electrodes, the current positions of the SEEG contacts are discarded and replaced with the default positions of the contacts on the electrode. The properties used for setting the position of the contacts are the contact spacing, the tip of the electrode and the entry point in the skull. Contact #i is placed along the electrode at (i-1)*contact_spacing millimeters from the tip of the electrode.
- Contacts > Project on electrode: For each of the selected electrodes, the contacts are projected orthogonally on the electrode. This menu can be useful for aligning contacts that were marked one by one.
- Contacts > Show/Hide line fit through contacts: Performs line fitting through the contacts in 3D figure.
- Contacts > Save modifications: Save the current modifications to the channel file. Otherwise, the modifications are saved only when you close the figure (dialog box "Save modifications to channel file?")
- Contacts > Export contacts positions: Save the 3D positions of the SEEG contacts in a text file, using one of the file formats supported by Brainstorm.
Electrode properties: Properties that have an impact on the position of the contacts. If you edit the properties, the modifications will apply to all the selected electrodes in the current channel file. Check what is selected before making changes.
- Type: SEEG/ECOG
- Model: List of electrode models. If you select an entry in this menu, it will copy the default properties for this model to the selected electrodes. If you are using electrodes that are not in this list, please post on the specification of your devices on the user forum and we will add them to this list.
- Number of contacts: Number of recording sites on the electrode. By default, this is set for SEEG to the maximum index found in a group of contacts. Example: electrode A is associated to channels A1, A2...A14 => detected number of contacts is 14.
- Contact spacing: Distance between the centers of two consecutive contacts in the electrode. In this example dataset, the default value corresponds to the average distance observed between pairs of adjacent contacts.
- Set tip: Select one electrode in the list, then move the cursor of the MRI viewer to the tip of the selected electrode (center of the first contact) or choose the contact from the isoSurface in the 3D figure and finally click on [Set tip].
- Set skull entry: Select one electrode in the list, then move the cursor of the MRI viewer to the point where the depth electrode enters the skull or choose the point from the isoSurface in the 3D figure, and finally click on [Set skull entry]. This position does not actually correspond to any contact, it is used only to estimate the direction of the depth electrode. More details.
- Display options: Properties that only affect the way the electrodes are renderer graphically.
- Contact length: Defines the length of the yellow cylinder that represents the contacts along the electrode axis, or the diameter of the sphere when the electrodes are not rendered.
- Contact diameter: Diameter of the yellow cylinders representing the contacts. By default, this value is slightly larger than the electrode diameter so that it is rendered correctly. If you use the same value as the electrode diameter, the contacts might not be visible.
- Electrode diameter: Diameter of the cylinder representing the SEEG depth electrode.
- Electrode length: Length of the cylinder representing the SEEG depth electrode.

-  ⇤ ← Revision 121 as of 2024-06-26 00:46:45 → 
  Size: 22667
  Editor: ChinmayChinara
  Comment:
+   ← Revision 200 as of 2024-12-03 22:22:21 → ⇥
  Size: 24613
  Editor: ChinmayChinara
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-= iEEG Contact Localization (UNDER CONSTRUCTION) =
+= iEEG Contact Localization =
 Line 3:
-'''THIS TUTORIAL CURRENTLY''' '''COVERS SEEG STUDY ONLY. ECOG STUDY IS UNDER WORKS AND WILL BE MERGED HERE VERY SOON.'''
-Line 12:
+Line 10:
-<<TableOfContents(3,2)>>
+<<TableOfContents(2,2)>>
-Line 15:
+Line 13:
+=== License ===
This tutorial dataset  (sEEG and MRI data) remains property of the  Cleveland Clinic, Ohio, USA. Its use and transfer outside the Brainstorm tutorials,  e.g. for research purposes, is prohibited without written consent. For questions, please contact Kenneth Taylor, PhD  ( taylork2@ccf.org ).
-Line 35:
+Line 36:
- * '''BrainSuite''': Make sure you have the latest version of BrainSuite installed. Follow steps as per the [[https://neuroimage.usc.edu/brainstorm/Tutorials/BstBrainSuite|BrainSuite for Brainstorm]] tutorial. This is required to perform [[https://brainsuite.org/processing/surfaceextraction/bse/|skull stripping]] when importing CT below in order to remove extracranial regions from the CT.
 * '''SPM''': If you are running Brainstorm from the MATLAB environment, you need to have the SPM12 toolbox installed on your computer, as a [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|Brainstorm plugin]] or a custom installation. <<BR>>With the stand-alone compiled  version of Brainstorm: all the needed SPM scripts have been compiled and  included in the executable.
 * '''ct2mrireg''': If you are running Brainstorm from the MATLAB environment,  for the coregistration between pre-implantation MRI and post-implantation CT volumes,  you need to have the '''ct2mrireg''' plugin installed on your computer, as a [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|Brainstorm plugin]]. It can be found under the menu '''Plugins > Anatomy > ct2mrireg'''. If using [[https://neuroimage.usc.edu/brainstorm/Installation#Start_Brainstorm|Brainstorm from MATLAB]], please install the [[https://www.mathworks.com/products/image-processing.html|Image Processing Toolbox]].
+ * '''BrainSuite (optional)''': Make sure you have the latest version of BrainSuite installed. Follow steps as per the [[https://neuroimage.usc.edu/brainstorm/Tutorials/BstBrainSuite|BrainSuite for Brainstorm]] tutorial. This is required to perform [[https://brainsuite.org/processing/surfaceextraction/bse/|skull stripping]] when importing CT below in order to remove extracranial regions from the CT.
 * '''SPM''': If you are running Brainstorm from the MATLAB environment, you need to have the SPM12 toolbox installed on your computer, as a [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|Brainstorm plugin]] or a custom installation. <<BR>>With the stand-alone compiled  version of Brainstorm: all the needed SPM scripts have been compiled and  included in the executable. This is required for two purposes:
  * Coregistration between pre-implantation MRI and post-implantation CT volumes.
  * Use mask from [[https://andysbrainbook.readthedocs.io/en/latest/SPM/SPM_Short_Course/SPM_04_Preprocessing/04_SPM_Segmentation.html|SPM based tissue segmentation]] to remove extracranial regions from the CT.
 * '''ct2mrireg''': To have an alternate way of doing the coregistration between pre-implantation MRI and post-implantation CT volumes,  you need to have the '''ct2mrireg''' plugin installed on your computer, as a [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|Brainstorm plugin]]. It can be found under the menu '''Plugins > Anatomy > ct2mrireg'''. If using [[https://neuroimage.usc.edu/brainstorm/Installation#Start_Brainstorm|Brainstorm with MATLAB]], please install the [[https://www.mathworks.com/products/image-processing.html|Image Processing Toolbox]].
-Line 49:
+Line 52:
- * Right-click on the subject node > '''Import MRI'''.<<BR>>Set the file format: "All MRI file (subject space)".<<BR>>Select: '''tutorial_seeg_implantation/preMRI.nii'''
 * Do you want to apply the transformation to the MRI file? '''Yes'''
+ * Right-click on the subject node > '''Import MRI'''.<<BR>>Set the file format: '''MRI: NIfTI-1 (*.nii;*.nii.gz)'''.<<BR>>Select: '''tutorial_seeg_implantation/preMRI.nii'''
-Line 52:
+Line 54:
- * Click on '''Save''' to close the MRI viewer.
 * Rename the new file: '''preMRI'''. <<BR>><<BR>> {{attachment:3.png}}
+ * Click on '''Save''' to close the MRI viewer. New node name '''preMRI''' is created.<<BR>><<BR>> {{attachment:3.png}}
-Line 59:
+Line 60:
- * Choose '''No''' for the '''NifTI Scaling'''. TODO-EXPLANATION
 * Choose '''Yes''' for the transformation for '''MRI orientation'''.
 * Choose '''CT2MRI''' and '''Yes''' for reslicing so that we can overlay the CT on the MRI.<<BR>><<BR>> {{attachment:coreg_ct.png}}
 * Choose '''Yes''' for the '''Clean the CT volume''' as we are just concerned with the electrodes inside the skull. [[https://brainsuite.org/processing/surfaceextraction/bse/|BrainSuite's skull stripping]] is used to mask out regions outside the skull.<<BR>><<BR>> {{attachment:coreg_clean_ct.png||width="320"}}
+ * Choose '''No''' for the '''NIfTI Scaling'''. The data scaling feature allows the storage in a wider range than what would be allowed by the datatype. For more info check [[https://brainder.org/2012/09/23/the-nifti-file-format/|here]].
 * Choose '''Yes''' for the transformation for '''MRI orientation'''.<<BR>>Choose '''SPM''' for coregistration.<<BR>>Choose '''Yes''' for reslicing so that the CT voxel dimensions match those of the MRI. <<BR>><<BR>> {{attachment:coreg_ct.png}}
 * Choose '''SPM''' for skull stripping to remove any non-brain tissues as we need just the electrodes inside the brain.<<BR>><<BR>> {{attachment:coreg_clean_ct.png}}
 Line 64:
- * Rename the new file: '''postCT'''.<<BR>><<BR>> {{attachment:5.png}}
+ * New node named '''postCT_spm_reslice_masked_spm''' is created.  The postfix '''_spm_reslice_masked_spm''' indicates the different processes it has gone through. Rename the node to '''postCT''' for simplicity. This will not change the associated file in the database. To see the history of the processes, right click on '''postCT > File > View file history'''.<<BR>><<BR>> {{attachment:5.png||width="350"}}
 * To just view the CT File, right click on '''postCT > Display > MRI Viewer'''.<<BR>><<BR>> {{attachment:disp_ct.png||width="400"}}
-Line 69:
+Line 70:
- * Right click on '''postCT > CT segmentation > Generate threshold mesh from CT'''.<<BR>><<BR>> {{attachment:6.png||width="320"}}
+ * Right click on '''postCT > CT segmentation > Generate threshold mesh from CT'''.<<BR>><<BR>> {{attachment:6.png||width="350"}}
-Line 73:
+Line 74:
-== Electrode labelling and contact localization ==
+== Electrode labeling and contact localization (Manual) ==
-Line 75:
+Line 76:
- * Right click on '''postCT''', and choose '''SEEG/ECOG implantation'''. This takes you to the functional tab and '''Subject01 > Implantation > SEEG/ECOG (0)''' channel gets created. Also the '''MRI Viewer with the CT''' loaded and '''3D Viz with the isoSurface+3D MRI Slices''' loaded open up along with the '''Panel iEEG'''. Move around the 3D slices to get a clear view of the contacts so that they can be clicked on. [[https://neuroimage.usc.edu/brainstorm/Tutorials/ExploreAnatomy#MRI_in_3D|This section]] explains the controls. <<BR>><<BR>> {{attachment:9.png}}
+ * Right click on '''Subject01''', and choose '''SEEG/ECOG implantation'''.
 * The '''SEEG/ECOG implantation''' menu pops to choose which modalities you want to use for doing your implantation with. Choose '''MRI+CT+IsoSurf'''. This takes you to the functional tab. '''Subject01 > Implantation > SEEG/ECOG (0)''' channel gets created. An MRI Viewer loads up with the CT overlayed on the MRI. A 3D figure loads up with isoSurface and 3D MRI. '''Panel iEEG''' loads up in the panel viewer. Move around the 3D slices to get a clear view of the contacts so that they can be clicked on.<<BR>><<BR>> {{attachment:implant_menu.png}} <<BR>><<BR>> {{attachment:9.png||width="600"}}
-Line 77:
+Line 79:
+{{{#!wiki note
Go to section [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Panel_iEEG|Panel iEEG]] in Appendix to know more about the panel and its features.
}}}
=== Create electrodes and plot contacts manually ===
 * After performing steps above, we will have the Panel iEEG along with the MRI Viewer and 3D figures open. We will be working on the electrode marked below.<<BR>><<BR>> {{attachment:target_elec.png}}
 * On '''Panel iEEG''' Click on the '''+ (Add new electrode)'''. This opens up the '''Add electrode''' window. Enter anything under '''Electrode label''' based on your convention. For this e.g., enter '''A''' and press '''OK'''.<<BR>><<BR>> {{attachment:12.png||width="250"}}
 * This creates an electrode '''A''' in selected state, and at the bottom the '''Electrode configuration''' section of the panel becomes active. Select the following:
  * Type: '''SEEG'''
  * Model: Choose '''PMT 2102-16-091/2102-16-101''' from the drop down list. This will automatically set the other parameters in the section. More details for these parameters can be found in the advanced section [[https://neuroimage.usc.edu/brainstorm/Tutorials/Epileptogenicity#On_the_hard_drive|here]].<<BR>><<BR>> {{attachment:13.png||width="250"}}

 * '''Set tip''':  Click the {{attachment:iconScoutNew.gif}} button (shortcut: Ctrl+P) and choose the contact (deepest contact) for the electrode in the isosurface in 3D figure which is going to be set as the tip. This should plot a yellow crosshair marker point on the blob and also update the MRI Viewer's crosshair. At the bottom in '''Panel iEEG''' click '''Set tip''' and the button turns green indicating that the tip has been set. '''This point in 3D is at the centroid of the blob which gives a more accurate location of the contact compared to the same if chosen from the MRI'''.<<BR>><<BR>> {{attachment:15.png||width="600"}}

{{{#!wiki tip
If the contact blobs are joined then you can adjust using the '''Thresh''' slider as mentioned in the [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Generate_isoSurface|Generate isoSurface]] section to separate the blobs from one another.
}}}
 * '''Set skull entry''': Choose the point in the isoSurface in 3D figure which is going to be set as the skull entry. This point can be any of the contacts other than the tip preferably closer to the skull so that we get an orientation of the electrode. This should plot a yellow crosshair marker point on the blob and also update the MRI Viewer's crosshair. At the bottom in '''Panel iEEG''' click '''Set skull entry''' and the button turns green indicating that the entry point has been set. The properties used for setting the position of the contacts are the '''contact spacing, the tip of the electrode and the entry point in the skull'''. '''Contact #i''' is placed along the electrode at '''(i-1)*contact_spacing millimeters''' from the tip of the electrode. The MRI Viewer gets updated with the an electrode based on the above configuration. <<BR>><<BR>> {{attachment:16.png||width="600"}}
 * Click on '''Contacts > Save Modifications''' to update the channel information. <<BR>><<BR>> {{attachment:18.png}}
 * When you are done with everything, click on '''Save''' in the MRI Viewer. It saves the new channel file and updates the number of channels in the database explorer. Also, while closing the windows a prompt appears asking to save the changes. Just click '''Yes '''for everything.

{{{#!wiki note
In some cases, additional correction of the contacts may be required. To edit the individual contacts refer to the [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Edit_contact_positions|Edit contact positions]] section below.
}}}
=== Edit contact positions ===
TODO: Add the dataset used for curved electrode contact editing.<<BR>><<BR>>

Until now, we have seen cases where the trajectory of an electrode always follows a straight line but practically that is not the case as there could be bending introduced when the neurosurgeon inserts the electrode. In such cases we need to move most of the intermediate contacts to more appropriate positions.

 * Let's take the case of a curved electrode. If no figures are loaded then right click on your '''Subject > SEEG/ECOG implantation'''. Click '''Continue''' for working on the existing implantation. Choose '''MRI+CT+IsoSurf''' to show the figures. Select the 3D figure and toggle between the '''electrode''' ( {{attachment:iconSeegDepth.gif}} ) and '''sphere''' ( {{attachment:iconSeegSphere.gif}} ) modes to get the figures as under using buttons in Panel iEEG. Keep it in the '''sphere''' mode for better visibility. The contacts definitely need to be corrected and moved to their right positions. <<BR>><<BR>> {{attachment:19.png||width="600"}}
 * Display the contact labels in 3D figure by right clicking '''Channels > Display labels. '''It can be seen that the contacts '''A2-A15 '''are incorrect. Let us first correct contact '''A2'''.<<BR>><<BR>> {{attachment:20.png||width="600"}}
 * Since the isoSurface blobs are the correct ones, we can use them as ground truth guide to correct the contacts. Click the {{attachment:iconScoutNew.gif}} button (shortcut: Ctrl+P) and choose the correct blob. That places a yellow crosshair on the blob and updates the MRI Viewer crosshair as well. <<BR>><<BR>> {{attachment:21.png||width="600"}}
 * Without clicking anywhere else, move your courser to the MRI Viewer, right click and go to '''Electrodes > Set electrode position (or press Ctrl+S)'''. From the '''Set electrode position''' window choose '''A2''' and press '''OK'''. This will update the position of '''A2 '''only in the MRI Viewer. <<BR>><<BR>> {{attachment:22.png||width="400"}}
 * Click on '''Save''' and it closes all the windows and updates the channel file and number of channels in the database explorer.<<BR>><<BR>> {{attachment:23.png||width="400"}}
 * Right click on the '''Subject > SEEG/ECOG implantation'''. Click '''Continue''' for working on the existing implantation. Choose '''MRI+CT+IsoSurf''' to show all the figures. Select the 3D figure and in the Panel iEEG, choose the '''sphere''' ( {{attachment:iconSeegSphere.gif}} ) mode for display. You will now see the updated contact in the 3D figure as well.<<BR>><<BR>> {{attachment:24.png||width="400"}}
 * Follow the above steps to update all the remaining contacts as required. '''Unfortunately, Brainstorm currently does not have a way to handle curved electrodes display yet: if you move the contacts, the electrode remains represented as a straight line. This is a display issue only, which has no impact on any computation, but we hope to improve it at some point'''.<<BR>><<BR>> {{attachment:25.png||width="400"}}
 * We have a functionality called line fitting that can help better view the trajectory in the 3D figure with '''sphere''' ( {{attachment:iconSeegSphere.gif}} ) display mode. Choose the electrode and click '''Contacts > Show/Hide line fit through contacts'''.<<BR>><<BR>> {{attachment:26.png||width="400"}}

== Electrode labeling and contact localization (Automatic) ==
{{{#!wiki tip
This is currently under preparation. In the meantime, you can refer to this abstract:<<BR>>[[https://www.researchgate.net/publication/386140762|Automatic SEEG Contact Localization and Labeling using Brainstorm]] presented at [[https://aesnet.org/AES-annual-meeting/general-information/attend|AES 2024]].
}}}
== Appendix ==
-Line 97:
+Line 140:
-  * '''Number of contacts''': Number of recording sites on the electrode. By default, this is set for SEEG to the maximum index found in a group of contacts. Example: electrode s' is associated to channels s'1, s'2, s'3, s'10, s'11, s'12 => detected number of contacts is 12.
+  * '''Number of contacts''': Number of recording sites on the electrode. By default, this is set for SEEG to the maximum index found in a group of contacts. Example: electrode A is associated to channels A1, A2...A14 => detected number of contacts is 14.
-Line 99:
+Line 142:
-  * '''Set tip''': Select one electrode in the list, then move the cursor of the MRI viewer to the tip of the selected electrode (center of the first contact) or choose the contact from the isoSurface in the 3D Viz and finally click on ['''Set tip'''].
  * '''Set skull entry''': Select one electrode in the list, then move the cursor of the MRI viewer to the point where the depth electrode enters the skull or choose the point from the isoSurface in the 3D Viz, and finally click on ['''Set skull entry''']. This position does not actually correspond to any contact, it is used only to estimate the direction of the depth electrode. [[http://neuroimage.usc.edu/brainstorm/Tutorials/Epileptogenicity#Edit_the_contacts_positions|More details]].
+  * '''Set tip''': Select one electrode in the list, then move the cursor of the MRI viewer to the tip of the selected electrode (center of the first contact) or choose the contact from the isoSurface in the 3D figure and finally click on ['''Set tip'''].
  * '''Set skull entry''': Select one electrode in the list, then move the cursor of the MRI viewer to the point where the depth electrode enters the skull or choose the point from the isoSurface in the 3D figure, and finally click on ['''Set skull entry''']. This position does not actually correspond to any contact, it is used only to estimate the direction of the depth electrode. [[http://neuroimage.usc.edu/brainstorm/Tutorials/Epileptogenicity#Edit_the_contacts_positions|More details]].
-Line 107:
+Line 150:
-=== Create electrodes and plot contacts manually ===
 * After performing steps as per [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Get_started|Get Started]] above, we will have the Panel iEEG along with the MRI Viewer and 3D Viz open.
 * On '''Panel iEEG''' Click on the '''+ (Add new electrode)'''. This opens up the '''Add electrode''' window. Enter anything under '''Electrode label''' based on your convention. For this e.g., enter '''A''' and press '''OK'''.<<BR>><<BR>> {{attachment:12.png||width="320"}}
 * This creates an electrode '''A''' in selected state, and at the bottom the '''Electrode configuration''' section of the panel becomes active. Select the following:
  * Type: '''SEEG'''
  * Model: Choose '''PMT 2102-16-091/2102-16-101''' from the drop down list. This will automatically set the other parameters in the section. More details for these parameters can be found in the advanced section [[https://neuroimage.usc.edu/brainstorm/Tutorials/Epileptogenicity#On_the_hard_drive|here]].<<BR>><<BR>> {{attachment:13.png||width="320"}}
+=== Walkthrough Video ===
TODO
-Line 114:
+Line 153:
- * '''Set tip''':  Click the {{attachment:iconScoutNew.gif}} button (shortcut: Ctrl+P) and choose the contact (deepest contact) for the electrode in the isosurface in 3D Viz which is going to be set as the tip. This should plot a yellow crosshair marker point on the blob and also update the MRI Viewer's crosshair. At the bottom in '''Panel iEEG''' click '''Set tip''' and the button turns green indicating that the tip has been set. '''This point in 3D is at the centroid of the blob which gives a more accurate location of the contact compared to the same if chosen from the MRI'''.
+== Additional Documentation ==
=== Forum discussions ===
 * [[https://neuroimage.usc.edu/forums/t/updating-seeg-coordinates/49097|Updating SEEG coordinates]]
-Line 116:
+Line 157:
-''Note: You can play around with the "Thresh" slider as mentioned [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Generate_isoSurface|here]] to get better visibility of the contacts as required''<<BR>><<BR>> {{attachment:14.png}} {{attachment:15.png}}

 * '''Set skull entry''': Choose the point in the isosurface in 3D Viz which is going to be set as the skull entry. This point can be any of the contacts other than the tip preferably closer to the skull so that we get an orientation of the electrode. This should plot a yellow crosshair marker point on the blob and also update the MRI Viewer's crosshair. At the bottom in '''Panel iEEG''' click '''Set skull entry''' and the button turns green indicating that the entry point has been set. The properties used for setting the position of the contacts are the '''contact spacing, the tip of the electrode and the entry point in the skull'''. '''Contact #i''' is placed along the electrode at '''(i-1)*contact_spacing millimeters''' from the tip of the electrode. The MRI Viewer gets updated with the an electrode based on the above configuration. Some more fine tuning may be required and user might need to edit the individual contacts. [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Edit_contact_positions|This section]] explains it in details.

''Note: You can play around with the "Thresh" slider as mentioned [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Generate_isoSurface|here]] to get better visibility of the contacts as required''<<BR>><<BR>> {{attachment:16.png}}

 * Click on '''Contacts > Save Modifications''' to update the channel information. <<BR>><<BR>> {{attachment:17.png||width="320"}} {{attachment:18.png}}

 * When you are done with everything, click on '''Save''' in the MRI Viewer. It saves the new channel file and updates the number of channels in the database explorer. Also, while closing the windows a prompt appears asking to save the changes. Just click '''Yes '''for everything.

=== Edit contact positions ===
Until now, the electrode is always assumed to follow a straight path but practically that is not the case as there could be bending introduced when the neurosurgeon inserts the electrode. In such cases we need to move most of the intermediate contacts to more appropriate positions.

Let's take the case of a curved electrode. You can toggle between the electrode and sphere views to get the figures as under using buttons in Panel iEEG. Keep it in the sphere mode for better visibility. The contacts definitely need to be corrected and moved to their right positions. <<BR>><<BR>> {{attachment:19.png}}

 * Click on the individual contacts (in green) in the 3D Viz and it highlights the corresponding location in MRI Viewer and also the panel. You can display the contact labels in 3D Viz by right clicking '''Channels > Display labels'''. <<BR>><<BR>> {{attachment:20.png||width="500"}}
 * From the above it is clear that contacts beyond '''A1''' are not correct. But the isosurface blobs are the correct ones. Like we did for setting the tip and entry above, we go to '''Panel Coordinates''' and click on '''Select''' and then choose the correct blob. That places a cross hair and updates the MRI Viewer as well. Here we are correcting contact '''A2'''.<<BR>><<BR>> {{attachment:21.png||width="500"}}
 * In the MRI Viewer, right click and go to '''Electrodes > Set electrode position (or press Ctrl+S)'''. From the '''Set electrode position''' window choose '''A2''' and press '''OK'''.<<BR>><<BR>> {{attachment:22.png}}
 * This updates the position of contact '''A2''' in the MRI viewer. Click on '''Save''' and it closes all the windows and updates the channel file and number of channels in the database explorer.<<BR>><<BR>> {{attachment:23.png||width="500"}}
 * Double click on the '''SEEG/ECOG()''' channel file under '''Implantaion''' node to open the updated 3D Viz as under. You can also right click on the '''SEEG/ECOG()''' channel file and under '''Display Sensors''' you can choose what all you want to display.<<BR>><<BR>> {{attachment:24.png||width="320"}}
 * Follow the above steps to update all the remaining contacts as required. '''Unfortunately, Brainstorm currently does not have a way to handle curved electrodes display yet: if you move the contacts, the electrode remains represented as a straight line (left figure). This is a display issue only, which has no impact on any computation, but we hope to improve it at some point'''. However, we have a functionality called line fitting under '''Contacts > Line fit through contacts''' that can help better approximate and view the trajectory in the 3D Viz with sphere display mode (right figure).<<BR>><<BR>> {{attachment:25.png||width="500"}}

== Walkthrough Video ==
<<HTML(<center><iframe width="640" height="360" src="https://www.youtube.com/embed/Pxz7Dc3NQuU" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></center>)>>

<<TAG(Advanced)>>

== Related tutorials ==
+=== Related tutorials ===

Software

Users

Development

iEEG Contact Localization

Dataset description

License

SEEG recordings

Files

Download and installation

Import the anatomy

Pre-implantation MRI

Post-implantation CT

Generate isoSurface

Electrode labeling and contact localization (Manual)

Get started

Create electrodes and plot contacts manually

Edit contact positions

Electrode labeling and contact localization (Automatic)

Appendix

Panel iEEG

Walkthrough Video

Additional Documentation

Forum discussions

Related tutorials