Task design containers.
Top-level task design container.
Block(index, *args, **kwargs)¶
List of trials.
Experiments often consist of a set of blocks, each containing the same set of trials in randomized order. You usually shouldn’t need to create a block directly – use
Parameters: index (int) – Index of the block in the design. This is required to pass along to each trial in the block, so that the trial knows which block it belongs to.
Add a trial to the block.
Trialobject is created and added to the block. You can optionally provide a dictionary of attribute name/value pairs to initialize the trial.
Parameters: attrs (dict, optional) – Dictionary of attribute name/value pairs. Returns: trial – The trial object created. This can be used to add new attributes or arrays. See
Return type: Trial
Container of trial data.
There are two kinds of data typically needed during a trial: attributes and arrays. Attributes are scalar quantities or primitives like integers, floating point numbers, booleans, strings, etc. Arrays are NumPy arrays, useful for holding things like cursor trajectories.
There are two primary purposes for each of these two kinds of data. First, it’s useful to design a task with pre-determined values, such as the target location or the cursor trajectory to follow. The other purpose is to temporarily hold runtime data using the same interface, such as the final cursor position or the time-to-target.
You shouldn’t normally need to create a trial directly – instead, use
The array is not much more than a NumPy array with a
stack()method for conveniently adding new data to the array. This is useful in cases where you iteratively collect new segments of data and want to concatenate them. For example, you could use an
Arrayto collect the samples from a data acquisition device as they come in.
You usually don’t need to create an array manually – instead, use
The NumPy array holding the data.
Type: ndarray, optional
Clears the buffer.
Anything that was in the buffer is not retrievable.
Stack new data onto the array.
Parameters: data (ndarray) – New data to add. The direction to stack along is specified in the array’s constructor (stack_axis).