Difference between revisions of "Integration of Custom Template Head-Models"

From BESA® Wiki
Jump to: navigation, search
m (Copy Files to Custom Template Head-Model Folder)
m (Custom Template Head-Model Integration in BESA Research 6.1)
Line 27: Line 27:
 
=== Load Sample EEG Data in BESA Research ===
 
=== Load Sample EEG Data in BESA Research ===
  
Open BESA Research and load the file ''Coregistration data.avr'' located in the downloaded zip folder. To add electrode coordinates, navigate to ''File'' -> ''Head Surface Points and Sensors'' -> ''Load Coordinate Files....'' Press ''Browse'' in the ''Channel configuration (*.el?)'' section and select the age-appropriate *.elp file from the ''Electrode positions'' folder in the downloaded sample EEG data.
+
Open BESA Research and load the file ''Coregistration data.avr'' located in the downloaded zip folder. To add electrode coordinates, navigate to ''File'' → ''Head Surface Points and Sensors'' → ''Load Coordinate Files....'' Press ''Browse'' in the ''Channel configuration (*.el?)'' section and select the age-appropriate *.elp file from the ''Electrode positions'' folder in the downloaded sample EEG data.
  
 
Also load the age-appropriate *.sfp file by pressing ''Browse'' in the ''Digitized head surface points (*.sfp, *.eps) and labels (*.sfn)'' section and select the respective *.sfp file.
 
Also load the age-appropriate *.sfp file by pressing ''Browse'' in the ''Digitized head surface points (*.sfp, *.eps) and labels (*.sfn)'' section and select the respective *.sfp file.
Line 35: Line 35:
 
[[File:Channel and digitized head surface point information.png]]
 
[[File:Channel and digitized head surface point information.png]]
  
Please note that the coordinates of the electrode configuration will be fitted during coregistration and need not to have a perfect match with your template head-model at this step. Confirm all settings and leave this dialog via pressing ''OK''. To check if all files were read correctly, open the ''Surface Points'' dialog (press ''V'' on your keyboard or select ''File'' -> ''Head Surface Points and Sensors'' -> ''View'').
+
Please note that the coordinates of the electrode configuration will be fitted during coregistration and need not to have a perfect match with your template head-model at this step. Confirm all settings and leave this dialog via pressing ''OK''. To check if all files were read correctly, open the ''Surface Points'' dialog (press ''V'' on your keyboard or select ''File'' → ''Head Surface Points and Sensors'' → ''View'').
  
 
[[File:Surface points.png]]
 
[[File:Surface points.png]]
Line 41: Line 41:
 
=== Coregistration of EEG and MRI Data ===
 
=== Coregistration of EEG and MRI Data ===
  
For coregistration of the sample EEG data set with your template head-model, select ''File'' -> ''Coregistration''. Store the *.sfh file with the proposed filename. BESA MRI will now be started and a new coregistration project is preselected. If it is not started, press the ''Start New Coregistration'' button.
+
For coregistration of the sample EEG data set with your template head-model, select ''File'' → ''Coregistration''. Store the *.sfh file with the proposed filename. BESA MRI will now be started and a new coregistration project is preselected. If it is not started, press the ''Start New Coregistration'' button.
  
 
Check the option ''Generate FEM EEG Leadfield'' in the ''Set Project Targets'' workstep and select the previously segmented MRI project as input for coregistration. Load the electrode configuration file ''Coregistration data.sfh'' in the ''Fit Surface Points'' workstep. Finalize the coregistration project by choosing the desired conductivity values, run the FEM computation and finally save the finished project.
 
Check the option ''Generate FEM EEG Leadfield'' in the ''Set Project Targets'' workstep and select the previously segmented MRI project as input for coregistration. Load the electrode configuration file ''Coregistration data.sfh'' in the ''Fit Surface Points'' workstep. Finalize the coregistration project by choosing the desired conductivity values, run the FEM computation and finally save the finished project.

Revision as of 17:33, 9 August 2018

