For several reasons, it is useful to be able to inspect and alter the list of studies used in particular analysis (e.g. to use a search-and-replace edit command in case files have been moved).
The information contained in BrainVoyager QX text files is either given in the form:
or, if a short list of values (e.g. an RGB color code triplet) is given, as
NameOfList: Value1 Value2 Value3
or yet, in case several values are to be coded, as an array of values (or strings) without any header
Row1Col1 Row1Col2 Row1Col3 Row2Col1 Row2Col2 Row2Col3 ...
Text-based tokens (constant values) are generally given without quotes (with exceptions noted where appropriate)! Linebreaks and empty lines are added for increased readability. They do, however, not impact the actual reading of information from the file!
FileVersion: 3 TypeOfFunctionalData: VTC RFX-GLM: 1 PSCTransformation: 1 zTransformation: 0 SeparatePredictors: 2 NrOfStudies: 5 "/Data/Study/Sub01/Sub01_MNI.vtc" "/Data/Study/Sub01/Sub01_Protocol.prt" "/Data/Study/Sub02/Sub02_MNI.vtc" "/Data/Study/Sub02/Sub02_Protocol.prt" "/Data/Study/Sub03/Sub03_MNI.vtc" "/Data/Study/Sub03/Sub03_Protocol.prt" "/Data/Study/Sub04/Sub04_MNI.vtc" "/Data/Study/Sub04/Sub04_Protocol.prt" "/Data/Study/Sub05/Sub05_MNI.vtc" "/Data/Study/Sub05/Sub05_Protocol.prt"
As almost any text-based file format in BrainVoyager QX, a
FileVersion field allows the program to add new features. Given that information, the following fields are currently supported by NeuroElf/xff:
|FileVersion||single number|| || the default is
|TypeOfFunctionalData||text token|| either of || indicates which filetype is referenced by the MDM file (for
|RFX-GLM||boolean number|| either || if set top
|PSCTransformation||boolean number|| either || if set to
|zTransformation||boolean number|| either || if set to
|SeparatePredictors||single number|| either of || codes whether predictors of equal name are either concatenated across all runs of all subjects (
|NrOfStudies||single number|| e.g. ||gives the number of referenced time course (and model) filenames|
|ReferencedFiles||array of strings||(see example)|| for
.RunTimeVarsconstruct (see the Auxiliary functionality sub-section of the page describing the xff class), such as a list of motion parameters (being used to regress out motion-related artifact from the data), temporal filtering parameters, grouping of subjects (for the plotting of trial-related averages, etc.)