Contributions:XsensMTwLogger - Revision history

Mellinger at 13:47, 1 July 2025

2025-07-01T13:47:28Z

← Older revision		Revision as of 13:47, 1 July 2025
Line 1:		Line 1:
	An BCI2000 extension that records synchronized rotational data into states, using XSens’s MTw motion tracking sensors.		A BCI2000 extension that records synchronized rotational data into states, using XSens’s MTw motion tracking sensors.

	[[File:XSensMTwImage.png\|right\|thumb\| An actual image of a MTw]]		[[File:XSensMTwImage.png\|right\|thumb\| An actual image of a MTw]]

Wengelhardt: /* See also */

2024-09-03T17:57:56Z

Wengelhardt: /* Integration into BCI2000 */

2022-08-30T18:56:57Z

Integration into BCI2000

← Older revision		Revision as of 18:56, 30 August 2022
Line 30:		Line 30:

	==Integration into BCI2000==		==Integration into BCI2000==
	To enable the extension in your CMake configuration, enable <tt>EXTENSIONS_XSENSMTWLOGGER=On</tt> in the Extensions folder of the CMake GUI and then generate the BCI2000 Visual Studio solution in CMake. Next, open the solution with Visual Studio and rebuild the ~~<tt>BCI2000FrameworkSigSrcModule</tt>. Then rebuild any~~ signal source module with which you want to use the extension.		To enable the extension in your CMake configuration, enable <tt>EXTENSIONS_XSENSMTWLOGGER=On</tt> in the Extensions folder of the CMake GUI and then generate the BCI2000 Visual Studio solution in CMake. Next, open the solution with Visual Studio and rebuild the signal source module with which you want to use the extension.
	Once the extension is built into the source module, you can enable it by appending <code>--LogXsensMTw=1</code> to the source module <tt>start executable</tt> command in your batch file. Also, <code>--NumberOfMTws=1</code> needs to be appended as well. Set this equal to the exact number of MTw's you want connected.		Once the extension is built into the source module, you can enable it by appending <code>--LogXsensMTw=1</code> to the source module <tt>start executable</tt> command in your batch file. Also, <code>--NumberOfMTws=1</code> needs to be appended as well. Set this equal to the exact number of MTw's you want connected.

Wengelhardt: Added tutorial video

2022-01-24T09:20:56Z

Added tutorial video

← Older revision		Revision as of 09:20, 24 January 2022
Line 20:		Line 20:
	*Known to compile under: 6330		*Known to compile under: 6330
	*Broken since: --		*Broken since: --

			==Video Overview==
			<br>
			<youtube alignment="center" dimensions="900">https://youtu.be/-SOUX5J1vJE</youtube>
			<br>

	==Functional Description==		==Functional Description==

Wengelhardt at 19:48, 18 January 2022

2022-01-18T19:48:39Z

← Older revision		Revision as of 19:48, 18 January 2022
Line 44:		Line 44:

	====NumberOfMTws====		====NumberOfMTws====
	The exact number of MTw's that will be connected. 1 is the default, but this number can go up to as many MTw's as you have. This parameter should be set in your batch file by appending <code>--NumberOfMTws=1</code>, ~~just as <code>LogXsensMTw</code>~~ is. This parameter can only be set in the batch and will not appear in the Source tab.		The exact number of MTw's that will be connected. 1 is the default, but this number can go up to as many MTw's as you have. This parameter should be set in your batch file by appending <code>--NumberOfMTws=X</code>, where X is the number of MTw's that will be connected. This parameter can only be set in the batch file and will not appear in the Source tab.

	====MasterUpdateRate====		====MasterUpdateRate====

Swiftj: /* Converting Back to Degrees */

2021-09-10T21:56:45Z

Converting Back to Degrees

← Older revision		Revision as of 21:56, 10 September 2021
Line 80:		Line 80:

	==Converting Back to Degrees==		==Converting Back to Degrees==
	The ~~MTw’s~~ record data in units of degrees, with ~~two of~~ the axes ~~going up~~ to 180, and the ~~other going~~ to 90. They also record a high precision of 6 decimal places. BCI2000 records integers to states, which means that anything after the decimal point will be cut off. If the data is kept as is, this would greatly reduce the quality of the data we are collecting.		The MTws record data in units of degrees, with the X and Z axes ranging from -180 to 180 degrees, and the Y axis ranging from -90 to 90 degrees. They also record a high precision of 6 decimal places. BCI2000 records integers to states, which means that anything after the decimal point will be cut off. If the data is kept as is, this would greatly reduce the quality of the data we are collecting.

	BCI2000 can record states with up to 32 bits, which is the resolution we need to record the high quality data from the ~~MTw’s~~. To do this, the original data will be multiplied by the parameter <code>DataPrescaler</code>, and shifted up by 2^31.		BCI2000 can record states with up to 32 bits, which is the resolution we need to record the high quality data from the MTws. To do this, the original data will be multiplied by the parameter <code>DataPrescaler</code>, and shifted up by 2^31.

	To convert the data back into degrees, use Matlab or a similar program to		To convert the data back into degrees, use Matlab or a similar program to
	# Subtract 2^31 from every value.		# Subtract 2^31 from every value.
	# Divide the data by the <code>DataPrescaler</code>.		# Divide the data by the <code>DataPrescaler</code>.
	This should now leave you with data ~~between -180 and 180~~!		This should now leave you with data in degrees!

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