Module information
Modules BESA Research, BESA MRI
Version 6.1 or higher, 2.0 or higher

Introduction

This tutorial will guide you through the steps of how to create a custom template head-model in order to use it in the Source Analysis module of BESA Research 6.1.

Prerequisites

To create the template, you need to have the latest versions of BESA Research 6.1 and BESA MRI 2.0 installed on your computer. MRI data needs to be prepared to be available in either DICOM, Analyze or Nifti format.

Sample EEG data for coregistration using a predefined electrode configuration is required. Please download the required zip folder here: Download Link

Custom Template Head-Model Integration in BESA Research 6.1

MRI Segmentation

Start BESA MRI 2.0 and run a new segmentation project to perform a segmentation of the template MRI data in BESA MRI. Please mind that is necessary to check the option Run Volume Conductor Segmentation in the Set Project Targets workstep.

Segmentation Project - Run Volume Conductor Segmentation.png

The segmentation is a fully automatic, robust procedure which in general delivers very accurate segmentations. In some rare cases, however, it might happen that the automatic segmentation result contains inaccuracies and might, thus, be considered as inadequate. Segmentation problems might occur for data sets with atypical anatomy, for example, data sets containing brain lesions, as well as infant data sets. An alternative way of generating an adequate segmentation is to manually correct the segmentation mask, and then use the corrected segmentation mask as the basis for the FE mesh generation. This approach is well described on the following BESA Wiki website: Correcting Volume Conductor Segmentations

Load Sample EEG Data in BESA Research

Open BESA Research and load the file Coregistration data.avr located in the downloaded zip folder. To add electrode coordinates, navigate to FileHead Surface Points and SensorsLoad Coordinate Files.... Press Browse in the Channel configuration (*.el?) section and select the age-appropriate *.elp file from the Electrode positions folder in the downloaded sample EEG data.

Also load the age-appropriate *.sfp file by pressing Browse in the Digitized head surface points (*.sfp, *.eps) and labels (*.sfn) section and select the respective *.sfp file.

The following screenshot shows the Channel and digitized head surface point information dialog with both files loaded from the 20to24y0mo subfolder.

Channel and digitized head surface point information.png

Please note that the coordinates of the electrode configuration will be fitted during coregistration and need not to have a perfect match with your template head-model at this step. Confirm all settings and leave this dialog via pressing OK. To check if all files were read correctly, open the Surface Points dialog (press V on your keyboard or select FileHead Surface Points and SensorsView).

Surface points.png

Coregistration of EEG and MRI Data

For coregistration of the sample EEG data set with your template head-model, select FileCoregistration. Store the *.sfh file with the proposed filename. BESA MRI will now be started and a new coregistration project is preselected. If it is not started, press the Start New Coregistration button.

Check the option Generate FEM EEG Leadfield in the Set Project Targets workstep and select the previously segmented MRI project as input for coregistration. Load the electrode configuration file Coregistration data.sfh in the Fit Surface Points workstep. Finalize the coregistration project by choosing the desired conductivity values, run the FEM computation and finally save the finished project.

Coregistration Project - Generate FEM EEG Leadfield.png

Create new Folder for Custom Template Head-Model

To add a new template head-model for BESA Research, navigate to the installation directory. The default installation directory for BESA Research 6.1 is:

C:\Program Files (x86)\BESA\Research_6_1\

and create a new folder (e.g. 0y3mo) in the .\System\TemplateHeadModels\AgeAppropriateTemplates\ subfolder.

Copy Files to Custom Template Head-Model Folder

Copy the following files from the BESA MRI project folder: <BESA MRI Shared Folder>\<Project Name>\MRIFiles\ to the newly created folder.

Note: If you cannot locate your BESA MRI project folder, open BESA MRI and choose FileSelect Data Folder. The opened dialog will give you the location of your BESA MRI project folder. Close the dialog with pressing Cancel in order not to change the setting.

