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

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.

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.

Placement

Allowed at top level:

Yes

Allowed parent:

Folder