Technical Reference:BCI2000 File Format - Revision history

Mellinger: /* Binary Data */

2025-07-05T10:57:21Z

Binary Data

← Older revision		Revision as of 10:57, 5 July 2025
Line 62:		Line 62:
	<math>		<math>
	\textrm{samples}		\textrm{samples}
	=\frac{(\textrm{~~file_size_in_bytes~~})-\texttt{HeaderLen}}		=\frac{(\textrm{fileSizeInBytes})-\texttt{HeaderLen}}
	{\textrm{(~~data_value_size_in_bytes~~)}\times\texttt{SourceCh}		{\textrm{(dataValueSizeInBytes)}\times\texttt{SourceCh}
	+\texttt{StateVectorLength}}		+\texttt{StateVectorLength}}
	</math>		</math>

Mellinger: /* Binary Data */

2025-07-05T10:55:41Z

Binary Data

← Older revision		Revision as of 10:55, 5 July 2025
Line 62:		Line 62:
	<math>		<math>
	\textrm{samples}		\textrm{samples}
	=\frac{(\textrm{~~file size in bytes~~})-\texttt{HeaderLen}}		=\frac{(\textrm{file_size_in_bytes})-\texttt{HeaderLen}}
	{\textrm{(~~data value size in bytes~~)}\times\texttt{SourceCh}		{\textrm{(data_value_size_in_bytes)}\times\texttt{SourceCh}
	+\texttt{StateVectorLength}}		+\texttt{StateVectorLength}}
	</math>		</math>

Mellinger: /* Binary Data */

2025-07-05T10:55:13Z

Binary Data

← Older revision		Revision as of 10:55, 5 July 2025
Line 62:		Line 62:
	<math>		<math>
	\textrm{samples}		\textrm{samples}
	=\frac{(\textrm{file\ size\ in\ bytes})-\texttt{HeaderLen}}		=\frac{(\textrm{file size in bytes})-\texttt{HeaderLen}}
	{\textrm{(data\ value\ size\ in\ bytes)}\times\texttt{SourceCh}		{\textrm{(data value size in bytes)}\times\texttt{SourceCh}
	+\texttt{StateVectorLength}}		+\texttt{StateVectorLength}}
	</math>		</math>

Mellinger: /* Binary Data */

2010-04-27T18:54:09Z

Binary Data

← Older revision		Revision as of 18:54, 27 April 2010
Line 45:		Line 45:

	==Binary Data==		==Binary Data==
	~~The binary data directly follows the last CRLF. (~~The end of the header is marked by CRLF CRLF.)		The end of the header is marked by CRLF CRLF, and the binary data directly follows the last CRLF.
	For each sample, data values for all channels are stored, followed by <code>StateVectorLength</code> bytes for the state vector.		For each sample, data values for all channels are stored, followed by <code>StateVectorLength</code> bytes for the state vector.
	Data samples are always stored in little endian byte ordering.		Data samples are always stored in little endian byte ordering.

Cstocks: /* Binary Data */ Clarify what "the last CRLF" means. The binary data could possibly (and probably does for large files) contain two consecutive bytes that could be interpretted as CRLF.

2009-12-31T16:14:53Z

Binary Data: Clarify what "the last CRLF" means. The binary data could possibly (and probably does for large files) contain two consecutive bytes that could be interpretted as CRLF.

← Older revision		Revision as of 16:14, 31 December 2009
Line 45:		Line 45:

	==Binary Data==		==Binary Data==
	The binary data directly follows the last CRLF.		The binary data directly follows the last CRLF. (The end of the header is marked by CRLF CRLF.)
	For each sample, data values for all channels are stored, followed by <code>StateVectorLength</code> bytes for the state vector.		For each sample, data values for all channels are stored, followed by <code>StateVectorLength</code> bytes for the state vector.
	Data samples are always stored in little endian byte ordering.		Data samples are always stored in little endian byte ordering.

