Contributions:actiCHampPlus - Revision history

Pbrunner at 18:28, 13 May 2020

2020-05-13T18:28:59Z

← Older revision		Revision as of 18:28, 13 May 2020
Line 57:		Line 57:
	2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. This data will be presented in a pop-up window for all of the EEG channels and the ground. Data will then be passed from the amplifier to BCI2000 normally. If active electrodes are being used, each electrode will illuminate an LED corresponding to the amount of impedance. If the impedance is low the electrode LED will be green. If the impedance is high the LED will be red, else it will be yellow.		2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. This data will be presented in a pop-up window for all of the EEG channels and the ground. Data will then be passed from the amplifier to BCI2000 normally. If active electrodes are being used, each electrode will illuminate an LED corresponding to the amount of impedance. If the impedance is low the electrode LED will be green. If the impedance is high the LED will be red, else it will be yellow.

			===ImpedancePauseTime===
			Amount of time to illuminate LEDs on active electrodes during impedance check. Helpful when trying to correct high impedance channels.
	==See also==		==See also==
	[[User Reference:Filters]], [[Contributions:ADCs]]		[[User Reference:Filters]], [[Contributions:ADCs]]

	[[Category:Contributions]][[Category:Data Acquisition]]		[[Category:Contributions]][[Category:Data Acquisition]]

Pbrunner at 16:51, 6 March 2020

2020-03-06T16:51:22Z

← Older revision		Revision as of 16:51, 6 March 2020
Line 1:		Line 1:
	==Synopsis==		==Synopsis==
	[[File:actiCHamp_Plus.png\|right\|300px~~\|caption~~]]		[[File:actiCHamp_Plus.png\|right\|300px]]
	This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp Plus can be used with passive and active electrodes and is capable of reading from 32 up to 160 channels. To ~~accomidate~~ additional channels (ie. 64-160), additional modules are installed on the top of amp. The amplifier also has 8 auxiliary channels for gathering data from additional physiological sensors at up to 100kHz. The amplifier is powered by a lithium-ion battery pack to ensure long recording times. The amplifier is connected the computer running BCI2000 via USB. Note, the amplifier module must be plugged into the battery pack to function correctly.		This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp Plus can be used with passive and active electrodes and is capable of reading from 32 up to 160 channels at 100kHz. To accommodate additional channels (ie. 64-160), additional modules are installed on the top of amp. The amplifier also has 8 auxiliary channels for gathering data from additional physiological sensors at up to 100kHz. The amplifier is powered by a lithium-ion battery pack to ensure long recording times. The amplifier is connected the computer running BCI2000 via USB. Note, the amplifier module must be plugged into the battery pack to function correctly.

	Note: This source module is only available on Windows Machines.		Note: This source module is only available on Windows Machines.
Line 23:		Line 23:

	==Parameters==		==Parameters==
			[[File:ActiCHampPlus_BCI2000_config_high-res.PNG\|right\|600px]]

	===SourceCh===		===SourceCh===
	The number of channels that will be recorded from (EEG and auxiliary). Set this parameter to auto to automatically make the parameter equal to the ''TotalEEGChannels'' plus the number of elements in the ''AUXChList'' parameters.		The number of channels that will be recorded from (EEG and auxiliary). Set this parameter to auto to automatically make the parameter equal to the ''TotalEEGChannels'' plus the number of elements in the ''AUXChList'' parameters.
Line 53:		Line 55:
	1. Normal signal acquisition: Once connection to amplifier is established, data will be passed from the amplifier to BCI2000 normally.		1. Normal signal acquisition: Once connection to amplifier is established, data will be passed from the amplifier to BCI2000 normally.

	2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. This data will be presented in a pop-up window for all of the EEG channels and the ground. Data will then be passed from the amplifier to BCI2000 normally. If active electrodes are being used, each electrode will illuminate an LED corresponding to the amount of impedance. If the impedance is low the electrode LED will be green~~, else it will be yellow~~. If the impedance is high the LED will be red.		2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. This data will be presented in a pop-up window for all of the EEG channels and the ground. Data will then be passed from the amplifier to BCI2000 normally. If active electrodes are being used, each electrode will illuminate an LED corresponding to the amount of impedance. If the impedance is low the electrode LED will be green. If the impedance is high the LED will be red, else it will be yellow.

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

