Contributions:CereStim - Revision history

Wengelhardt at 21:56, 15 July 2025

2025-07-15T21:56:44Z

← Older revision		Revision as of 21:56, 15 July 2025
Line 29:		Line 29:
	The configurable parameters are:		The configurable parameters are:

	~~===AcquisitionMode===~~
	There are 2 modes: the '''default stimulation mode''', then the '''impedance measurement mode'''. The only difference is that the impedance measurement mode prints out the impedance of the used electrodes when you set the configuration, and the default stimulation mode does not. The electrodes that are printed out are the electrodes that are listed in the [[#StimulationTriggers\|StimulationTriggers parameter]].
	===ImpedanceMeasurement===		===ImpedanceMeasurement===
	Enable to measure the impedance of the used electrodes in [[#StimulationTriggers\|StimulationTriggers parameter]]. It starts measuring when you press "Set Config" in a separate window.		Enable to measure the impedance of the used electrodes in [[#StimulationTriggers\|StimulationTriggers parameter]]. It starts measuring when you press "Set Config" in a separate window.

Wengelhardt: /* Parameters */

2024-04-11T15:29:41Z

Parameters

← Older revision		Revision as of 15:29, 11 April 2024
Line 74:		Line 74:
	** ''Interphase duration'': 53 - 65,535 us		** ''Interphase duration'': 53 - 65,535 us
	** ''Balanced Phase'': Phase 1 * Width 1 '''must equal''' Phase 2 * Width 2		** ''Balanced Phase'': Phase 1 * Width 1 '''must equal''' Phase 2 * Width 2
			** ''Train Repetitions'': 0 - 65,535 OR infinite (by setting Train Duration to 0 with a Train Frequency)

	===StimulationTriggers===		===StimulationTriggers===

Wengelhardt: /* States */

2024-03-05T19:35:35Z

States

← Older revision		Revision as of 19:35, 5 March 2024
Line 96:		Line 96:
	==States==		==States==
	===CereStimStimulation===		===CereStimStimulation===
	This binary state is equal to <code>1</code> when stimulation is being applied.		This binary state is equal to <code>1</code> when stimulation is being applied. This is set by the CereStim hardware, and might not be accurate for quick stimulation pulses.
			===CereStimStimulationSoftware===
			Equal to 1 when stimulation is being applied, from BCI2000's point of view. This can better capture quick stimulation pulses.
	===CereStimUploadStatus===		===CereStimUploadStatus===
	The configuration number that is currently uploaded, e.g., 1 is the first column in the StimulationConfigurations table. If multiple configurations are uploaded, the two ids are added together.		The configuration number that is currently uploaded, e.g., 1 is the first column in the StimulationConfigurations table. If multiple configurations are uploaded, the two ids are added together.

Wengelhardt at 17:15, 4 March 2024

2024-03-04T17:15:00Z

← Older revision		Revision as of 17:15, 4 March 2024
Line 97:		Line 97:
	===CereStimStimulation===		===CereStimStimulation===
	This binary state is equal to <code>1</code> when stimulation is being applied.		This binary state is equal to <code>1</code> when stimulation is being applied.
			===CereStimUploadStatus===
			The configuration number that is currently uploaded, e.g., 1 is the first column in the StimulationConfigurations table. If multiple configurations are uploaded, the two ids are added together.

	==[[User_Reference:StimulationConfigurationIntegrativeTool_(SCIT)\|SCIT]]==		==[[User_Reference:StimulationConfigurationIntegrativeTool_(SCIT)\|SCIT]]==

Wengelhardt at 16:54, 15 December 2023

2023-12-15T16:54:32Z

← Older revision		Revision as of 16:54, 15 December 2023
Line 55:		Line 55:

	===StimulationConfigurations===		===StimulationConfigurations===
	<gallery mode="packed" widths=~~800px~~ heights=~~800px~~>		<gallery mode="packed" widths=400px heights=400px>
	File:CerestimStimulation.png\|Figure 2: Stimulation pulse shape and train shape definition. The stimulation pulses on the left would take place during the "Stimulation duration" phase on the right.		File:StimulationConfigurations.PNG\|Figure 2: Stimulation pulse shape definition in BCI2000.
			File:CerestimStimulation.png\|Figure 3: Stimulation pulse shape and train shape definition. The stimulation pulses on the left would take place during the "Stimulation duration" phase on the right.
	</gallery>		</gallery>

	~~<gallery mode="packed" widths=350px heights=350px>~~
	~~File:StimulationConfigurations.PNG\|Figure 3: Stimulation pulse shape definition in BCI2000.~~
	~~</gallery>~~
	This parameter is where stimulation pulses are defined. You can define up to 15 different stimulation pulses. The pulse shapes are defined according to Fig. 2.		This parameter is where stimulation pulses are defined. You can define up to 15 different stimulation pulses. The pulse shapes are defined according to Fig. 2.

Wengelhardt at 16:50, 15 December 2023

2023-12-15T16:50:29Z

← Older revision		Revision as of 16:50, 15 December 2023
Line 35:		Line 35:
	===DynamicConfiguration===		===DynamicConfiguration===
	Enable to dynamically load stimulation configurations during the experiment. This allows you to have more than 15 configurations. This makes the Expression in [[#StimulationTriggers\|StimulationTriggers parameter]] upload the desired configuration, and then [[#StartExpression\|StartExpression]] trigger the uploaded configuration. If there is no expression in [[#StartExpression\|StartExpression]], the stimulation will start immediately after being uploaded.		Enable to dynamically load stimulation configurations during the experiment. This allows you to have more than 15 configurations. This makes the Expression in [[#StimulationTriggers\|StimulationTriggers parameter]] upload the desired configuration, and then [[#StartExpression\|StartExpression]] trigger the uploaded configuration. If there is no expression in [[#StartExpression\|StartExpression]], the stimulation will start immediately after being uploaded.


			<gallery mode="packed" widths=500px heights=500px>
			File:Trigger Expression flowchart.jpg\|Flowchart which shows the stimulation behavior under the specified modes
			</gallery>


	===AppliedVoltage===		===AppliedVoltage===
	The CereStim drives current, so the applied voltage fluctuates according to the impedance between the current source (electrode) and drain. This dropdown parameter sets the maximum applied voltage. Note that there will be no notification that this maximum has been met.		The CereStim drives current, so the applied voltage fluctuates according to the impedance between the current source (electrode) and drain. This dropdown parameter sets the maximum applied voltage. Note that there will be no notification that this maximum has been met.

Wengelhardt: /* StimulationTriggers */

2023-12-15T16:20:41Z

StimulationTriggers

← Older revision		Revision as of 16:20, 15 December 2023
Line 75:		Line 75:
	</gallery>		</gallery>
	This parameter defines when electrodes are stimulated, with what configuration they are stimulated with, and what electrodes are stimulated.		This parameter defines when electrodes are stimulated, with what configuration they are stimulated with, and what electrodes are stimulated.
	* '''Expression:''' The ''Expression'' row ~~defines when electrodes are stimulated by specifying~~ a [https://www.bci2000.org/mediawiki/index.php/User_Reference:Expression_Syntax BCI2000 expression]. ~~When~~ this expression ~~evaluates~~ true, the ~~electrodes will be stimulated with the pulse shape defined~~ in the ''Configuration ID'' row. Note that two columns can have the same ''Expression'', which allows for concurrent stimulation between different electrode locations.		* '''Expression:''' The ''Expression'' row is where a [https://www.bci2000.org/mediawiki/index.php/User_Reference:Expression_Syntax BCI2000 expression] should be defined. If not in DynamicConfiguration mode, when this expression is true, the associated configuration in the ''Configuration ID'' row will be delivered. Note that two columns can have the same ''Expression'', which allows for concurrent stimulation between different electrode locations. If we are in DynamicConfiguration mode, then the expression uploads the associated configuration to the CereStim. If StartExpression is not defined, then stimulation will start immediately after.
	* '''Configuration ID:''' The ''Configuration ID'' row defines the applied pulse shape and corresponds to the column number in the ''StimulationConfiguration'' parameter. When multiple IDs are specified, they will occur in sequential order, with the subsequent stimulation configuration starting right when the previous one ends. However, using multiple IDs has not been tested thoroughly, and is not recommended.		* '''Configuration ID:''' The ''Configuration ID'' row defines the applied pulse shape and corresponds to the column number in the ''StimulationConfiguration'' parameter. When multiple IDs are specified, they will occur in sequential order, with the subsequent stimulation configuration starting right when the previous one ends. However, using multiple IDs has not been tested thoroughly, and is not recommended.
	* '''Electrode(s):''' Lastly, the ''Electrode(s)'' row specifies which electrodes will be stimulated. Elements in this row can be single values that specify a single electrode, or an embedded list in which you can specify multiple electrodes (from 1-96).		* '''Electrode(s):''' Lastly, the ''Electrode(s)'' row specifies which electrodes will be stimulated. Elements in this row can be single values that specify a single electrode, or an embedded list in which you can specify multiple electrodes (from 1-96).

Wengelhardt: /* StimulationConfigurations */

2023-12-08T23:42:20Z

StimulationConfigurations

← Older revision		Revision as of 23:42, 8 December 2023
Line 58:		Line 58:

	'''Additional Notes:'''		'''Additional Notes:'''
	* For each configuration, if the ''Cathode first'' row is <code>1</code>, then the ~~positive~~ magnitude pulse precedes the ~~negative~~ pulse. If this row is <code>0</code>, then the ~~negative~~ pulse precedes the ~~positive~~ pulse. The current sink for each pulse is the patient ground, which is the green safety connector on the back of the CereStim. However, suppose you wish to provide '''bipolar stimulation''' between two different electrodes within the brain. In that case, you can make two configurations that have the same pulse shape parameters but have reversed ''Cathode first'' parameters. These stimulation configurations can be triggered at the same time to approximate a bipolar stimulation pattern. Current can still potentially flow to the patient ground, but if the impedance between the two electrodes is significantly less than the impedance between the electrodes and patient ground, the majority of the current will flow between the two electrodes. Information on how to define these two electrodes can be found in the [[#StimulationTriggers\|StimulationTriggers]] parameter. Note that valid frequencies depend on the phase and interphase duration of the pulse.		* For each configuration, if the ''Cathode first'' row is <code>1</code>, then the negative magnitude pulse precedes the positive pulse. If this row is <code>0</code>, then the positive pulse precedes the negative pulse. The current sink for each pulse is the patient ground, which is the green safety connector on the back of the CereStim. However, suppose you wish to provide '''bipolar stimulation''' between two different electrodes within the brain. In that case, you can make two configurations that have the same pulse shape parameters but have reversed ''Cathode first'' parameters. These stimulation configurations can be triggered at the same time to approximate a bipolar stimulation pattern. Current can still potentially flow to the patient ground, but if the impedance between the two electrodes is significantly less than the impedance between the electrodes and patient ground, the majority of the current will flow between the two electrodes. Information on how to define these two electrodes can be found in the [[#StimulationTriggers\|StimulationTriggers]] parameter. Note that valid frequencies depend on the phase and interphase duration of the pulse.
	* If a train still has more time in its desired duration, '''new expressions won't be triggered'''. This is a software constraint and can be changed with future implementation.		* If a train still has more time in its desired duration, '''new expressions won't be triggered'''. This is a software constraint and can be changed with future implementation.
	* If only one pulse is desired, ''Train Duration'' and ''Train Frequency'' don't have to be specified, or they can be '''set to 0'''.		* If only one pulse is desired, ''Train Duration'' and ''Train Frequency'' don't have to be specified, or they can be '''set to 0'''.

Wengelhardt: /* Parameters */

2023-12-04T17:35:15Z

Parameters

← Older revision		Revision as of 17:35, 4 December 2023
Line 34:		Line 34:
	Enable to measure the impedance of the used electrodes in [[#StimulationTriggers\|StimulationTriggers parameter]]. It starts measuring when you press "Set Config" in a separate window.		Enable to measure the impedance of the used electrodes in [[#StimulationTriggers\|StimulationTriggers parameter]]. It starts measuring when you press "Set Config" in a separate window.
	===DynamicConfiguration===		===DynamicConfiguration===
	Enable to dynamically load stimulation configurations during the experiment. This allows you to have more than 15 configurations. This makes the ~~[[#~~Expression~~\|Expression]]~~ in [[#StimulationTriggers\|StimulationTriggers parameter]] upload the desired configuration, and then [[#StartExpression\|StartExpression]] trigger the uploaded configuration. If there is no expression in [[#StartExpression\|StartExpression]], the stimulation will start immediately after being uploaded.		Enable to dynamically load stimulation configurations during the experiment. This allows you to have more than 15 configurations. This makes the Expression in [[#StimulationTriggers\|StimulationTriggers parameter]] upload the desired configuration, and then [[#StartExpression\|StartExpression]] trigger the uploaded configuration. If there is no expression in [[#StartExpression\|StartExpression]], the stimulation will start immediately after being uploaded.
	===AppliedVoltage===		===AppliedVoltage===
	The CereStim drives current, so the applied voltage fluctuates according to the impedance between the current source (electrode) and drain. This dropdown parameter sets the maximum applied voltage. Note that there will be no notification that this maximum has been met.		The CereStim drives current, so the applied voltage fluctuates according to the impedance between the current source (electrode) and drain. This dropdown parameter sets the maximum applied voltage. Note that there will be no notification that this maximum has been met.
Line 58:		Line 58:

	'''Additional Notes:'''		'''Additional Notes:'''
	* For each configuration, if the ''Cathode first'' row is <code>1</code>, then the positive magnitude pulse precedes the negative pulse. If this row is <code>0</code>, then the negative pulse precedes the positive pulse. The current sink for each pulse is the patient ground, which is the green safety connector on the back of the CereStim. However, suppose you wish to provide '''bipolar stimulation''' between two different electrodes within the brain. In that case, you can make two configurations that have the same pulse shape parameters but have reversed ''Cathode first'' parameters. These stimulation configurations can be triggered at the same time to approximate a bipolar stimulation pattern. Current can still potentially flow to the patient ground, but if the impedance between the two electrodes is significantly less than the impedance between the electrodes and patient ground, the majority of the current will flow between the two electrodes. Information on how to define these two electrodes can be found in the [~~https://www.bci2000.org/mediawiki/index.php/Contributions:CereStim~~#StimulationTriggers StimulationTriggers] parameter. Note that valid frequencies depend on the phase and interphase duration of the pulse.		* For each configuration, if the ''Cathode first'' row is <code>1</code>, then the positive magnitude pulse precedes the negative pulse. If this row is <code>0</code>, then the negative pulse precedes the positive pulse. The current sink for each pulse is the patient ground, which is the green safety connector on the back of the CereStim. However, suppose you wish to provide '''bipolar stimulation''' between two different electrodes within the brain. In that case, you can make two configurations that have the same pulse shape parameters but have reversed ''Cathode first'' parameters. These stimulation configurations can be triggered at the same time to approximate a bipolar stimulation pattern. Current can still potentially flow to the patient ground, but if the impedance between the two electrodes is significantly less than the impedance between the electrodes and patient ground, the majority of the current will flow between the two electrodes. Information on how to define these two electrodes can be found in the [[#StimulationTriggers\|StimulationTriggers]] parameter. Note that valid frequencies depend on the phase and interphase duration of the pulse.
	* If a train still has more time in its desired duration, '''new expressions won't be triggered'''. This is a software constraint and can be changed with future implementation.		* If a train still has more time in its desired duration, '''new expressions won't be triggered'''. This is a software constraint and can be changed with future implementation.
	* If only one pulse is desired, ''Train Duration'' and ''Train Frequency'' don't have to be specified, or they can be '''set to 0'''.		* If only one pulse is desired, ''Train Duration'' and ''Train Frequency'' don't have to be specified, or they can be '''set to 0'''.
Line 81:		Line 81:
	'''Additional Notes:'''		'''Additional Notes:'''
	* You can only stimulate up to '''15''' electrodes concurrently.		* You can only stimulate up to '''15''' electrodes concurrently.
	* Concurrent stimulation groups, as defined by their equivalent ''Expression'' expression, must ~~also~~ have '''non-overlapping electrode lists'''.		* Concurrent stimulation groups, as defined by their equivalent ''Expression'' expression, must have '''non-overlapping electrode lists''' and '''matching train frequency and train duration'''.

	===StartExpression===		===StartExpression===

Wengelhardt: /* Parameters */

2023-12-04T17:31:16Z

Parameters

← Older revision		Revision as of 17:31, 4 December 2023
Line 31:		Line 31:
	===AcquisitionMode===		===AcquisitionMode===
	There are 2 modes: the '''default stimulation mode''', then the '''impedance measurement mode'''. The only difference is that the impedance measurement mode prints out the impedance of the used electrodes when you set the configuration, and the default stimulation mode does not. The electrodes that are printed out are the electrodes that are listed in the [[#StimulationTriggers\|StimulationTriggers parameter]].		There are 2 modes: the '''default stimulation mode''', then the '''impedance measurement mode'''. The only difference is that the impedance measurement mode prints out the impedance of the used electrodes when you set the configuration, and the default stimulation mode does not. The electrodes that are printed out are the electrodes that are listed in the [[#StimulationTriggers\|StimulationTriggers parameter]].
			===ImpedanceMeasurement===
			Enable to measure the impedance of the used electrodes in [[#StimulationTriggers\|StimulationTriggers parameter]]. It starts measuring when you press "Set Config" in a separate window.
			===DynamicConfiguration===
			Enable to dynamically load stimulation configurations during the experiment. This allows you to have more than 15 configurations. This makes the [[#Expression\|Expression]] in [[#StimulationTriggers\|StimulationTriggers parameter]] upload the desired configuration, and then [[#StartExpression\|StartExpression]] trigger the uploaded configuration. If there is no expression in [[#StartExpression\|StartExpression]], the stimulation will start immediately after being uploaded.
	===AppliedVoltage===		===AppliedVoltage===
	The CereStim drives current, so the applied voltage fluctuates according to the impedance between the current source (electrode) and drain. This dropdown parameter sets the maximum applied voltage. Note that there will be no notification that this maximum has been met.		The CereStim drives current, so the applied voltage fluctuates according to the impedance between the current source (electrode) and drain. This dropdown parameter sets the maximum applied voltage. Note that there will be no notification that this maximum has been met.
Line 59:		Line 62:
	* If only one pulse is desired, ''Train Duration'' and ''Train Frequency'' don't have to be specified, or they can be '''set to 0'''.		* If only one pulse is desired, ''Train Duration'' and ''Train Frequency'' don't have to be specified, or they can be '''set to 0'''.
	* Hardware limitations:		* Hardware limitations:
	** ''Maximum number of configurations'': 15		** ''Maximum number of configurations'': 15 (can be bypassed by using [[#DynamicConfiguration\|DynamicConfiguration]] mode)
	** ''Number of pulses'': 1-255		** ''Number of pulses'': 1-255
	** ''Amplitude'': 1-215 uA (Micro), 100 uA-10 mA (Macro)		** ''Amplitude'': 1-215 uA (Micro), 100 uA-10 mA (Macro)
Line 79:		Line 82:
	* You can only stimulate up to '''15''' electrodes concurrently.		* You can only stimulate up to '''15''' electrodes concurrently.
	* Concurrent stimulation groups, as defined by their equivalent ''Expression'' expression, must also have '''non-overlapping electrode lists'''.		* Concurrent stimulation groups, as defined by their equivalent ''Expression'' expression, must also have '''non-overlapping electrode lists'''.

			===StartExpression===
			Only for use in [[#DynamicConfiguration\|DynamicConfiguration]] mode. Expression to start stimulation using the uploaded configurations. Can be left empty to start stimulation immediately after uploading.

	===DeviceInfo===		===DeviceInfo===