Swiftj: /* MTw1X, MTw1Y, MTw1Z */

2021-09-10T21:54:55Z

MTw1X, MTw1Y, MTw1Z

← Older revision		Revision as of 21:54, 10 September 2021
Line 77:		Line 77:

	===MTw1X, MTw1Y, MTw1Z===		===MTw1X, MTw1Y, MTw1Z===
	These states record the three rotational data values per MTw. See the ~~“Coordinate System”~~ section to see how X, Y, and Z are defined. If more than one MTw is connected, their label will continue to increase by 1, i.e., MTw2X, MTw3X, etc. The ~~MTw’s~~ connect in order of lowest serial code to highest serial code, so if multiple MTws are being recorded, MTw1 will always have the lowest serial code number. The serial codes and their respective IDs are printed in the operator log for clarity’s sake. This allows you to distinguish what MTw is recording to what state.		These states record the three rotational data values per MTw. See the [https://www.bci2000.org/mediawiki/index.php/Contributions:XsensMTwLogger#Coordinate_System Coordinate System] section to see how X, Y, and Z are defined. If more than one MTw is connected, their label will continue to increase by 1, i.e., MTw2X, MTw3X, etc. The MTws connect in order of lowest serial code to highest serial code, so if multiple MTws are being recorded, MTw1 will always have the lowest serial code number. The serial codes and their respective IDs are printed in the operator log for clarity’s sake. This allows you to distinguish what MTw is recording to what state.

	==Converting Back to Degrees==		==Converting Back to Degrees==

Swiftj: /* DataPrescaler */

2021-09-10T21:53:24Z

DataPrescaler

← Older revision		Revision as of 21:53, 10 September 2021
Line 72:		Line 72:

	====DataPrescaler====		====DataPrescaler====
	A default value of 10,000,000. The most efficient prescaler is 11,930,464, but for simplicity’s sake this value is rounded. Details about what this value does is located in [https://www.bci2000.org/mediawiki/index.php/Contributions:XsensMTwLogger#~~Converting Back to Degrees~~ Converting Back to Degrees] below.		A default value of 10,000,000. The most efficient prescaler is 11,930,464, but for simplicity’s sake this value is rounded. Details about what this value does is located in [https://www.bci2000.org/mediawiki/index.php/Contributions:XsensMTwLogger#Converting_Back_to_Degrees Converting Back to Degrees] below.

	==State Variables==		==State Variables==

Swiftj: /* Parameters */

2021-09-10T21:53:09Z

Parameters

← Older revision		Revision as of 21:53, 10 September 2021
Line 72:		Line 72:

	====DataPrescaler====		====DataPrescaler====
	A default value of 10,000,000. The most efficient prescaler is 11,930,464, but for simplicity’s sake this value is rounded. Details about what this value does is located in [https://www.bci2000.org/mediawiki/index.php/Contributions:XsensMTwLogger#~~ConvertingBacktoDegrees~~ Converting Back to Degrees] below.		A default value of 10,000,000. The most efficient prescaler is 11,930,464, but for simplicity’s sake this value is rounded. Details about what this value does is located in [https://www.bci2000.org/mediawiki/index.php/Contributions:XsensMTwLogger#Converting Back to Degrees Converting Back to Degrees] below.

	==State Variables==		==State Variables==

Swiftj: /* Converting back to Degrees */

2021-09-10T21:52:49Z

Converting back to Degrees

← Older revision		Revision as of 21:52, 10 September 2021
Line 79:		Line 79:
	These states record the three rotational data values per MTw. See the “Coordinate System” section to see how X, Y, and Z are defined. If more than one MTw is connected, their label will continue to increase by 1, i.e., MTw2X, MTw3X, etc. The MTw’s connect in order of lowest serial code to highest serial code, so if multiple MTws are being recorded, MTw1 will always have the lowest serial code number. The serial codes and their respective IDs are printed in the operator log for clarity’s sake. This allows you to distinguish what MTw is recording to what state.		These states record the three rotational data values per MTw. See the “Coordinate System” section to see how X, Y, and Z are defined. If more than one MTw is connected, their label will continue to increase by 1, i.e., MTw2X, MTw3X, etc. The MTw’s connect in order of lowest serial code to highest serial code, so if multiple MTws are being recorded, MTw1 will always have the lowest serial code number. The serial codes and their respective IDs are printed in the operator log for clarity’s sake. This allows you to distinguish what MTw is recording to what state.

	==Converting ~~back~~ to Degrees==		==Converting Back to Degrees==
	The MTw’s record data in units of degrees, with two of the axes going up to 180, and the other going to 90. They also record a high precision of 6 decimal places. BCI2000 records integers to states, which means that anything after the decimal point will be cut off. If the data is kept as is, this would greatly reduce the quality of the data we are collecting.		The MTw’s record data in units of degrees, with two of the axes going up to 180, and the other going to 90. They also record a high precision of 6 decimal places. BCI2000 records integers to states, which means that anything after the decimal point will be cut off. If the data is kept as is, this would greatly reduce the quality of the data we are collecting.

← Older revision		Revision as of 17:57, 3 September 2024
Line 97:		Line 97:
	[[User Reference:Logging Input]], [[Contributions:Extensions]]		[[User Reference:Logging Input]], [[Contributions:Extensions]]

	[[Category:Contributions]][[Category:Extension]]		[[Category:Contributions]][[Category:Extension]][[Category:Video]]