Protocol

Description

A top-level paradigm component that contains other sub-components.

Protocols are the largest unit of logical organization in an experiment. To “run” an experiment really means to run one or more of its protocols.

The execution order and number of repetitions of a protocol’s sub-components are determined by selection, nsamples, and sampling_method.

Signature

protocol

Optional Parameters

interruptible

Default:YES

If NO, then any request to pause or stop the experiment while this component is executing will be deferred until said execution completes. This behavior is inherited by the component’s children, making them non-interruptible as well.

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:	No
Allowed parent:	Experiment, List Replicator, Range Replicator
Allowed children:	Action, Block, List, List Replicator, Range Replicator, Task System, Trial