Contributions:LSLSource: Difference between revisions

Revision as of 20:50, 18 September 2017

LSLSource

Function

"LSLSource" is a source module that can use Labstreaminglayer to require data from different hardware, such as OpenBCI, USBAmp, and eyes tracker. This source module can automatically detect the sampling rate and number of channels of the input signal and configure the output signal.

Labstreaminglayer

The lab streaming layer (LSL) is a system for the unified collection of measurement time series in research experiments that handles both the networking, time-synchronization, (near-) real-time access as well as optionally the centralized collection, viewing and disk recording of the data. More information can be found at [1]

API Documentation

LSL has API for C++/C Python and Java. For BCI2000, we use C. The Documentation can be found at [2].

Installation

The masters for different hardware must be installed first. The Github link for applications can be found at [3].

Parameters:LSLSource

Parameters common to all source modules are described under User Reference:DataIOFilter. In addition, the LiveAmpADC provides the following parameters:

SourceCh

The number of channels will be automatically detected by the source module. User doesn't need to set it.

SampleBlockSize

Samples per channel per digitized block. Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 500 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 25 times per second. This variable will change as using different device. User can find the best sampling block size on the hardware spec sheet.

SamplingRate

The sample rate of the system. Different hardware has different sampling rate. This source module can automatically detect the sampling rate for different hardware. The sampling rate should be compatible with sample block size. In case you are experiencing problems by higher sampling rates (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

SourceChGain

Gain for each channel.

SourceChOffset

Offset for each channel.

ChannelNames

Names of each channel.

@@ Line 3: / Line 3: @@
 ==Function==
-"LSLSource" can collect data from different hardware and feed it into "BCI2000" for further analysis in real time.
+"LSLSource" is a source module that can use Labstreaminglayer to require data from different hardware, such as OpenBCI, USBAmp, and eyes tracker. This source module can automatically detect the sampling rate and number of channels of the input signal and configure the output signal.
 ===Labstreaminglayer===
@@ Line 9: / Line 9: @@
 The lab streaming layer (LSL) is a system for the unified collection of measurement time series in research experiments that handles both the networking, time-synchronization, (near-) real-time access as well as optionally the centralized collection, viewing and disk recording of the data.
 More information can be found at [https://github.com/sccn/labstreaminglayer/wiki/ExampleCode.wiki]
-===Programs For LSL===
-There are essentially two types of programs interacting with LSL: programs that provide data, such as a data source that represents a particular acquisition device, and programs that consume data (and occasionally mixtures of the two), such as a viewer, a recorder, or a program that takes some action based on real-time data.
-===LSLSource Hardware===
-Different hardware can be connected to the LSLSource including "USBAmp" "OpenBCI" "Mouse" ... All the masters to the hardware are provide on GitHub.
 ===API Documentation===