Copy the following files:

  • \FEMFiles\MRICor_COR__MRI_T1__Coregistration EEG 100_FEM_DATA.lft
  • \FEMFiles\MRISeg_MRI_T1_FEM_DATA.loc
  • \FEMFiles\MRISeg_MRI_T1_FEM_DATA.srf
  • \SurfaceFiles\MRISeg_MRI_T1_TAL.srf
  • \SurfaceFiles\MRISeg_MRI_T1_TAL_WM.srf
  • \VMRFiles\MRISeg_MRI_T1_TAL.vmr
  • \VMRFiles\MRISeg_MRI_T1_TAL_LV.vmr

Save Electrode Coordinates File

In order to create the electrode configuration file for your custom template head-model, switch back to BESA Research and navigate to FileHead Surface Points and SensorsSave all Files in Head Coordinates. Save the files under the suggested filename. Copy the file Coregistration data_HC.elp to the newly created custom template head-model folder.

Create Talairach Transformation File

In order to create the talairach transformation file, create the file Talairach Trafo.tal in the new template head-model folder and open it with a text editor. Follow the steps described in the example on how to generate a Talairach transformation (*.tal) file from a BESA MRI coregistration (*.sfh) file on the Talairach Transformation File page.

Rename Template Head-Model Files

Rename the files in the newly created template head-model folder according to the chosen head-model name:

Original filename Rename to
MRISeg_MRI_T1_FEM_DATA.srf FEM_0y3mo.srf
MRISeg_MRI_T1_FEM_DATA.loc FEM_0y3mo.loc
MRISeg_MRI_T1_TAL.vmr MRI_0y3mo.vmr
MRISeg_MRI_T1_TAL.srf MRI_0y3mo_Skin.srf
MRISeg_MRI_T1_TAL_WM.srf MRI_0y3mo_Brain.srf
MRISeg_MRI_T1_TAL_LV.vmr MRI_0y3mo_LV.vmr
Coregistration data_HC.elp FEM_0y3mo.elp
MRICor_COR__MRI_T1__Coregistration EEG 100_FEM_DATA.lft FEM_0y3mo.lft
Talairach Trafo.tal FEM_0y3mo.tal

Edit template_head_models.ini

Open the template_head_models.ini file (located in C:\Program Files (x86)\BESA\Research_6_1\System\TemplateHeadModels\) in a text editor and scroll down to the bottom of the file. Add a new section for your template head-model (increase model ID in square brackets). E.g.:

[Model20]
Name=Age 0y 3mo
Description=My custom template head-model for infants in the age group of 3 months.
SourceSpaceSurfFile=AgeAppropriateTemplates\0y3mo\FEM_0y3mo.srf
SourceSpaceGridFile=AgeAppropriateTemplates\0y3mo\FEM_0y3mo.loc
MRIFile=AgeAppropriateTemplates\0y3mo\MRI_0y3mo.vmr
ScalpSurfFile=AgeAppropriateTemplates\0y3mo\MRI_0y3mo_Skin.srf
BrainSurfFile=AgeAppropriateTemplates\0y3mo\MRI_0y3mo_Brain.srf
MaskFile=AgeAppropriateTemplates\0y3mo\MRI_0y3mo_LV.vmr
ElectrodeFile=AgeAppropriateTemplates\0y3mo\FEM_0y3mo.elp
LeadFieldFile=AgeAppropriateTemplates\0y3mo\FEM_0y3mo.lft
TalPtsFile=AgeAppropriateTemplates\0y3mo\FEM_0y3mo.tal
ID=0011
GroupID=0001

Note: The GroupID defines the top level group that can contain several template head models. Please use

GroupID=0001

for custom template head-models. The ID is a unique identifier within a specific group that is related to a single template head-model. Please increment the GroupID by one for each model.

Use your custom Template Head-Model in BESA Research 6.1

After restarting BESA Research, open a data file and send a data segment to the Source Analysis module. The custom template head-model is available in the top-right window. Select Age-appropriate Template Models for the Model type and then choose the new custom template head-models from the drop-down box below.

Source Analysis - custom head-model.png