Differences between revisions 12 and 51 (spanning 39 versions)

Tutorial 5: Review continuous recordings

Authors: Francois Tadel, Elizabeth Bock, John C Mosher, Sylvain Baillet

Contents

Open the recordings
Navigate in time
Epoched vs. continuous
Display mode: Butterfly/Column
Montage selection
Channel selection
Amplitude scale
Time and amplitude resolution
Online filters
Mouse and keyboard shortcuts

Open the recordings

Let's look at the first file in the list: AEF#01.
Right-click on the Link to raw file. Below the first to menus, you have the list of channel types:

MEG: 274 axial gradiometers
ECG: 1 electrocadiogram, bipolar electrode across the chest
EOG: 2 electrooculograms (vertical and horizontal)
Misc: EEG electrodes Cz and Pz
ADC A: Unused
ADC V: Auditory signal sent to the subject
DAC: Unused
FitErr: Fitting error when trying to localize the three head localization coils (NAS, LPA, RPA)
HLU: Head Localizing Unit, displacements in the three directions (x,y,z) for the three coils
MEG REF: 26 reference sensors used for removing the environmental noise
Other: Unused
Stim: Stimulation channel, records the stim triggers generated by the Psychophysics toolbox and other input channels, such as button presses generated by the subject
SysClock: System clock, unused

Select > MEG > Display time series (or double-click on the file).

It will open a new figure and enable many controls in the Brainstorm window.

Navigate in time

The files we have imported here are shown the way they have been saved by the CTF MEG system: as contiguous epochs of 1 second each. Those epochs are not related with the stimulus triggers or the subject's responses, they are just a way of saving the files. We will first explore the recordings in this epoched mode before switching to the continuous mode.

From the time series figure

Click: Click on the white or grey parts of figure to move the time cursor (red vertical line).
If you click on the signals, it selects the corresponding channels. Click again to unselect.
Shortcuts: See the tooltips in the time panel for important keyboard shortcuts:
Left arrow, right arrow, page up, page down, F3, Shift+F3, etc...
Bottom bar: The red square in the bottom bar represents the portion of the file that is currently displayed from the current file or epoch. Right now we show all the epoch #1. This will be more useful in the continuous mode.
Zoom: Scroll to zoom horizontally around the time cursor (mouse wheel or two-finger up/down).
[<<<] and [>>>]: Previous/next epoch or page

From the time panel

Time: [0, 998]ms is the time segment over which the first epoch is defined.
Sampling: We downsampled these files to 600Hz for easier processing in the tutorials.
Text box: Current time, can be edited manually.
[<] and [>]: Previous/next time sample - Read the tooltip for details and shortcuts
[<<] and [>>]: Previous/next time sample (x10) - Read the tooltip for details and shortcuts
[<<<] and [>>>]: Previous/next epoch or page - Read the tooltip for details and shortcuts

From the page settings

Epoch: Selects the current time block that is displayed in the time series figure.
Start: Starting point of the time segment displayed in the figure. Useful in continuous mode only.
Duration: Length of this time segment. Useful in continuous mode only.

Time selection

In the time series figure, click and drag your mouse for selecting a time segment.
At the bottom of the figure, you will see the duration of the selected block.
Useful for quickly estimating the latencies between two events, or the period of an oscillation.
Click anywhere on the figure to cancel this time selection.

Epoched vs. continuous

The CTF MEG system can save two types of files: epoched (.ds) or continuous (_AUX.ds).
Here we have an intermediate storage type: continuous recordings saved in "epoched" files. The files are saved as small blocks of recordings of a constant time length (1 second in this case). All those time blocks are contiguous, there is no gap between them.
Brainstorm can consider this file either as a continuous or an epoched file. By default it imports the regular .ds folders as epoched, but we need to change this manually.
Right-click on the "Link to raw file" for AEF#01 > Switch epoched/continuous
You should get a message: "File converted to: continuous".
Double-click on the "Link to raw file" again. Now you can navigate in the file without interruptions. The box "Epoch" is disabled and all the events in the file are displayed at once.
Increase the duration of the displayed window to 3 seconds (Page settings > Duration).
Close the figure.
Repeat this operation with the other files to convert them all to a continuous mode.
- AEF#02 > Switch epoched/continuous
- Noise > Switch epoched/continuous

Display mode: Butterfly/Column

