= Computing and Visualizing Dipoles = <> == Computing sources using the GLS == This process allows for a systematic scanning of sources using performance measures to display single dipoles. For this tutorial we will use the Generalized Least Squares (GLS) source modeling available in Brainstorm. 1. Select the protocol ''TutorialCTF''. Right-click on ''Subject01 / Left / ERF'' > ''Compute sources''. 1. In this window, you should select ''Expert Mode''. You will see the following menu. Select ''[Test] Mosher GLS''. Click OK. Use the default settings in the next menu and click OK.<
><
> {{attachment:compute_GLS.png||height="450",width="279"}} --- {{attachment:compute_GLS_options.png||height="593",width="289"}} 1. Two results were added under the ERF: GLS and GLS-P.<
><
> {{attachment:tree_display_GLSP.png||height="188",width="279"}} * '''GLS''': * '''GLS-P''': == Dipole Scanning == For this tutorial we will do the scanning on the GLS results. However, the dipole scanning is also available for sources computed with minimum norm z-scored (i.e. MN MEG(Constr) | zscored), dSPM and sLORETA. 1. Drag and drop the GLS-P link into the Process 1 box. Click ''Run > Sources > Dipole scanning''.<
><
> {{attachment:process_box_GLSP.png||height="465",width="300"}} --- {{attachment:select_process_dipolescanning.png||height="262",width="250"}} 1. Use the defaults options: * '''Time Window''': This is the window over which the scanning will occur. The default option is to use the entire epoch. * '''Time between dipoles''': This allows you to change the resolution of the scanning. To use all time points, enter a 0 (default).<
><
> {{attachment:dipole_scanning_options.png||height="250",width="325"}} 1. The resulting dipole file is added under the Left condition.<
><
> {{attachment:tree_display_dipolefile.png||height="200",width="260"}} == Visualizing Dipoles == 1. Right-click ''ERF|GLSP-dipole-scan > Display on cortex''. The ''Dipoles'' panel is now open and dipoles are displayed on the cortex. You can now explore the results using the options in the ''Dipoles'' panel:<
><
> {{attachment:dipole_panel.png||height="420",width="300"}} * Data options: filter the available dipoles according the specific measurement. For the GLSP, these are defined as: * '''Z-score''': * '''Goodness''': * '''Chi-square''': * '''Reduced Chi-square''': * '''Confvolume''': * Display options: these options allow for adjusting how the selected dipoles (according to the Data options) are displayed * '''Show max goodness''': will show the dipole with the maximum goodness (within the constraints of the ''Data options'') at the time point selected. If ''Show all time'' is selected, then this represents the maximum goodness over all time points. * '''Show all time''': plots all selected dipoles at all time points. Un-selecting this options will show only the current time point. * '''3D - Color dipoles according to Time''', Goodness of Fit, Z-score, Group: adjusts the colormap to reflect the measure. 1. In the Dipoles panel, select ''Show max goodness of fit'', ''Show all time'', and color the dipoles according to ''Goodness of Fit''. You should see the following display. Explore the panel options to familiarize yourself with the capabilities.<
><
> {{attachment:max_GOF_cortex.png||height="200",width="260"}} == Dipole models from Neuromag's Xfit and CTF's DipoleFit == Brainstorm can import dipoles that have been generated using external software: '''Neuromag Source Modelling module, xfit:''' The .bdip format is described in [[attachment:bdip_format.pdf]]. For more information about xfit and the bdip format see Neuromag Software Manuals. '''CTF !DipoleFit:''' The !DipoleFit software and the .dip format is described in the CTF Software Manuals. '''To import''' 1. Select the study where you want to import the dipole file 1. Right click and select ‘Import dipoles’ (Figure 1) 1. For Neuromag, you will be prompted to specify the number of subsets used for dipole fitting. '''In most cases, this will be one.''' If subsets are used, as defined in the text file $HOME/.meg_analysis/xfit_selections, then the number of subsets used needs to be input when prompted. (Figure 2)<
><
> {{attachment:import.png||height="455",width="294"}} <
><
> Figure 1. Importing dipoles<
><
> {{attachment:dipoles_subsets_dialog.jpg}} <
><
> Figure 2. Neuromag option for channel subsets<
><
> 1. When displaying dipole files with multiple groups and/or subsets, the ''Loaded dipoles'' panel appears with a list of dipoles, grouped according to event (Group #1, Group#2, etc) and by channel subset, if used (Subset #1, Subset#2, etc.) * Select the Group(s) to plot * Clicking on a subset will select all Groups with that subset. For example, selecting Subset #1 will select Group #1 (1), Group #2 (2), Group #3 (3), etc. == Examples == * '''Example 1''' shows 5 subsets (channel groups of Left, Right, Anterior, Posterior, All Channels). When subset #2 is selected, dipoles fitted to the right channels are displayed. In this case, ''Show all time'' is selected for the 4 Groups (events) and colored according to ''Goodness of Fit''<
><
> {{attachment:subset_group_GOF.png||height="354",width="300"}} <
><
> Example 1 * '''Example 2''' shows all groups and subsets at one time point (0.3 ms), with goodness of fit greater than 80%, colored according to their group.<
><
> {{attachment:allgroups_allsubsets_1time.png||height="366",width="300"}} * '''Example 3''' shows dipole scanning restricted to a scout, colored according to goodness of fit<
><
> {{attachment:scanning_options_scouts.png||height="200",width="204"}} --- {{attachment:scan_dipoles_on_scout.png||height="250",width="285"}}