Jump to content

Contributions:gEstimFilter

From BCI2000 Wiki
Revision as of 20:09, 25 January 2021 by Abelsten (talk | contribs) (Created page with "==Synopsis== This filter allows for cortical stimulation with the g.tec gEstim PRO. ==Versioning== ===Authors=== Kristopher Kaleb Goering (kaleb.goering@gmail.com) Alexander...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Synopsis

This filter allows for cortical stimulation with the g.tec gEstim PRO.

Versioning

Authors

Kristopher Kaleb Goering (kaleb.goering@gmail.com) Alexander Belsten (belsten@neurotechcenter.org)

Source Code Revisions

  • Initial development: --
  • Tested under: 6191
  • Known to compile under: 6191
  • Broken since: --

Functional Description

This extension resides in the Application module and allows for electrical stimulation. Note: As of rev.6131, this extension does not work the the gEstim FES Research. The extension has only been tested with the g.Estim PRO.


Integration into BCI2000

This extension resides in the private directory of BCI2000. It must be enabled in CMake by selecting BUILD_GESTIMFILTER. Then recompile the BCI2000FrameworkAppModule, and the application module you are using. Lastly, append the enable flag to your batch file (ex: Start executable StimulusPresentation --local --ActivateEstim=1).

Usage

Parameters

The gEstim device is configured in the gEstim tab. The configurable parameters are:

ActivateEstim

Enables/disables stimulation.

UseStimulusPresentation

Figure 1: Adding an additional row labeled EstimOn to stimuli to trigger stimulation

This parameter can be enabled when using the Stimulus Presentation application module, and it is desired to stimulate on a particular stimulus, as defined in Stimulus Presentation's Stimuli parameter. To configure this functionality, enable this parameter and then navigate to the Application tab in BCI2000 and scroll down to the Stimuli matrix, as shown in Fig. 1. After opening the Stimuli matrix, add another row and name it EstimOn. Now, stimulation will be triggered on all stimuli defined in this matrix has its EstimOn row set to 1. Stimulation will not occur on stimuli that have this row set to 0.

StimulationExpression

Expression to start g.Estim stimulation. See the expression page for more details on how to define an expression.

AbortExpression

Expression to abort g.Estim stimulation.

Modularity

Modularity of pulses; Biphasic or Monophasic

Polarity

Polarity of pulses; Alternating or Steady

PhaseDuration

Duration of time of each +/- phase.

InterphaseDuration

Duration of time with no stimulation between each pulse's phases.

Magnitude

Magnitude of the pulse in milliamps. This quantity is peak-to-zero.

NumberOfPulses

Number of pulses per train.

PulseFrequency

Frequency of each pulse in a train.

NumberOfTrains

Number of trains.

FrequencyOfTrains

Frequency of trains.

Jitter

Jitter of train between 0 and 100% in increments of 1%

ElectrodeType

Type of electrode being used: 1 Circle, 2 Depth, 3 Other.

CircleDiameter

Exposed diameter of the electrode in micrometers in increments of 1um

UsingDepthElectrode

Enables/Disables use of depth electrodes

ContactDiameter

Contact diameter of the electrode in micrometers in increments of 1um

ContactLength

Contact length of the electrode in micrometers in increments of 1um

UsingOtherElectrode

Enables/Disables use of other type of electrodes

ExposedSurfaceArea

Exposed surface area of electrode in square micrometers between in increments of 1um^2

State Variables

EstimStimulus

This binary state is 1 when a stimulation train is running and 0 otherwise.

See also

User Reference:Logging Input, Contributions:Extensions