Close all the figures.
Double-click on the AEF#01 Link to raw file to open the MEG recordings.
What we see are all the traces of the 274 sensors overlaid on top of each other.
Click on the "Display mode" button in the toolbar of the Record tab.
All the signals are now displayed, one below the other, but because we have 274 MEG channels, the figure is still unreadable. We need to select only a subset of those sensors.

Montage selection

You can use the montage menu to select a group of sensors. This menu is accessible in two ways:
- Record toolbar > Drop-down menu.
- Figure popup menu > Right-click on the figure > Montage
Pre-defined groups of channels are available for some common MEG and EEG systems.
Notice the keyboard shortcuts on the right (Shift+A, B, C...).
You can also use this menu to create your own sensor selections or more complex montages.
A separate tutorial is dedicated to the montage editor.
Select the group: CTF LT (Left Temporal, Shift+D).

Channel selection

If you click on the white or grey areas of the figure, it changes the current time.
If you click on the lines representing the recorded signals instead, it selects the corresponding channels.

When some channels are selected, an additional menu "Channels" is visible in the figure popup.
Select "View selected" or press [Enter] to open the selected channels in a separate window.
If you select channels in one figure, this selection will always be applied to all the other figures.
The management of the bad channels will be introduced in a separate tutorial.

Amplitude scale

A variety of display options allows you to adjust the amplitude scale for the recordings (vertical axis).

Increase/decrease gain: Buttons [^] and [v] on the right side of the figure. The shortcuts for those buttons are indicated in the tooltips (leave the mouse for a short while over a button).
Hold the Shift key and scroll, or use the keys [+] and [-].
Flip +/-: Button in the right part of the time series figure. Exchange the direction of the Y axis, to have the peaks of negative values pointing up. Useful mostly for clinical EEG.
Set scale manually: Button [...] in the figure. Opens a window to enter the amplitude scale manually. The value corresponds to the space between two horizontal lines in this figure.
Auto-scale amplitude: Button [AS] in the figure.
Selected: the vertical scale is adapted to the new maximum amplitude when you scroll in the file.
Not selected: The vertical scale is fixed, scrolling in the file does not affect the display.
Remove DC offset: Button [DC] in the Record tab. When selected, the average value over the entire current time window is subtracted from each channel. This means that if you change the length of the time window, the value that is removed from each channel may change. Always keep this option selected for unprocessed MEG recordings, unless you use a high-pass filter.
Apply CTF compensation: Button [CTF] in the Record tab. Enable/disable the CTF noise correction based on the reference sensors, when it is not already applied in the file. In the current file, the CTF 3rd order gradient compensation is already applied, therefore this option is not available.

Time and amplitude resolution

In the Brainstorm interface, the axis resolution is usually set implicitly: you can set the size of the window, the duration or recordings reviewed at once and the maximum amplitude to show in the figure. Those parameters are convenient to explore the recordings interactively but don't allow us to have reproducible displays with constant time and amplitude resolutions.

However, some applications are very sensitive to the horizontal and vertical scaling, such as the visual detection of epileptic spikes. The shapes of traces the epileptologists try to identify are altered by the axes resolution. This is detailed in the tutorial EEG and Epilepsy.

For this reason, we also added a menu to set the figure resolution explicitly. The distance unit on a screen is the pixel, we can set precisely how much time is represented by one pixel horizontally and how much amplitude is represented by one pixel vertically.
Right-click on the figure > Figure > Set axes resolution.

Note that this interface does not store the input values, it just modifies the other parameters (figure size, time window, max amplitude) to fit the resolution objectives. If you modify those parameters after setting the resolution (resize the figure, leave the button [AS] selected and scroll in time, etc) the resolution is lost, you have to set it again manually.

Online filters

With the Filter tab, you can apply a band-pass filter to the recordings, or remove a set of specific frequencies (example: the 50Hz or 60Hz power lines contamination and their harmonics). The filters are applied only to the time window that is currently loaded. If the segment is too short for the required filters, the results might be inaccurate.

The option "Mirror signal before filtering" triples artificially the length of the signal with a mirror symmetry on each side, to avoid the strong edge effects that those filters can generate. Those online filters are not very accurate, they just provide a quick estimate for visualization only, the results are not saved anywhere. To filter properly the continuous files, please use the Process1 tab.

After testing the high-pass, low-pass and notch filters, uncheck them. If not you may forget about them, and they will stay on until you restart Brainstorm. Note that as long as there are visualization filters applied, the title of the Filter tab remains red.

Mouse and keyboard shortcuts

Keyboard shortcuts

