Option

Describes each option that a subject could choose from in a trial.

note

Note that in some tasks, the options may change within a trial after each input (e.g., serial self-ordered search task); therefore the options are optionally indexed by input_index.

Key

Field	Type	Requirement	Description
option_id	PRIMARY KEY	required	Primary key of the Option table. Reference to this identifier in other tables are thus named option_id.

Context

Field	Type	Requirement	Description
trial_index	id	required	Refers to the trial_index in the Response table and indicates in which trial this option was shown.
response_id	id	optional	Refers to the response_id in the Response table and indicates for which response this option was shown.
index_in_trial	index	optional	Indexing each of the options within the set of options that were available to subjects on a given trial.
object_id	string	optional	An option is defined by a set of features. This variable is used to identify each time the same features were used. For example, if the same white digit "3" is used as an option in the Digit Span task, all those instances would have the same object_id although they would have different ids (as they appeared at different times).

When

Field	Type	Requirement	Description
onset	float	required	Duration between the start of the trial and the moment the option was displayed or activated, in seconds.
duration	float	required	How long the option was displayed or active in seconds, starting from the onset, in seconds.

Where

Field	Type	Requirement	Description
panel_id	string	optional	Identifier of the pane this option was displayed over.
x_screen	float	optional	X coordinates of the option component on the screen in pixels.
y_screen	float	optional	Y coordinates of the option component on the screen in pixels.
x_viewport	float	optional	X coordinates of the option component on the screen expressed as a fraction of the screen width.
y_viewport	float	optional	Y coordinates of the option component on the screen expressed as a fraction of the screen height.

What

Field	Type	Requirement	Description
description	string	required	A human readable, compact description of the main aspects of the option. The description for a given option depends on the task but follows a specific template for a given task. Because of this, it looks like the option description could be parsed---however, this is not the intention; structured, parsed data will be available in other fields; description is for human readability and facilitates the understanding of the data.
value	float	optional	A numeric value associated with a particular response option; typically indicating the "worth" of a response (e.g., value=1 for the correct response).
source	string	required	Refers to the specific generator or set from which the option originates. Options sharing the same source have the same data structure and can be thus collectively described in a table named after option_source (e.g., "digit1to9").
source_type	enum	optional	An option is typically created using a particular procedure/algorithm or is sampled from a particular set. This variable indicates which of these two applies for the current option.
index_in_source	integer	optional	When a option is picked from a particular set (e.g., digits1to9), this index refers to the index within that set.

How

Field	Type	Requirement	Description
animation	string	optional	Describes the animation used to display a specific option in a human-readable format. For example, "fadeIn 3s ease-in-out" indicates a 3-second fade-in animation.