Input

A detailed log of all inputs and clicks recorded during the trial.

Summary view. Full reference → on behaverse.org/schemas.

Key

Field	Type	Requirement	Description
input_id	PRIMARY KEY	required	Primary key; each input or click has its own identifier value that is unique within the table.

Context

Field	Type	Requirement	Description
response_id	id	required	Indexing all the clicks that occurred within a given trial; ranging from 1 to input_count in the corresponding Response table.
response_element_index	index	optional	Indicates which of the clicks is used and in what order to form the actual response in the response table when response_structure is “sequence” or “set”. Range: 1 to input_count in the corresponding row of the Response table. Note: This needs to be here rather than in Option table, because the same option can be clicked multiple times and either serve or not for the response depending on the order of the clicks. For example, in the Digit Span test we could have the response of “3;5;7” on a particular trial. This might correspond to > - option.description = [“3”, “4”, “delete”, “delete”, “3”, “5”, “7”, “enter”] > - click.response_element_index = [NA, NA, NA, NA, 1, 2, 3, NA]

When

Field	Type	Requirement	Description
onset	float	required	Duration between the start of the trial and the moment the mouse button press occured, in seconds. Range: seconds
duration	float	optional	Describes for how long the mouse button was pressed, in seconds. Range: seconds

Where

Field	Type	Requirement	Description
x_screen	integer	optional	X coordinates of the click relative to the left edge of the screen in pixels. Range: pixels
y_screen	integer	optional	Y coordinates of the click relative to the top edge of the screen in pixels. Range: pixels
x_viewport	float	optional	X coordinates of the click relative to the left edge of the screen expressed as a fraction of the screen width. Range: 0 to 1 (inclusive).
y_viewport	float	optional	Y coordinates of the click relative to the top edge of the screen expressed as a fraction of the screen height. Range: 0 to 1 (inclusive).

What

Field	Type	Requirement	Description
object_type	enum	required	Describes the type of object that was clicked on (e.g., “button”).
object_name	string	required	The human-readable name of the object that was clicked on (e.g., “sos_box_1_3”).
is_object_enabled	boolean	optional	Indicates whether the object that was clicked on was enabled (clickable) or not.
object_state	string	optional	Describes the state the object was in before it was clicked on. The meaning of “state” depends on the particular task (e.g., “new empty”).
option_id	id	optional	If the click is on an option, this variable indicates which option it was. Range: Corresponding option_id in the Option table.
stimulus_id	id	optional	If the click is on a stimulus, this variable indicates which stimulus it was. Range: Corresponding stimulus_id in the Stimulus table.