Mellinger: /* Required States */

2008-10-24T16:19:13Z

Required States

← Older revision		Revision as of 16:19, 24 October 2008
Line 148:		Line 148:
	==Required States==		==Required States==
	These states are present in all BCI2000 data files.		These states are present in all BCI2000 data files.
	Individual [[User Reference:Filters\|~~Filters~~]] may add states to the system; see filter reference pages for a description of these states.		Individual [[User Reference:Filters\|filters]] may add states to the system; see filter reference pages for a description of these states.
	{\|border="1"		{\|border="1"
	\|+Common States		\|+Common States

Mellinger: /* Required Parameters */

2008-10-24T16:17:46Z

Required Parameters

← Older revision		Revision as of 16:17, 24 October 2008
Line 69:		Line 69:
	==Required Parameters==		==Required Parameters==
	These parameters will be present in any BCI2000 data file.		These parameters will be present in any BCI2000 data file.
	While some of these parameters are required to interpret a data file's content (source parameters), others reflect information about external circumstances (storage parameters), or internal ~~householding~~ (system parameters).		While some of these parameters are required to interpret a data file's content (source parameters), others reflect information about external circumstances (storage parameters), or internal housekeeping (system parameters).

	===Section Source===		===Section Source===

Mellinger: /* Required States */

2007-12-17T10:17:21Z

Required States

← Older revision		Revision as of 10:17, 17 December 2007
Line 151:		Line 151:
	{\|border="1"		{\|border="1"
	\|+Common States		\|+Common States
	! Length (bits) !! State Name !! ~~Description~~		! Length (bits) !! State Name !! Remarks
	\|-		\|-
	\| 1 \|\| Running \|\| ~~setting~~ this state to 0 will put BCI2000 into suspended mode		\| 1 \|\| Running \|\| Setting this state to 0 will put BCI2000 into suspended mode.
	\|-		\|-
	\| 16 \|\| SourceTime \|\| rowspan="2" \| ~~time~~ of data acquisition/stimulus delivery as an unsigned wrap-around value with a resolution of 1ms, used ~~in the operator's~~ [[User Reference:Timing\|timing ~~display~~]] ~~window~~		\| 16 \|\| SourceTime \|\| rowspan="2" \| Time of data acquisition/stimulus delivery as an unsigned wrap-around value with a resolution of 1ms. This information is used to measure [[User Reference:Timing\|system timing]].
	\|-		\|-
	\| 16 \|\| StimulusTime		\| 16 \|\| StimulusTime
	\|}		\|}


	==Software Components==		==Software Components==

Mellinger at 19:48, 8 November 2007

2007-11-08T19:48:10Z

← Older revision		Revision as of 19:48, 8 November 2007
Line 2:		Line 2:
	Its associated file name extension is <code>.dat</code>.		Its associated file name extension is <code>.dat</code>.
	The header consists of a definition of all system parameters and states.		The header consists of a definition of all system parameters and states.
	Thus, parameter values cannot change within a [[~~BCI2000Glossary~~#Run\|run]], which in turn corresponds to a single data file.		Thus, parameter values cannot change within a [[BCI2000 Glossary#Run\|run]], which in turn corresponds to a single data file.

	==Header==		==Header==

Mellinger at 19:37, 8 November 2007

2007-11-08T19:37:50Z

← Older revision		Revision as of 19:37, 8 November 2007
Line 2:		Line 2:
	Its associated file name extension is <code>.dat</code>.		Its associated file name extension is <code>.dat</code>.
	The header consists of a definition of all system parameters and states.		The header consists of a definition of all system parameters and states.
	Thus, parameter values cannot change within a [[~~Glossary~~#Run\|run]], which in turn corresponds to a single data file.		Thus, parameter values cannot change within a [[BCI2000Glossary#Run\|run]], which in turn corresponds to a single data file.

	==Header==		==Header==