Jump to content

User Reference:BCI2000Viewer: Difference between revisions

From BCI2000 Wiki
Mellinger (talk | contribs)
Mellinger (talk | contribs)
No edit summary
Line 1: Line 1:
''BCI2000Viewer'' displays brain signal data and [[BCI2000 Glossary#State|state variables]] contained in [[Technical Reference:BCI2000 File Format|BCI2000 data files]].
''BCI2000Viewer'' displays brain signal data and [[BCI2000 Glossary#State|state variables]] contained in [[Technical Reference:BCI2000 File Format|BCI2000 data files]].
For recordings containing audio and/or video content, it can play back audio and/or video in conjunction with scrolling through the data file in real-time.


[[Image:BCI2000Viewer.PNG]]
[[Image:BCI2000Viewer.PNG]]
Line 50: Line 52:
|}
|}


====Unit Display====
==Unit Display==
{{UnitDisplay}}
{{UnitDisplay}}


====Choosing Signal Colors====
==Choosing Signal Colors==
{{ChooseColors}}
{{ChooseColors}}
==AV Playback==
In BCI2000Viewer, there is an AV Playback tool bar floating on top of other windows.
It allows to scroll through a recording in real-time or a fraction or multiple thereof.
Also, it contains controls for navigating through a recording, and setting the relative speed of playback.
If AV content is available, video data will be displayed in secondary windows. Audio will be played back through the output set as default in the system preferences.
===AV Synchronization Strategies===
====Audio Only====
====Video Only====
====Audio and Video====


==See also==
==See also==

Revision as of 12:44, 4 June 2025

BCI2000Viewer displays brain signal data and state variables contained in BCI2000 data files.

For recordings containing audio and/or video content, it can play back audio and/or video in conjunction with scrolling through the data file in real-time.

Opening Files

To open a data file, drag-and-drop it into the program's main window. Alternatively, double-click a .dat file in Windows Explorer, and choose BCI2000 FileViewer when prompted for an application program to associate with the .dat extension.

Browsing

User interface elements for browsing are located at the top right, within the tool bar.

  • |<< and >>| move to beginning/end of file;
  • << and >> move forward/backward by entire pages (i.e., the amount of time displayed in the window);
  • < and > move forward/backward by sample blocks;
  • the position field displays the current position in hh:mm:ss format, followed by the total length of the file. Entering a value in seconds, or in hh:mm:ss format, will move the center of the display to the specified position.

Tool Bar

The tool bar contains icons for horizontal and vertical zoom, reducing or enlarging the number of channels displayed on a vertical display page. Also, the tool bar allows to enable and disable the display grid, open and close the channel color selector, and switch between light and dark display mode. Further, there are menus for High Pass, Low Pass, and Notch filter options in the tool bar.

For all tool bar options, there are corresponding menu items in the "View" and the context menu (right-click on the display).

Selecting States and Channels for Display

Once a file is opened in BCI2000 Viewer, the area to the right displays a list of state variables and brain signal channels contained in the data file. By default, all channels are selected for display, and none of the states are. To display one or more state, mark the respective checkbox.

State names and values are displayed above the signal. State values are normalized to the available range. To see the actual value of a state, move the mouse cursor to the desired position, and let it rest there for one or two seconds. A tooltip will appear, displaying the state name and value.

Display Tool Tips

Whenever the mouse pointer is at rest for one or two seconds above the channel and state display, a tool tip will be displayed that contains state or channel name, and the state or channel value. This is especially useful for states where there is not enough space in the display to indicate a range of values.

Display Properties

Similar to the signal display in the operator module, display properties may be changed from the View menu (which is reduplicated as a context menu that appears by right-clicking the signal display).

Also, the following keyboard shortcuts are provided:

up/down back/forward one channel,
page-up/page-down back/forward one screenful of channels,
'b'/space same as page-up/page-down ('less'-like shortcuts),
-/+ reduce/enlarge the signal,
,/. fewer/more channels,
left/right slow down/speed up the time sweep,
home/end jump to the first/last screenful of channels,
typing a number and pressing return (or 'g') jump to the specified channel number.

Unit Display

When the signal's physical unit is displayed, it is represented as a white bar if the dark theme is selected, and as a black bar if the bright theme is selected.

In the example, there are white markers above and below the bar, indicating the range corresponding to the value written in the bar. These markers may be missing; then the range corresponds to the height of the bar itself.

Finally, the physical unit may be displayed with a marker attached to the bar:

This display is used for nonnegative signals. Here, the physical unit corresponds to the distance of the marker to the signal's baseline.

Choosing Signal Colors

Clicking the color wheel in the toolbar, or the Choose Signal Colors... entry from the context menu, will open up a color chooser dialog.

The Channel Color Selector

This dialog contains the elements of a standard color chooser dialog at the top, followed with two preview fields which display the user's color choice in both the dark and light color context which is available as a choice in the user interface.

Further below, there are three buttons that provide the main functionality of the color selector dialog:

  • an "Apply to selected channels" button that applies the current color selection to all selected channels,
  • an "Apply pattern" button that applies the pattern in the first N channels to all further channels,
  • an "Undo all changes" button that allows the user to go back the colors that were in use when the dialog was first opened.

AV Playback

In BCI2000Viewer, there is an AV Playback tool bar floating on top of other windows. It allows to scroll through a recording in real-time or a fraction or multiple thereof. Also, it contains controls for navigating through a recording, and setting the relative speed of playback.

If AV content is available, video data will be displayed in secondary windows. Audio will be played back through the output set as default in the system preferences.

AV Synchronization Strategies

Audio Only

Video Only

Audio and Video

See also

User Reference:BCI2000FileInfo