Variable¶
Description¶
A general-purpose variable, used to store experiment parameters, collect results, and mediate the transfer of data between components
Signature¶
variable
- Alias:
var
(MWEL only)
Required Parameters¶
default_value¶
- Example:
0
Initial value assigned to the variable when the experiment is loaded
Optional Parameters¶
scope¶
- Options:
global
local
- Default:
global
Controls the visibility of changes made to the variable’s value.
If a variable has local scope, then changes to its value are visible only within the paradigm component in which the assignment was made. These local changes persist between executions of the paradigm component.
If a variable has global scope, changes to its value are visible everywhere.
logging¶
- Options:
never
when_changed
- Default:
when_changed
Determines when the variable’s value is written to the event stream (and thereby the data file)
persistent¶
- Alias:
saved
- Default:
NO
If YES
, then the variable’s value is included in saved variable sets created via MWClient
exclude_from_data_file¶
- Default:
NO
If YES
, then the variable’s value is not written to the data file. Other event stream listeners (e.g. MWClient, client- and server-side conduits) continue to receive its value.
groups¶
Comma-separated list containing the names of groups to which the variable belongs. Variable groups are displayed as expandable sections in MWClient’s variables window.
description¶
- Alias:
desc
Description of the variable’s meaning or intended usage. Variable descriptions are displayed as tooltips in MWClient’s variables window.
Deprecated Parameters¶
type¶
- Options:
any
boolean
integer
float
string
list
- Default:
any
Controls how the content of default_value is interpreted. When set to any
(recommended), the default value is parsed like a normal expression, and the parser infers its type.
Placement¶
Allowed at top level: |
Yes |
---|---|
Allowed parent: |
|
Allowed children: |