Selection Variable¶

Description¶

A variable whose current value is drawn from a list of possible values. The order and number of selected values are determined by selection, nsamples, and sampling_method. Use Next Selection to advance to the next value.

Signature¶

variable/selection

Required Parameters¶

values¶

Comma-separated list of values from which the variable’s current value is drawn. May include range expressions.

Optional Parameters¶

advance_on_accept¶

Default:: NO

If YES, Accept Selections will automatically invoke Next Selection (unless all selections have been exhausted)

autoreset¶

Default:: NO

If YES, Reset Selections will be invoked automatically when all selections have been exhausted

selection¶

Options:: sequential

sequential_ascending

sequential_descending

random_without_replacement

random_with_replacement
Default:: sequential

Order in which to draw selections

nsamples¶

Default:: 1

Number of samples to allow before Reset Selections is required

sampling_method¶

Options:: cycles

samples
Default:: cycles

Controls the interpretation of nsamples. If set to cycles, all possible selections must be made to complete one sample. If set to samples, each individual selection counts as a sample.

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.

Placement¶

Allowed at top level:	Yes
Allowed parent:	Folder