Contributions:BCI2000SimulinkConnector - Revision history

Wengelhardt at 15:58, 17 June 2025

2025-06-17T15:58:07Z

← Older revision		Revision as of 15:58, 17 June 2025
Line 4:		Line 4:

	==Video Overview==		==Video Overview==
	<youtube ~~alignment="center"~~>https://youtu.be/Geo3YhIOjX4</youtube>		<youtube >https://youtu.be/Geo3YhIOjX4</youtube>

	==Location==		==Location==

Wengelhardt: /* Video Overview */

2025-02-13T18:15:56Z

Video Overview

← Older revision		Revision as of 18:15, 13 February 2025
Line 4:		Line 4:

	==Video Overview==		==Video Overview==
	<youtube alignment="center">https://youtu.be/~~F6YyW-UtGyI?si=cO4FUmiDGUM01254~~</youtube>		<youtube alignment="center">https://youtu.be/Geo3YhIOjX4</youtube>

	==Location==		==Location==

Wengelhardt: /* Video Overview */

2025-02-12T14:21:27Z

Video Overview

← Older revision		Revision as of 14:21, 12 February 2025
Line 4:		Line 4:

	==Video Overview==		==Video Overview==
	<youtube alignment="center">https://youtu.be/~~b4kwY2MMO9c~~</youtube>		<youtube alignment="center">https://youtu.be/F6YyW-UtGyI?si=cO4FUmiDGUM01254</youtube>

	==Location==		==Location==

Wengelhardt at 17:19, 28 January 2025

2025-01-28T17:19:26Z

← Older revision		Revision as of 17:19, 28 January 2025
Line 1:		Line 1:
	The BCI2000 Simulink connector allows data to be sent to Simulink in real-time, allowing data to be processed in your own custom Simulink model.		The BCI2000 Simulink connector allows data to be sent to Simulink in real-time, allowing data to be processed in your own custom Simulink model. Both BCI2000 signal and states can be received with Simulink!

	[[File:Simulink_Library.PNG\|200px\|thumb\|right\|BCI2000 Simulink Component]]		[[File:Simulink_Library.PNG\|200px\|thumb\|right\|BCI2000 Simulink Component]]
Line 51:		Line 51:

	[[File:Simulink_MinimalExample.PNG]]		[[File:Simulink_MinimalExample.PNG]]

			For states to be sent to Simulink, they must be specified as a parameter ''SimulinkConnectorStates''.

	==Adding BCI2000 your own model==		==Adding BCI2000 your own model==
Line 73:		Line 75:
	Addresses will always be identical on both ends. When switching to a non-local connection, “localhost” will have to be replaced with the IP address of the machine running BCI2000 (e.g., ''192.168.1.15:1905'').		Addresses will always be identical on both ends. When switching to a non-local connection, “localhost” will have to be replaced with the IP address of the machine running BCI2000 (e.g., ''192.168.1.15:1905'').

	==~~Transferring State/Event information~~==		==Sending States==
	State/Event information may be transferred by specifying State/Event names in the ''SimulinkConnectorStates'' parameter (see image above). States listed there will be transferred to the BCI2000 block's "State data" output port.		State/Event information may be transferred by specifying State/Event names in the ''SimulinkConnectorStates'' parameter (see image above). States listed there will be transferred to the BCI2000 block's "State data" output port.

Wengelhardt at 18:21, 21 January 2025

2025-01-21T18:21:41Z

← Older revision		Revision as of 18:21, 21 January 2025
Line 4:		Line 4:

	==Video Overview==		==Video Overview==
	<youtube alignment="center">https://youtu.be/~~qz0CMX1zswU~~</youtube>		<youtube alignment="center">https://youtu.be/b4kwY2MMO9c</youtube>

	==Location==		==Location==

Mellinger: /* Transferring State/Event information */

2024-12-20T12:49:20Z

Transferring State/Event information

← Older revision		Revision as of 12:49, 20 December 2024
Line 74:		Line 74:

	==Transferring State/Event information==		==Transferring State/Event information==
	State/Event information may be transferred by specifying State/Event names in the "SimulinkConnectorStates" parameter (see image above). States listed there will be ~~appended~~ to the ~~signal as additional channels~~.		State/Event information may be transferred by specifying State/Event names in the ''SimulinkConnectorStates'' parameter (see image above). States listed there will be transferred to the BCI2000 block's "State data" output port.

	Depending on where the ''SimulinkConnector'' is located in the filter chain, its input signal may have more or fewer elements (samples) than the State Vector (which has as many samples as the source signal).		Depending on where the ''SimulinkConnector'' is located in the filter chain, its input signal may have more or fewer elements (samples) than the State Vector (which has as many samples as the source signal). In that case, the two output ports of the BCI2000 block will have different sampling rates. As in the "minimal example" above, you may use a muxer block to combine the two signals into a single one prior to further processing.
	In that case, a ~~warning is issued, and state data is either truncated, or appended with NaN values, as appropriate~~.

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