Pbrunner at 16:24, 6 March 2020

2020-03-06T16:24:31Z

← Older revision		Revision as of 16:24, 6 March 2020
Line 1:		Line 1:
	==Synopsis==		==Synopsis==
	This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp Plus can be used with passive and active electrodes and is capable of reading from up to 160 channels. The amplifier also has 8 auxiliary channels for gathering data from additional sensors. The amplifier is powered by a lithium-ion battery pack. The amplifier is connected the computer running BCI2000 via USB. ~~The~~ amplifier module must be plugged into the battery pack to function correctly.		[[File:actiCHamp_Plus.png\|right\|300px\|caption]]
			This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp Plus can be used with passive and active electrodes and is capable of reading from 32 up to 160 channels. To accomidate additional channels (ie. 64-160), additional modules are installed on the top of amp. The amplifier also has 8 auxiliary channels for gathering data from additional physiological sensors at up to 100kHz. The amplifier is powered by a lithium-ion battery pack to ensure long recording times. The amplifier is connected the computer running BCI2000 via USB. Note, the amplifier module must be plugged into the battery pack to function correctly.

	Note: This source module is only available on Windows Machines.		Note: This source module is only available on Windows Machines.

			==Use==
			This module is included in the contributions section of BCI2000. It can be included by enabling the <code>BUILD_CONTRIB</code> in CMAKE before compiling BCI2000. After compiling, in the <code>BCI2000/prog</code> directory, there will be an executable called <code>actiCHampPlus.exe</code>. To then run BCI2000 with the executable, add <code>Start executable actiCHampPlus</code> to your batch file.


	==Known Issues==		==Known Issues==
Line 22:		Line 27:

	===ChannelNames===		===ChannelNames===
	Names of each channel.		Names of each channel. If set to auto, the default is "Ch<#>" and "Aux<#>"

	===AUXChList===		===AUXChList===
Line 31:		Line 36:

	===SampleBlockSize===		===SampleBlockSize===
	Number of samples that are transmitted at a time		Number of samples that are transmitted at a time.

	===HardwareSamplingRate===		===HardwareSamplingRate===
Line 37:		Line 42:

	===SubSampleDivisor===		===SubSampleDivisor===
	Factor that decimates the hardware sampling rate. The hardware sampling rate is divided by this value to ~~yeild~~ the actual sampling rate. This parameter has seven values: 1, 2, 5, 10, 20, 50, and 100.		Factor that decimates the hardware sampling rate. The hardware sampling rate is divided by this value to yield the actual sampling rate. This parameter has seven values: 1, 2, 5, 10, 20, 50, and 100.

	===SamplingRate===		===SamplingRate===
	This parameter is defined by hardware ~~sample~~ rate and sub sample divisor. This parameter should always be set to 'auto'.		This parameter is defined by the hardware sampling rate and sub sample divisor. This parameter should always be set to 'auto'.

	~~===SampleBlockSize===~~
	~~Number of samples transmitted at a time~~.

	===actiCHampAmplifierID===		===actiCHampAmplifierID===
Line 51:		Line 53:
	1. Normal signal acquisition: Once connection to amplifier is established, data will be passed from the amplifier to BCI2000 normally.		1. Normal signal acquisition: Once connection to amplifier is established, data will be passed from the amplifier to BCI2000 normally.

	2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. Data will then be passed from the amplifier to BCI2000 normally.		2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. This data will be presented in a pop-up window for all of the EEG channels and the ground. Data will then be passed from the amplifier to BCI2000 normally. If active electrodes are being used, each electrode will illuminate an LED corresponding to the amount of impedance. If the impedance is low the electrode LED will be green, else it will be yellow. If the impedance is high the LED will be red.

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