Left / right arrows:
- Change current time, sample by sample
- +Control key: Jump to previous/next epoch or page (same as [<<<] and [>>>])
- +Shift key: Jump to previous/next event
- MacOS: These shortcuts are different, please read the tooltips for [>], [>>] and [>>>]
Page-up / page-down:
- Change current time, 10 samples at a time
- +Control key: Jump to the next/previous epoch or page, 10x faster
F3/Shift+F3: Jump to the next/previous epoch or page
F4/Shift+F4: Jump to the next/previous half-page
Plus / minus: Adjust the vertical scale of the time series
Shift + Letter: Changes the montage
Control + B: Mark selected time segment as bad
Control + D: Dock figure
Control + E: Add / delete event marker
Control + F: Open a copy of the figure, not managed by the Brainstorm window manager
Control + I: Save figure as image
Control + J: Open a screen capture of the figure
Control + T: Open a 2D topography window at the current time
Enter: Display the selected channels in a separate figure
Escape: Unselect all the selected channels
Delete: Mark the selected channels as bad

Mouse shortcuts

Click on a channel: Select the channel
Click: Change current time
Shift + click: Force the selection of the current time (even when clicking on a channel)
Click + move: Select time range
Scroll: Zoom around current time
Shift + scroll: Adjust the vertical scale of the time series
Control + scroll: Zoom vertically
Right-click: Display popup menu
Right-click + move: Move in a zoomed figure
Double click: Restore initial zoom settings (but do not restore the vertical scale of the time series)

-  ⇤ ← Revision 12 as of 2015-02-03 23:20:48 → 
  Size: 15765
  Editor: FrancoisTadel
  Comment:
+   ← Revision 51 as of 2015-02-27 16:16:59 → ⇥
  Size: 13935
  Editor: ?ElizabethBock
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-= Tutorial 5: Review continuous files =
+= Tutorial 5: Review continuous recordings =
 Line 6:
-== Presentation of the experiment ==
+== Open the recordings ==
Let's look at the first file in the list: '''AEF#01'''.<<BR>>Right-click on the Link to raw file. Below the first to menus, you have the list of channel types:
-Line 8:
+Line 9:
-A full description of this dataset is available on this page:  [[http://neuroimage.usc.edu/brainstorm/DatasetAuditory|MEG auditory dataset]].
+ * '''MEG''': 274 axial gradiometers
 * '''ECG''': 1 electrocadiogram, bipolar electrode across the chest
 * '''EOG''': 2 electrooculograms (vertical and horizontal)
 * '''Misc''': EEG electrodes Cz and Pz
 * '''ADC A''': Unused
 * '''ADC V''': Auditory signal sent to the subject
 * '''DAC''': Unused
 * '''FitErr''': Fitting error when trying to localize the three head localization coils (NAS, LPA, RPA)
 * '''HLU''': Head Localizing Unit, displacements in the three directions (x,y,z) for the three coils
 * '''MEG REF''': 26 reference sensors used for removing the environmental noise
 * '''Other''': Unused
 * '''Stim''': Stimulation channel, records the stim triggers generated by the Psychophysics toolbox and other input channels, such as button presses generated by the subject
 * '''SysClock''': System clock, unused
-Line 10:
+Line 23:
-==== Experiment ====
 * One subject, two acquisition runs of 6 minutes each
 * Subject stimulated binaurally with intra-aural earphones (air tubes+transducers)
 * Each run contains:
  * 200 regular beeps (440Hz)
  * 40 easy deviant beeps (554.4Hz, 4 semitones higher)
 * Random inter-stimulus interval: between 0.7s and 1.7s seconds, uniformly distributed
 * The subject presses a button when detecting a deviant
 * Auditory stimuli generated with the Matlab Psychophysics toolbox
+Select > MEG > Display time series (or double-click on the file).
-Line 20:
+Line 25:
-==== MEG acquisition ====
 * Acquisition at '''2400Hz''', with a '''CTF 275''' system at the MNI, subject in seating position
 * Online 600Hz low-pass filter, files saved with the 3rd order gradient
 * Recorded channels (340):
  * 1 Stim channel indicating the presentation times of the audio stimuli: UDIO001 (#1)
  * 1 Audio signal sent to the subject: UADC001 (#316)
  * 1 Response channel recordings the finger taps in response to the deviants: UPPT001 (#2)
  * 26 MEG reference sensors (#5-#30)
  * 274 MEG axial gradiometers (#31-#304)
  * 2 EEG electrodes: Cz, Pz (#305 and #306)
  * 1 ECG bipolar (#307)
  * 2 EOG bipolar (vertical #308, horizontal #309)
  * 12 Head tracking channels: Nasion XYZ, Left XYZ, Right XYZ, Error N/L/R (#317-#328)
  * 20 Unused channels (#3, #4, #310-#315, #329-340)
 * 3 datasets:
  * '''S01_AEF_20131218_01.ds''': Run #1, 360s, 200 standard + 40 deviants
  * '''S01_AEF_20131218_02.ds''':  Run #2, 360s, 200 standard + 40 deviants
  * '''S01_Noise_20131218_01.ds''': Empty room recordings, 30s long
  * File name: S01=Subject01, AEF=Auditory evoked field, 20131218=date(Dec 18 2013), 01=run
 * Use of the .ds, not the AUX (standard at the MNI) because they are easier to manipulate in FieldTrip
+ . {{attachment:link_menu.gif||height="322",width="324"}}
-Line 41:
+Line 27:
-= From Continuous =
== Review the recordings ==
=== Open the file ===
Right-click on the data file > MEG (all) > Display time series.
+It will open a new figure and enable many controls in the Brainstorm window.
-Line 46:
+Line 29:
-{{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=displayTsMenu.gif|displayTsMenu.gif|class="attachment"}}
+ . {{attachment:review_epoch.gif}}
-Line 48:
+Line 31:
-You can see new information in the tab "Record" and a figure showing the recordings.
+== Navigate in time ==
The files we have imported here are shown the way they have been saved by the CTF MEG system: as contiguous epochs of 1 second each. Those epochs are not related with the stimulus triggers or the subject's responses, they are just a way of saving the files. We will first explore the recordings in this epoched mode before switching to the continuous mode.
-Line 50:
+Line 34:
-{{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=rawPanel.gif|rawPanel.gif|class="attachment"}}
+==== From the time series figure ====
 * '''Click''': Click on the white or grey parts of figure to move the time cursor (red vertical line).<<BR>>If you click on the signals, it selects the corresponding channels. Click again to unselect.
 * '''Shortcuts''': See the tooltips in the time panel for important keyboard shortcuts: <<BR>>Left arrow, right arrow, page up, page down, F3, Shift+F3, etc...
 * '''Bottom bar''': The red square in the bottom bar represents the portion of the file that is currently displayed from the current file or epoch. Right now we show all the epoch #1. This will be more useful in the continuous mode.
 * '''Zoom''': Scroll to zoom horizontally around the time cursor (mouse wheel or two-finger up/down).
 * '''[<<<]''' and '''[>>>]''': Previous/next epoch or page
-Line 52:
+Line 41:
-=== Navigate in time ===
As described  in the basic tutorials, you can set the current time by using either  the time panel (buttons and text field), or the figure (click on the  white or grey areas of the figure). But you can notice that only a few  seconds are visible in the figure, while the time panel (top left of the  previous figure), indicates that we have 360s of recordings. Only a  small block of the continuous file has been loaded in memory. This small  time window can be configured with the tab '''Record/Page settings''', with the text boxes '''Start''' and '''Duration'''.
+==== From the time panel ====
 * '''Time''': [0, 998]ms is the time segment over which the first epoch is defined.
 * '''Sampling''': We downsampled these files to 600Hz for easier processing in the tutorials.
 * '''Text box''': Current time, can be edited manually.
 * '''[<]''' and '''[>]''': Previous/next time sample  - Read the tooltip for details and shortcuts
 * '''[<<]''' and '''[>>]''': Previous/next time sample (x10)  - Read the tooltip for details and shortcuts
 * '''[<<<]''' and '''[>>>]''': Previous/next epoch or page - Read the tooltip for details and shortcuts
-Line 55:
+Line 49:
-The  time series figure is similar to the ones that were presented in the  previous tutorials, with a few new elements. The navigation bar at the  bottom represents the time of the entire raw file, where the events are  also represented by dots. The '''<<<''' and '''>>>'''  buttons are the same as the ones in the time panel, and jump to the  previous/next segment in the file. Clicking on the bar or dragging the  red cursor change the current time window as well.
+==== From the page settings ====
 * '''Epoch''': Selects the current time block that is displayed in the time series figure.
 * '''Start''': Starting point of the time segment displayed in the figure. Useful in continuous mode only.
 * '''Duration''': Length of this time segment. Useful in continuous mode only.
-Line 57:
+Line 54:
-== Channel selection and bad channels ==
If you click on the lines instead of the white area: select channels.
+==== Time selection ====
 * In the time series figure, click and drag your mouse for selecting a time segment.
-Line 60:
+Line 57:
-=== Sensor selection ===
Let's switch  to a nicer representation of the recordings time series: click on the  "Display mode" button in the toolbar of the Record tab.
+ * At the bottom of the figure, you will see the duration of the selected block.
 * Useful for quickly estimating the latencies between two events, or the period of an oscillation.
 * Click anywhere on the figure to cancel this time selection. <<BR>><<BR>> {{attachment:review_timesel.gif||height="159",width="434"}}
-Line 63:
+Line 61:
-{{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=tsColumn.gif|tsColumn.gif|class="attachment"}}
+== Epoched vs. continuous ==
 * The CTF MEG system can save two types of files: epoched (.ds) or continuous (_AUX.ds).
 * Here   we have an intermediate storage type: continuous recordings saved in  "epoched" files. The files are saved as small blocks of recordings of a   constant time length (1 second in this case). All those time blocks  are  contiguous, there is no gap between them.
 * Brainstorm   can consider this file either as a continuous or an epoched file. By   default it imports the regular .ds folders as epoched, but we need to change   this manually.
 * Right-click on the "Link to raw file" for '''AEF#01''' > '''Switch epoched/continuous'''<<BR>>You should get a message: "File converted to: continuous".
 * Double-click   on the "Link to raw file" again. Now you can navigate in the file   without interruptions. The box "Epoch" is disabled and all the events in   the file are displayed at once.
 * Increase the duration of the displayed window to '''3 seconds''' (Page settings > Duration). <<BR>><<BR>> {{attachment:review_continuous.gif||height="191",width="561"}}
 * Close the figure.
 * Repeat this operation with the other files to convert them all to a continuous mode.
  * '''AEF#02 > Switch epoched/continuous '''
  * '''Noise''' '''> Switch epoched/continuous '''
-Line 65:
+Line 73:
-Now  the traces are displayed in columns, but all the channels are displayed  in the same figure, which makes it unreadable. Select a subset of  channels by right-clicking on the figure > '''Montages''', with the drop-down menu in the Record tab or with a keyboard shortcut ('''Shift+A, B, C'''...).  Default groups of sensors are available for some MEG systems, but you  can also create your own groups of sensors with the menu "Edit  montages". The montage editor is described in the next tutorial.
+== Display mode: Butterfly/Column ==
 * Close all the figures.
 * Double-click on the AEF#01 Link to raw file to open the MEG recordings.
 * What we see are all the traces of the 274 sensors overlaid on top of each other.
 * Click on the  "Display mode" button in the toolbar of the Record tab. <<BR>><<BR>> {{attachment:review_switch.gif}}
 * All the signals are now displayed, one below the other, but because we have 274 MEG channels, the figure is still unreadable. We need to select only a subset of those sensors. <<BR>><<BR>> {{attachment:review_column.jpg||height="186",width="381"}}
-Line 67:
+Line 80:
-{{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=tsChannelSelection.gif|tsChannelSelection.gif|class="attachment"}}
+== Montage selection ==
 * You can use the montage menu to select a group of sensors. This menu is accessible in two ways:
  * Record toolbar > Drop-down menu.
  * Figure popup menu > Right-click on the figure > Montage
 * Pre-defined groups of channels are available for some common MEG and EEG systems.<<BR>>Notice the keyboard shortcuts on the right (Shift+A, B, C...).
 * You can also use this menu to create your own sensor selections or more complex montages.<<BR>>A separate tutorial is dedicated to the montage editor.
 * Select the group: '''CTF LT''' (Left Temporal, Shift+D). <<BR>><<BR>> {{attachment:review_montage.gif||height="190",width="527"}}
-Line 69:
+Line 88:
-=== Amplitude scale ===
In this display mode, the amplitude scale is represented on the right of the figure. You can adjust this vertical scale:
+== Channel selection ==
If you click on  the white or grey areas of the figure, it changes the current time. <<BR>>If you click on the lines representing the recorded signals instead, it selects the corresponding channels.
-Line 72:
+Line 91:
- * Use the buttons "'''^'''" and "'''v'''"  on the right side of the figure. The shortcuts for those buttons are  indicated in the tooltips (leave the mouse for a short while over a  button)
 * Hold the '''Shift key''' and move the mouse wheel, or use the keys "'''+'''" and "'''-'''".
 * Use the button "'''...'''" on the right side of the figure ("Set scale manually") to set the scale to a precise level.
+ * When some channels are selected, an additional menu "Channels" is visible in the figure popup.
 * Select "View selected" or press [Enter] to open the selected channels in a separate window.
 * If you select channels in one figure, this selection will always be applied to all the other figures.
 * The management of the bad channels will be introduced in a separate tutorial.<<BR>><<BR>> {{attachment:channel_select.gif||height="246",width="615"}}
-Line 76:
+Line 96:
-When  scrolling in time to a different page, the amplitude scale is by  default kept. You can change this behavior to re-evaluate automatically  an optimal scale each time you change the current time window. This  option is called "Auto-scale amplitude" and is disabled by default. To  activate it: click on the "'''AS'''" button on the right of the figure, or check the menu "'''Display > Auto-scale amplitude'''" in the Record tab.
+== Amplitude scale ==
A variety of display options allows you to adjust the amplitude scale for the recordings (vertical axis).
-Line 78:
+Line 99:
-=== Display options ===
 . {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=displayOptions.gif|displayOptions.gif|class="attachment"}}
+ . {{attachment:review_scale.gif}}
-Line 81:
+Line 101:
- * '''Remove DC offset''':  Button [DC] in the Record tab. When selected, for each channel, the  average value over the  entire current time window is subtracted from  the channel values. This means that if you change the length of  the  time window, the value that is removed from each channel may change.  It  doesn't make much sense to disable this option for unprocessed MEG  recordings.
+ * '''Increase/decrease gain''': Buttons '''[^]''' and '''[v]'''  on the right side of the figure. The  shortcuts for those buttons are  indicated in the tooltips (leave the  mouse for a short while over a  button).<<BR>>Hold the '''Shift key''' and scroll, or use the keys '''[+]''' and '''[-]'''.
 * '''Flip +/-''': Button in the right part of the time series figure. Exchange the direction of the Y axis, to have the peaks of negative values pointing up. Useful mostly for clinical EEG.
 * '''Set scale manually''': Button '''[...]''' in the figure. Opens a window to enter the amplitude scale manually. The value corresponds to the space between two horizontal lines in this figure.
 * '''Auto-scale amplitude''':  Button '''[AS]''' in the figure. <<BR>>Selected: the vertical scale is  adapted to the new maximum amplitude when you scroll in the file. <<BR>>Not selected: The vertical scale is fixed, scrolling in the file does not affect the display.
-Line 83:
+Line 106:
- * '''Apply CTF compensation''':  Button [CTF] in the Record tab. Enable/disable the CTF noise correction   based on the reference sensors, when it is not already applied in the   file. In the current file, the CTF 3rd order gradient compensation is   already applied, therefore this option is not available.
 * '''Flip +/-''': Button in the right part of the time series figure. Exchange the direction of the Y axis, useful mostly for clinical EEG.
 * '''Set scale manually''': Button [...] in the figure. Forces a defined amplitude scaling.
 * '''Auto-scale amplitude''':  Button [AS] in the figure. When  selected, the vertical scale is  adapted to the maximum value over the time window when the time window  changes. When  not selected: the vertical scales keeps its last value  when you jump to  another part of the file.
+ * '''Remove DC offset''':  Button '''[DC]'''  in the Record tab. When selected, the  average value  over the  entire current time window is subtracted from each channel. This means that if you change the length of  the  time window,  the value that is removed from each channel may change.  Always keep  this option selected for unprocessed MEG  recordings, unless you use a  high-pass filter.
-Line 88:
+Line 108:
-=== Online filter ===
With  the  Filter tab, you can apply a band-pass  filter to the recordings, or  remove a set of specific frequencies  (example: the 50Hz or 60Hz power  lines contamination and their harmonics). The filters are applied only  to the time window that is currently loaded; hence if the segment is too  short for the required filters, the results could be inaccurate.
+ * '''Apply CTF compensation''':   Button [CTF] in the Record tab. Enable/disable the CTF noise  correction   based on the reference sensors, when it is not already  applied in the   file. In the current file, the CTF 3rd order gradient  compensation is   already applied, therefore this option is not  available.

== Time and amplitude resolution ==
In  the Brainstorm interface, the axis resolution is usually set implicitly:  you can set the size of the window, the duration or recordings reviewed  at once and the maximum amplitude to  show in the figure. Those parameters are convenient to explore the recordings  interactively but don't allow us to have reproducible displays with  constant time and amplitude resolutions.

However, some applications are very sensitive to the horizontal and vertical scaling, such as  the visual detection of epileptic spikes. The shapes of traces the epileptologists try to identify are altered by the axes resolution. This is detailed in the tutorial [[http://neuroimage.usc.edu/brainstorm/Tutorials/Epilepsy|EEG and Epilepsy]].

For this reason, we also added a menu to set the figure resolution explicitly. The distance unit on  a screen is the pixel, we can set precisely how much time is represented by one  pixel horizontally and how much amplitude is represented by one pixel  vertically. <<BR>>Right-click on the figure >  Figure > Set axes resolution.

Note that this interface does not store  the input values, it just modifies the other parameters (figure size,  time window, max amplitude) to fit the resolution objectives. If  you modify those parameters after setting the resolution (resize the figure, leave the button [AS]  selected and scroll in time, etc) the resolution is lost, you have to  set it again manually.

 . {{attachment:review_resolution.gif||height="266",width="638"}}

== Online filters ==
With  the  Filter tab, you can apply a band-pass  filter to the recordings, or  remove a set of specific frequencies  (example: the 50Hz or 60Hz power  lines contamination and their harmonics). The filters are applied only  to the time window that is currently loaded. If the segment is too  short for the required filters, the results might be inaccurate.
-Line 93:
+Line 126:
-After  testing the high-pass, low-pass and notch filters, uncheck them. If not  you will probably forget about them, and they will stay on until you  restart Brainstorm.
+After  testing the high-pass, low-pass and notch filters, uncheck them. If not  you may forget about them, and they will stay on until you  restart Brainstorm. Note that as long as there are visualization filters applied, the title of the Filter tab remains red.
-Line 95:
+Line 128:
-{{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=onlineFilter.gif|onlineFilter.gif|class="attachment"}}
+ . {{attachment:review_filter.gif||height="191",width="593"}}
-Line 97:
+Line 130:
-== Shortcut summary ==
=== Keyboard shortcuts ===
+== Mouse and keyboard shortcuts ==
==== Keyboard shortcuts ====
-Line 100:
+Line 133:
-  * No other key: Change current time, sample by sample
  * With '''Control '''key: Jump to previous/next time segment (same as the "<<<" and ">>>" buttons)
  * With '''Shift '''key: Jump to next event of the selected group
  * On  MacOS, these shortcuts are different: please read the tooltips from the  buttons ">", ">>", and ">>>" in the time panel to get  the appropriate shortcuts.
+  * Change current time, sample by sample
  * '''+Control '''key: Jump to previous/next epoch or page  (same as [<<<] and [>>>])
  * '''+Shift '''key: Jump to previous/next event
  * MacOS: These shortcuts are different, please read the tooltips for [>], [>>] and [>>>]
-Line 105:
+Line 138:
-  * Same as left/right arrows, but faster (10 samples at a time)
  * If epochs are defined in the file: '''Control + page-up/page-down''' jumps to the next/previous epoch.
+  * Change current time, 10 samples at a time
  * '''+Control '''key: Jump to the next/previous epoch or page, 10x faster
-Line 110:
+Line 143:
- * '''Control + E''': Add / delete event occurrence
+ * '''Shift + Letter''':  Changes the montage
 * '''Control + B''': Mark selected time segment as bad
 * '''Control + D''': Dock figure
 * '''Control + E''': Add / delete event marker
 * '''Control + F''': Open a copy of the figure, not managed by the Brainstorm window manager
 * '''Control + I''': Save figure as image
 * '''Control + J''': Open a screen capture of the figure
-Line 112:
+Line 151:
- * '''Shift + Letter''':  Changes the set of electrodes currently displayed in the figure (list  available by right-clicking on the figure > Display setup > ...)
 * '''Enter''': Display the selected channels in a separate figure (selected channels = lines on which you clicked, that are shown in red)
+ * '''Enter''': Display the selected channels in a separate figure
-Line 117:
+Line 155:
-=== Mouse shortcuts ===
 * '''Mouse click on a channel''': Select the channel
 * '''Mouse click''': Change current time
 * '''Mouse click + Shift''': For the selection of the current time (do not select any sensor, even when clicking on a line)
+==== Mouse shortcuts ====
 * '''Click on a channel''': Select the channel
 * '''Click''': Change current time
 * '''Shift + click''': Force the selection of the current time (even when clicking on a channel)
-Line 122:
+Line 160:
- * '''Mouse click + move''': Select time range
 * '''Mouse wheel''': Zoom around current time
 * '''Control + mouse wheel''': Zoom vertically
 * '''Shift + mouse wheel''': Adjust the vertical scale of the time series
+ * '''Click + move''': Select time range
 * '''Scroll''': Zoom around current time
 * '''Shift + scroll''': Adjust the vertical scale of the time series
 * '''Control + scroll''': Zoom vertically
-Line 130:
+Line 168:
-= From CTF =
== Time selection ==
Go back to  the previous view mode ("butterfly view") and in the Record tab, select  the menu "All channels" again. Keep this selection for the rest of the  tutorial.

 * Left-click  somewhere on the white part of the time series figure, hold  the mouse  button, and drag your mouse left or right: A transparent blue  rectangle  appears to represent the time selection.
 * Now  right-click on the figure to see the functions you can apply on this  time window. The selected time window and its duration are shown at the  bottom of the figure.
  . {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutExploreRecodings?action=AttachFile&do=get&target=timeSelection.gif|timeSelection.gif|class="attachment"}}

 * '''Set current time''':  Just sets the time cursor when the right-click occurred. The shortcut  Shift+Click can be useful when trying to move in time on dense displays  in columns view.

 * '''Set selection manually''': Select a time window by giving the bounds in ms.

 * '''Average over time''': Average over the selected time window, saved as a new file in the database.

 * '''Export to database''': Extract the recordings and save them in a new file in database.
  * If some sensors are selected, only their values are extracted, all the others are set to zero.

 * '''Export to file''': Same, but in a user-defined file (not in the database)

 * '''Export to Matlab''': Same, but export as a Matlab variable in the current workspace.

== Bad channels ==
If you find  out that a sensor has unexpected values, that are not coherent with the  other surrounding sensors, you can choose to ignore it in the displays  and in the source estimation process. In the channel file, each channel  has a flag which indicates if it is good or bad. You may also import  recordings files that already have some bad channels defined.

 * Select  a few channels with one of the method described above: click on the  time series, click on the sensors dots, right-click and move to select a  group of sensors. Then right-click in one of the figures and check out  the '''Channels''' sub-menu:
  . {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutExploreRecodings?action=AttachFile&do=get&target=channelMenu.gif|channelMenu.gif|class="attachment"}}
  * '''View selected''': Show the time series of the selected sensors

  * '''Mark selected as bad''': Remove sensors from the display and all the further computations

  * '''Mark non-selected as bad''': Keep only the selected channels

  * '''Reset selection''': Unselect all the selected sensors

  * '''Mark all channels as good''': Brings back all the channels to display

  * '''Edit good/bad channels''':  Opens an interface that looks like the channel editor, but with one  extra column to edit the status (good or bad) of each channel.

 * '''Mark channels as bad''': Right-click > ''Channels > Mark selected as bad'', or press ''Delete ''key.  The sensors should disappear in all figures, and the topography view  (2D sensors cap) is updated so that the interpolation on the 2D surface  now ignores the bad channels.
  . {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutExploreRecodings?action=AttachFile&do=get&target=channelSetBad.gif|channelSetBad.gif|class="attachment"}}

 * '''Get the channels back''': two options
  * Right-click on figure > ''Channels > Mark all channels as good<<BR>> ''

  * Right-click on figure ''> Channels > Edit good/bad channels...''  : this menu open a window very similar to the Channel Editor window  introduced in previous tutorials, but without the annoying location and  orientation values, and with green and red dots. Click on the dots to  mark a channel as good or bad.
 ''' {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutExploreRecodings?action=AttachFile&do=get&target=channelEditGoodBad.gif|channelEditGoodBad.gif|class="attachment"}} '''
  * Note  that if you click on a row in this window, it will select the  corresponding channel in the time series and topography figures.
  * Close this window to save the changes.

 * '''Batching this from the database explorer''':
  * You will find a "Channels" menu for any node in the tree that contains recordings.
  * If  you do this on the level of a node, the operation will be applied  recursively to all the recordings contained in the node. This way, you  can quickly set that the channel 63 is always bad, or that electrode 43  is not working for subject #12, without having to visualize all the  recordings one after the other.
  * The'' View all bad channels'' command displays the list of all the bad channels in all the files in the ''Messages ''tab, in main Brainstorm window.
  {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutExploreRecodings?action=AttachFile&do=get&target=channelTreePopup.gif|channelTreePopup.gif|class="attachment"}}

 * '''Important notes''':
  * The good/bad channel flags are stored in the recordings files, not in the channel files. So if you marked some channels as ''bad ''in the ''ERF ''data file, there are still considered as ''good ''in the ''Std ''data file.

Software

Users

Development