BlockAdd statement

 BlockAdd
   Range=trial_range
   Name=variable_name_suffix
   [Begin=begin_time]
   [End=end_time]
   [WinRange=trial_range]

Type conventions and statement syntax are explained in the Glossary.

Adds one trial range to the definition of a block of trial ranges which can later be used to build blocks of case variables. Optionally, time window parameters can be defined for all or part of the trials in the range: they will be forwarded to any Window statement appearing between BlockBegin and BlockEnd statements.

Parameters...

Range
Range parameter indicating the trials to be included in the range. There is no default, you must specify a range.

Name
Name parameter indicating the suffix to be appended to the variable names in the block in order to distinguish variables that apply to different trial ranges. There is no default, you must specify a suffix.

Begin
Number parameter indicating the begin of the time window. If Begin < End, Begin is interpreted as offset from the beginning of the trial. If Begin > End, Begin is interpreted as offset from the end of the trial. If no value is specified for this parameter, Wintrack will use the time window setting of the Analyze Case command to supplement a default value each time the custom variable definition file is processed.

End
Number parameter indicating the end of the time window. If Begin < End, End is interpreted as offset from the beginning of the trial. If Begin > End, End is interpreted as offset from the end of the trial. If no value is specified for this parameter, Wintrack will use the time window setting of the Analyze Case command to supplement a default value each time the custom variable definition file is processed.

WinRange
Range parameter indicating the range of trials to which the window defined by the Begin and End parameters is to be applied. The window is applied to the entire range specified in the Range parameter if nothing is specified here.

Note that...

Each definition of a block of trial ranges must be initiated by a BlockDef statement.

Additional information...

• Managing custom variable definition files provides general information on the management of custom variable definition files.
• The Flowchart of advanced data analysis gives a synopsis of data and variable types.
• How to create case variables covers the basics of case variable creation.
• How to define variable blocks explains how to define case variables more efficiently by grouping them into variable blocks.
• There is a topic describing how to build a custom variable definition file.
• There is a list of all available variable definition statements.
• See Analyze Case Document command for basic information on that command.
• Inside case documents provides advanced information on case documents.