Abelsten at 17:48, 21 February 2020

2020-02-21T17:48:33Z

← Older revision		Revision as of 17:48, 21 February 2020
Line 14:		Line 14:
	*Initial development: 6037		*Initial development: 6037
	*Tested under: 6039		*Tested under: 6039
	*Known to compile under: ~~6039~~		*Known to compile under: 6064
	*Broken since: N/A		*Broken since: N/A

Line 29:		Line 29:
	===TotalEEGChannels===		===TotalEEGChannels===
	Total number of EEG channels to record from.		Total number of EEG channels to record from.

			===SampleBlockSize===
			Number of samples that are transmitted at a time

	===HardwareSamplingRate===		===HardwareSamplingRate===
	Sampling at which the actiChamp is run. The actiChamp Plus can be run at three different frequencies~~. The hardware sampling rate also defines the hardware block size as shown below.~~		Sampling at which the actiChamp is run. The actiChamp Plus can be run at three different frequencies: 10kHz, 50kHz and 100kHz.

	~~{\| class="wikitable"~~
	~~\|+ Predefined Hardware Values~~
	\|-
	~~! Hardware Sample Rate~~
	~~! Hardware Block Size~~

	\|-
	\| 10kHz
	~~\| 32~~

	\|-
	\| 50kHz
	~~\| 152~~

	\|-
	\| 100kHz
	~~\| 300~~
	\|}

	===~~DecimationFactor~~===		===SubSampleDivisor===
	~~The decimation factor. The factor by which to decimate/downsize~~ the ~~signal~~. The ~~default value is 1. The actual SamplingRate is the~~ hardware sampling rate divided by the ~~DecimationFactor~~. ~~Note~~: ~~The hardware block size must be divisible by the decimation factor~~.		Factor that decimates the hardware sampling rate. The hardware sampling rate is divided by this value to yeild the actual sampling rate. This parameter has seven values: 1, 2, 5, 10, 20, 50, and 100.

	===SamplingRate===		===SamplingRate===
	This parameter is defined by hardware sample rate and ~~decimation factor~~. ~~Setting it~~ to ''auto'~~' will make it equal to the hardware sampling rate divided by the decimation factor~~.		This parameter is defined by hardware sample rate and sub sample divisor. This parameter should always be set to 'auto'.

	===SampleBlockSize===		===SampleBlockSize===

Pbrunner at 14:49, 28 January 2020

2020-01-28T14:49:17Z

← Older revision		Revision as of 14:49, 28 January 2020
Line 5:		Line 5:

	==Known Issues==		==Known Issues==
	After the initial compile of the source module, there is sometimes an error that reads "No actiCHampPlus devices found. Try unplugging actiChampPlus and restarting BCI2000". To fix this error, go to "BCI2000\src\contrib\SignalSource\actiCHampPlus\lib\dylib\<x64/x86>\", copy the file "ActiChamp_<x64/x86>.dll"		After the initial compile of the source module, there is sometimes an error that reads ''"No actiCHampPlus devices found. Try unplugging actiChampPlus and restarting BCI2000"''. To fix this error, go to <code>BCI2000\src\contrib\SignalSource\actiCHampPlus\lib\dylib\<x64/x86>\</code>, copy the file <code>ActiChamp_<x64/x86>.dll</code> and paste it in the <code>BCI2000\prog</code> directory. The file will already exist in that folder so when prompted, replace it.
	and paste it in the "BCI2000\prog" directory. The file will already exist in that folder so when prompted, replace it.

	==Versioning==		==Versioning==

Pbrunner at 14:46, 28 January 2020

2020-01-28T14:46:52Z

