|
Size: 13742
Comment:
|
← Revision 85 as of 2019-10-04 08:33:25 ⇥
Size: 16110
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 7: | Line 7: |
| * 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 * '''SysClock''': System clock, unused * Select > MEG > Display time series (or double-click on the file).<<BR>><<BR>> {{attachment:link_menu.gif||height="322",width="324"}} * It will open a new figure and enable many controls in the Brainstorm window.<<BR>><<BR>> {{attachment:review_epoch.gif}} |
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: * '''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). . {{attachment:link_menu.gif}} It will open a new figure and enable many controls in the Brainstorm window. {{attachment:review_epoch.gif}} |
| Line 26: | Line 32: |
| 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. | 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. These 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 29: | Line 35: |
| * '''Click''': Click on the white parts of figure to move the time cursor (red vertical line).<<BR>>If you click on the signals, it will select the corresponding channels, click again to unselect. | * '''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. |
| Line 31: | Line 37: |
| * '''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 more. | * '''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). |
| Line 44: | Line 51: |
| * '''Start''': Starting point of the time segment displayed in the figure. Useful is continuous mode only. * '''Duration''': Length of this time segment. Useful is continuous mode only. |
* '''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 47: | Line 54: |
| '''Time selection''' |
==== Time selection ==== |
| Line 51: | Line 57: |
| * At the bottom of the figure, you will see the duration of the selected block. | * At the bottom of the figure, you will see the duration of the selected block, and min/max values. |
| Line 53: | Line 59: |
| * Click anywhere on the figure to cancel this time selection. <<BR>><<BR>> {{attachment:review_timesel.gif||height="159",width="434"}} | * To zoom into the selection: Shift+left click, middle click, or right-click > Time selection > Zoom into. * Click anywhere on the figure to cancel this time selection. <<BR>><<BR>> {{attachment:review_timesel.gif}} |
| Line 57: | Line 64: |
| * 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 can change this manually, to process it as a continuous file. |
* 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 these 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. |
| Line 60: | Line 67: |
| * 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"}} |
* 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.<<BR>><<BR>> {{attachment:review_continuous.gif}} * With the red square at the bottom of the figure, you can navigate in time (click in the middle and drag with the mouse) or change the size of the current page (click on the left or right edge of the red square and move your mouse). <<BR>><<BR>> {{attachment:resize_page.gif}} * Increase the duration of the displayed window to '''3 seconds''' (Page settings > Duration). <<BR>><<BR>> {{attachment:review_setpage.gif}} |
| Line 67: | Line 75: |
| == Display mode == | == Display mode: Butterfly/Column == |
| Line 70: | Line 78: |
| * What we see now are all the traces of the 274 sensors on top of each other. | * What we see are all the traces of the 274 sensors overlaid on top of each other. |
| Line 72: | Line 80: |
| * Now all the signals are displayed in columns, but all the channels are displayed in the same figure, which makes it unreadable. We need to select only a subset of those sensors. <<BR>><<BR>> {{attachment:review_column.jpg||height="255",width="522"}} | * 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 these sensors. <<BR>><<BR>> {{attachment:review_column.jpg||width="381",height="186"}} |
| Line 75: | Line 83: |
| * * 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. {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=tsChannelSelection.gif|tsChannelSelection.gif|class="attachment"}} |
* 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 shortcut on the right for All channels (Shift+A). You can define your own (Shift+B, C...) if you go to Edit montages. * 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). <<BR>><<BR>> {{attachment:review_montage.gif||width="527",height="190"}} * More information about the [[Tutorials/MontageEditor|Montage editor]]. |
| Line 81: | Line 92: |
| If you click on the lines instead of the white area: select channels. | 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. * 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. * The management of the bad channels will be introduced in a [[Tutorials/BadChannels|separate tutorial]].<<BR>><<BR>> {{attachment:channel_select.gif||width="615",height="246"}} |
| Line 84: | Line 99: |
| In this display mode, the amplitude scale is represented on the right of the figure. You can adjust this vertical scale: | A variety of display options allows you to adjust the amplitude scale for the recordings (vertical axis). Most of these options are available in the right part of the time series figure, some are repeated in the Record tab of the Brainstorm window. |
| Line 86: | Line 101: |
| * 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. |
. {{attachment:review_scale.gif}} |
| Line 90: | Line 103: |
| 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. | * '''Increase/decrease gain''': Buttons '''[+]''' and '''[-]''' on the right side of the figure. The shortcuts for these buttons are indicated in the tooltips (leave the mouse for a short while over a button): right-click and move your mouse, hold the '''Shift key''' and scroll, or use the keys '''"+"''' and '''"-"'''. |
| Line 92: | Line 105: |
| == Display options == . {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=displayOptions.gif|displayOptions.gif|class="attachment"}} |
* '''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 axis resolution. * '''Flip Y axis''': Exchange the direction of the Y axis, to have the peaks of negative values pointing up. Useful mostly for clinical EEG. * '''Set amplitude scale''': Opens a window to enter the amplitude scale manually. The value corresponds to the space between two horizontal lines in this figure. * '''Set axis resolution''': See section "Time and amplitude resolution" below. |
| Line 95: | Line 110: |
| * '''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. | * '''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 97: | Line 112: |
| * '''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. |
* '''Normalize signals''': Divide each signal by its maximal amplitude in the displayed time window. The signals displayed with this normalization are unitless. |
| Line 102: | Line 114: |
| == 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. |
| Line 105: | Line 116: |
| 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. | * '''Vertical zoom''': Use the zoom/scrolll buttons on the right of the figure or your mouse (CTRL+Mouse wheel to zoom, middle-click+move to scroll) in order to look at specific channels without having to change the montage. |
| Line 107: | Line 118: |
| 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. | . {{attachment:review_vscroll.gif}} |
| Line 109: | Line 120: |
| {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutRawViewer?action=AttachFile&do=get&target=onlineFilter.gif|onlineFilter.gif|class="attachment"}} | * '''Uniform amplitude scales''': Force all the time series figures to use the same amplitude scale. Option available in the Record tab with the button {{attachment:uniform_button.gif}} or from the figure options menu when at least two time series figures are visible. [[https://neuroimage.usc.edu/brainstorm/Tutorials/MultipleWindows#Uniform_amplitude_scales|More details]]. |
| Line 111: | Line 122: |
| == Shortcut summary == === Keyboard shortcuts === |
<<TAG(Advanced)>> == 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. These 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 an option 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>>Display menu in the right part of the figure > Amplitude > Set axis resolution (shortcut: CTRL+O) 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 these 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}} == Filters for visualization == 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. These visualization filters provide a quick estimate for visualization only, the results are not saved anywhere. To filter properly the continuous files, please use the Process1 tab (see [[http://neuroimage.usc.edu/brainstorm/Tutorials/ArtifactsFilter#What_filters_to_apply.3F|tutorial #10]]).<<BR>>The option "'''Filter all results'''" is not useful for now, it will be described later. After testing the high-pass, low-pass and notch filters, uncheck them. Otherwise you may forget about them, they would stay on until you restart Brainstorm. Note that as long as there are visualization filters applied, the title of the Filter tab remains red. . {{attachment:review_filter.gif||width="546",height="173"}} == Mouse and keyboard shortcuts == ==== Keyboard shortcuts ==== |
| Line 114: | Line 147: |
| * 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 (you need to have one event selected) * MacOS: These shortcuts are different, please read the tooltips for [>], [>>] and [>>>] |
| Line 119: | Line 152: |
| * 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. * '''F3/Shift+F3''': Jump to the next/previous epoch or page * '''F4/Shift+F4''': Jump to the next/previous half-page |
* 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 (10% overlap between 2 pages) * '''F4/Shift+F4''': Jump to the next/previous half-page (50% overlap) * '''F6/Shift+F6''': Jump to the next/previous page with no overlap (0% overlap) |
| Line 124: | Line 158: |
| * '''Control + E''': Add / delete event occurrence | * '''Shift + Letter''': Changes the montage * '''Control + B''': Mark selected time segment as bad * '''Control + D''': Dock figure * '''E''': Add / delete event marker * '''Control + E''': Add / delete event marker for the selected channels * '''Control + F''': Open a copy of the figure, not managed by the Brainstorm window manager * '''Control + H''': Hide/show selected event group * '''Control + I''': Save figure as image * '''Control + J''': Open a copy of the figure as an image * '''Control + O''': Set axes resolution * '''Control + L''': Change display mode of events (dots, lines or hidden) * '''Control + J''': Open a screen capture of the figure |
| Line 126: | Line 171: |
| * '''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 130: | Line 174: |
| * '''1 2 3 4 5 6 7 8 9''': User-defined shortcuts for new events ([[https://neuroimage.usc.edu/brainstorm/Tutorials/EventMarkers#Custom_shortcuts|tutorial #7]]) | |
| Line 131: | Line 176: |
| === 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 136: | Line 181: |
| * '''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 |
| Line 141: | Line 184: |
| * '''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) |
* '''Right-click + move''': Adjust the vertical scale of the time series |
| Line 144: | Line 186: |
| = 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. |
* '''Scroll''': Zoom around current time * '''Shift + scroll''': Adjust the vertical scale of the time series * '''Control + scroll''': Zoom vertically * '''Central click + move''': Move in a zoomed figure * '''Double click''': Restore initial zoom settings (or edit the notes associated to the clicked event) |
| Line 148: | Line 192: |
| * 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"}} |
<<HTML(<!-- END-PAGE -->)>> |
| Line 152: | Line 194: |
| * '''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. <<EmbedContent("http://neuroimage.usc.edu/bst/get_prevnext.php?prev=Tutorials/ChannelFile&next=Tutorials/MontageEditor")>> |
<<EmbedContent("http://neuroimage.usc.edu/bst/get_prevnext.php?prev=Tutorials/ChannelFile&next=Tutorials/MultipleWindows")>> |
Tutorial 5: Review continuous recordings
Authors: Francois Tadel, Elizabeth Bock, John C Mosher, Sylvain Baillet
Contents
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. These 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, and min/max values.
- Useful for quickly estimating the latencies between two events, or the period of an oscillation.
To zoom into the selection: Shift+left click, middle click, or right-click > Time selection > Zoom into.
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 these 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.
With the red square at the bottom of the figure, you can navigate in time (click in the middle and drag with the mouse) or change the size of the current page (click on the left or right edge of the red square and move your mouse).
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 these 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 shortcut on the right for All channels (Shift+A). You can define your own (Shift+B, C...) if you go to Edit montages.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).
More information about the Montage editor.
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.
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). Most of these options are available in the right part of the time series figure, some are repeated in the Record tab of the Brainstorm window.
Increase/decrease gain: Buttons [+] and [-] on the right side of the figure. The shortcuts for these buttons are indicated in the tooltips (leave the mouse for a short while over a button): right-click and move your mouse, hold the Shift key and scroll, or use the keys "+" and "-".
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 axis resolution.Flip Y axis: Exchange the direction of the Y axis, to have the peaks of negative values pointing up. Useful mostly for clinical EEG.
Set amplitude scale: Opens a window to enter the amplitude scale manually. The value corresponds to the space between two horizontal lines in this figure.
Set axis resolution: See section "Time and amplitude resolution" below.
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.
Normalize signals: Divide each signal by its maximal amplitude in the displayed time window. The signals displayed with this normalization are unitless.
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.
Vertical zoom: Use the zoom/scrolll buttons on the right of the figure or your mouse (CTRL+Mouse wheel to zoom, middle-click+move to scroll) in order to look at specific channels without having to change the montage.
Uniform amplitude scales: Force all the time series figures to use the same amplitude scale. Option available in the Record tab with the button
or from the figure options menu when at least two time series figures are visible. More details.
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. These 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 an option 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.
Display menu in the right part of the figure > Amplitude > Set axis resolution (shortcut: CTRL+O)
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 these 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.
Filters for visualization
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.
These visualization filters provide a quick estimate for visualization only, the results are not saved anywhere. To filter properly the continuous files, please use the Process1 tab (see tutorial #10).
The option "Filter all results" is not useful for now, it will be described later.
After testing the high-pass, low-pass and notch filters, uncheck them. Otherwise you may forget about them, they would 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 (you need to have one event selected)
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 (10% overlap between 2 pages)
F4/Shift+F4: Jump to the next/previous half-page (50% overlap)
F6/Shift+F6: Jump to the next/previous page with no overlap (0% overlap)
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
E: Add / delete event marker
Control + E: Add / delete event marker for the selected channels
Control + F: Open a copy of the figure, not managed by the Brainstorm window manager
Control + H: Hide/show selected event group
Control + I: Save figure as image
Control + J: Open a copy of the figure as an image
Control + O: Set axes resolution
Control + L: Change display mode of events (dots, lines or hidden)
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
1 2 3 4 5 6 7 8 9: User-defined shortcuts for new events (tutorial #7)
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
Right-click: Display popup menu
Right-click + move: Adjust the vertical scale of the time series
Scroll: Zoom around current time
Shift + scroll: Adjust the vertical scale of the time series
Control + scroll: Zoom vertically
Central click + move: Move in a zoomed figure
Double click: Restore initial zoom settings (or edit the notes associated to the clicked event)