Mellinger: /* Adding BCI2000 your own model */

2024-12-20T12:45:22Z

Adding BCI2000 your own model

← Older revision		Revision as of 12:45, 20 December 2024
Line 53:		Line 53:

	==Adding BCI2000 your own model==		==Adding BCI2000 your own model==
	To add the BCI2000 block to your own model, open the BCI2000.mdl library in Matlab, and drag-and-drop the BCI2000 block into your model window. Then, connect its output ~~signal~~ as you see fit.		To add the BCI2000 block to your own model, open the BCI2000.mdl library in Matlab, and drag-and-drop the BCI2000 block into your model window. Then, connect its output signals as you see fit.

	'''NOTE:''' If the target model is located in ~~another~~ directory than BCI2000/prog/Simulink, you need to add BCI2000/prog/Simulink to the Matlab path in order to use the BCI2000 block.		'''NOTE:''' If the target model is located in a different directory than BCI2000/prog/Simulink, you need to add BCI2000/prog/Simulink to the Matlab path in order to use the BCI2000 block.

	[[File:Simulink_Library.PNG]]		[[File:Simulink_Library.PNG]]

Mellinger: /* Using the Minimal Example */

2024-12-20T12:44:35Z

Using the Minimal Example

← Older revision		Revision as of 12:44, 20 December 2024
Line 39:		Line 39:

	==Using the Minimal Example==		==Using the Minimal Example==
	BCI2000 comes with a minimal example Simulink model, containing just the BCI2000OnlineLink block, and a ~~terminator~~ that ~~absorbs~~ the ~~incoming signal~~.		BCI2000 comes with a minimal example Simulink model, containing just the BCI2000OnlineLink block with its two output ports, a muxer block, and a "to file" block that saves the output to a file.

	To try the BCI2000 Simulink Connector, navigate to the BCI2000/prog/Simulink directory using the Matlab file explorer. Then, double-click the MinimalExample.slx Simulink model file. The ~~BCI2000 signal has already been selected for viewing, so the~~ test ~~reduces to~~ the following ~~three~~ steps:		To try the BCI2000 Simulink Connector, navigate to the BCI2000/prog/Simulink directory using the Matlab file explorer. Then, double-click the MinimalExample.slx Simulink model file. The test consists of the following steps:
	* Double-click BCI2000/batch/SimulinkConnector.bat in your OSes file explorer. BCI2000 will start and display status information in the system log.		* Double-click BCI2000/batch/SimulinkConnector.bat in your OSes file explorer. BCI2000 will start and display status information in the system log.
	* In the MinimalExample window, click the arrow in the green circle to run the model. ~~By default, it~~ will run ~~for 10 seconds in real time~~, reading data from BCI2000.		* In the MinimalExample window, click the arrow in the green circle to run the model. It will run indefinitely, reading data from BCI2000, and recording it into a Matlab data file.
	* ~~Once~~ the run ~~has terminated~~, ~~you may view~~ the ~~data log by clicking~~ the ~~data viewer icon~~ right to the green ~~arrow~~. You ~~will need~~ to ~~expand~~ the "BCI2000~~" signal~~, ~~and select channels for viewing~~.		* To end the run, click the the black square ("stop symbol") right to the green circle.
			* You may now inspect the contents of the recorded data file by typing <tt>data=load('bci2000.mat');</tt> into the Matlab prompt. The <tt>data.ans</tt> field consists of the following rows:
			** 1: Time in seconds (one row),
			** 2: BCI2000 signal data, upsampled to the original sampling rate if necessary (one row per BCI2000 channel),
			** 3: BCI2000 state data in the order specified in the ''SimulinkConnectorStates'' parameter on the BCI2000 side (one row per BCI2000 state).

	[[File:Simulink_MinimalExample.PNG]]		[[File:Simulink_MinimalExample.PNG]]

Wengelhardt: /* See also */

2024-09-03T17:55:37Z

Wengelhardt at 19:04, 19 July 2024

2024-07-19T19:04:45Z

← Older revision		Revision as of 19:04, 19 July 2024
Line 1:		Line 1:
	==~~Synopsis~~==		The BCI2000 Simulink connector allows data to be sent to Simulink in real-time, allowing data to be processed in your own custom Simulink model.

			[[File:Simulink_Library.PNG\|200px\|thumb\|right\|BCI2000 Simulink Component]]

			==Video Overview==
			<youtube alignment="center">https://youtu.be/qz0CMX1zswU</youtube>

	==Location==		==Location==

← Older revision		Revision as of 17:55, 3 September 2024
Line 79:		Line 79:
	[[Programming Reference:MatlabFilter]]		[[Programming Reference:MatlabFilter]]

	[[Category:Contributions]][[Category:External Interfaces]]		[[Category:Contributions]][[Category:External Interfaces]][[Category:Video]]