← Older revision		Revision as of 14:46, 28 January 2020
Line 1:		Line 1:
	==Synopsis==		==Synopsis==
	This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp ~~plus~~ can be used with passive and active electrodes and is capable of reading from up to 160 channels. The amplifier also has 8 auxiliary channels for gathering data from additional sensors. The amplifier is powered by a lithium-ion battery pack. The amplifier is connected the computer running BCI2000 via USB. The amplifier module must be plugged into the battery pack to function correctly.		This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp Plus can be used with passive and active electrodes and is capable of reading from up to 160 channels. The amplifier also has 8 auxiliary channels for gathering data from additional sensors. The amplifier is powered by a lithium-ion battery pack. The amplifier is connected the computer running BCI2000 via USB. The amplifier module must be plugged into the battery pack to function correctly.

	Note: This source module is only available on Windows Machines.		Note: This source module is only available on Windows Machines.

			==Known Issues==
			After the initial compile of the source module, there is sometimes an error that reads "No actiCHampPlus devices found. Try unplugging actiChampPlus and restarting BCI2000". To fix this error, go to "BCI2000\src\contrib\SignalSource\actiCHampPlus\lib\dylib\<x64/x86>\", copy the file "ActiChamp_<x64/x86>.dll"
			and paste it in the "BCI2000\prog" directory. The file will already exist in that folder so when prompted, replace it.

	==Versioning==		==Versioning==
Line 65:		Line 69:

	2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. Data will then be passed from the amplifier to BCI2000 normally.		2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. Data will then be passed from the amplifier to BCI2000 normally.

	~~==States==~~

	~~===actiChampTrig===~~
	~~8 bit value from the ''Trigger In'' port on the actiChamp device.~~

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

Pbrunner: /* Source Code Revisions */

2020-01-23T13:18:48Z

Source Code Revisions

← Older revision		Revision as of 13:18, 23 January 2020
Line 9:		Line 9:

	===Source Code Revisions===		===Source Code Revisions===
	Initial development: 6037		*Initial development: 6037
	Tested under: 6039		*Tested under: 6039
	Known to compile under: 6039		*Known to compile under: 6039
	Broken since: N/A		*Broken since: N/A

	==Parameters==		==Parameters==

Pbrunner at 13:18, 23 January 2020

2020-01-23T13:18:08Z

← Older revision		Revision as of 13:18, 23 January 2020
Line 4:		Line 4:
	Note: This source module is only available on Windows Machines.		Note: This source module is only available on Windows Machines.

	===~~Known Issues~~===		==Versioning==
	~~About every 0.5 seconds, the amplifier returns multiple blocks of data. In BCI2000 this causes some data loss~~.		===Author===
			Alex Belsten (belsten@neurotechcenter.org)

	===~~Authors~~===		===Source Code Revisions===
	~~Alex Belsten (belsten@neurotechcenter.org)~~		Initial development: 6037
			Tested under: 6039
			Known to compile under: 6039
			Broken since: N/A

	==Parameters==		==Parameters==

Pbrunner at 13:11, 23 January 2020

2020-01-23T13:11:17Z

← Older revision		Revision as of 13:11, 23 January 2020
Line 1:		Line 1:
	==Synopsis==		==Synopsis==
	This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp plus can be used with passive and active electrodes and is capable of reading from up to 160 channels. The amplifier also has 8 auxiliary channels for gathering data from additional sensors. The amplifier is powered by a lithium-ion battery pack. The amplifier is connected the computer running BCI2000 via USB. The amplifier module must be plugged into the battery pack to function correctly.		This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp plus can be used with passive and active electrodes and is capable of reading from up to 160 channels. The amplifier also has 8 auxiliary channels for gathering data from additional sensors. The amplifier is powered by a lithium-ion battery pack. The amplifier is connected the computer running BCI2000 via USB. The amplifier module must be plugged into the battery pack to function correctly.

			Note: This source module is only available on Windows Machines.

	===Known Issues===		===Known Issues===
Line 44:		Line 46:

	===DecimationFactor===		===DecimationFactor===
	The decimation factor. The factor by which to decimate/downsize the signal. The default value is 1. The SamplingRate is ~~updated by dividing it~~ by the DecimationFactor. Note: The hardware block size must be divisible by the decimation factor.		The decimation factor. The factor by which to decimate/downsize the signal. The default value is 1. The actual SamplingRate is the hardware sampling rate divided by the DecimationFactor. Note: The hardware block size must be divisible by the decimation factor.

	===SamplingRate===		===SamplingRate===
Line 50:		Line 52:

	===SampleBlockSize===		===SampleBlockSize===
	Number of ~~Samples~~ transmitted at a time~~. This value must be a multiple of the hardware block size divided by the decimation factor~~.		Number of samples transmitted at a time.

	===actiCHampAmplifierID===		===actiCHampAmplifierID===
	Index of the actiChamp Plus. For systems with one actiChamp device, this parameter should be 0.		Index of the actiChamp Plus. For systems with one actiChamp Plus device, this parameter should be 0.

	===AcquisitionMode===		===AcquisitionMode===

Pbrunner: Created page with "==Synopsis== This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp plus can be used with passive and active electrodes and is..."

2020-01-15T18:39:22Z

Created page with "==Synopsis== This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp plus can be used with passive and active electrodes and is..."

New page

==Synopsis==
This module allows BCI2000 to collect data from Brain Vision's actiCHamp Plus amplifier. The actiCHamp plus can be used with passive and active electrodes and is capable of reading from up to 160 channels. The amplifier also has 8 auxiliary channels for gathering data from additional sensors. The amplifier is powered by a lithium-ion battery pack. The amplifier is connected the computer running BCI2000 via USB. The amplifier module must be plugged into the battery pack to function correctly.

===Known Issues===
About every 0.5 seconds, the amplifier returns multiple blocks of data. In BCI2000 this causes some data loss.

===Authors===
Alex Belsten (belsten@neurotechcenter.org)

==Parameters==
===SourceCh===
The number of channels that will be recorded from (EEG and auxiliary). Set this parameter to auto to automatically make the parameter equal to the ''TotalEEGChannels'' plus the number of elements in the ''AUXChList'' parameters.

===ChannelNames===
Names of each channel.

===AUXChList===
List of auxiliary channels to use. This parameter also defines the order in which BCI2000 stores and presents data.

===TotalEEGChannels===
Total number of EEG channels to record from.

===HardwareSamplingRate===
Sampling at which the actiChamp is run. The actiChamp Plus can be run at three different frequencies. The hardware sampling rate also defines the hardware block size as shown below.

{| class="wikitable"
|+ Predefined Hardware Values
|-
! Hardware Sample Rate
! Hardware Block Size

|-
| 10kHz
| 32

|-
| 50kHz
| 152

|-
| 100kHz
| 300
|}

===DecimationFactor===
The decimation factor. The factor by which to decimate/downsize the signal. The default value is 1. The SamplingRate is updated by dividing it by the DecimationFactor. Note: The hardware block size must be divisible by the decimation factor.

===SamplingRate===
This parameter is defined by hardware sample rate and decimation factor. Setting it to ''auto'' will make it equal to the hardware sampling rate divided by the decimation factor.

===SampleBlockSize===
Number of Samples transmitted at a time. This value must be a multiple of the hardware block size divided by the decimation factor.

===actiCHampAmplifierID===
Index of the actiChamp Plus. For systems with one actiChamp device, this parameter should be 0.

===AcquisitionMode===
1. Normal signal acquisition: Once connection to amplifier is established, data will be passed from the amplifier to BCI2000 normally.

2. Impedance measurement: Once connection to amplifier is established, BCI2000 will present the impedance for all channels. Data will then be passed from the amplifier to BCI2000 normally.

==States==

===actiChampTrig===
8 bit value from the ''Trigger In'' port on the actiChamp device.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]