Reporter Element

Summary ¶

	Reporter
Info
Category:	Data collection		AddIn:	Base Layer
Creator:	OkazoLab		Scope:	Parent event
Owns Snippets:	None		Usage:	Snippets

Properties ¶

Name	Description	Constraints	Type	On runtime change
Settings
Recording Juncture	Defines a time juncture in the parent event, in which the element records selected variables into Data Report.	Design Time..	enRepo..
Open Data Designer	Opens a visual designer for data collection	Design Time..	Boolean
Runtime
Is Active	Defines whether Reporter is in a working state. Set this property to false in order to suspend data recording.	Normal..	Boolean
Control
Is Enabled	If set to false the element is completely omitted when the experiment is run	Design Time..	Boolean
Title	Title of the element	Design Time..	String

¶

Description ¶

Snapshots ¶

Visual designer of the Reporter element

Practical Use ¶

Using Reporter for collecting trial data into a multi-line table ¶

1. Check the logic of your experiment to choose variables whose values you want to collect in each trial.
2. Add the Reporter element to the event in which you want to collect data. Typically, it is the last event in a trial loop.
3. Set the Recording Point property of Reporter. You can define there when data will be collected, either on onset or offset of the parent event. The default option is the event
   offset, because you may need to calculate a trial outcome, after onset of the last trial event but before trial data is recorded.
4. Open the Reporter data designer by clicking on the corresponding property.
5. Using a drop-down list on the left-top of the designer, select and add all variables whose values you want to record in each trial:
   
   

   Selection of variables
   in Reporter's data designer

   
   
   
   
   
   
   
   
   
   
   
   
   
   

1. In the Layout Option panel set the layout of variables to "in rows" and choose a character that will be used a column separator.
2. Check the report preview at the bottom of the designer.
3. Close the designer and run an experiment for several trial loops.
4. Open or export the resulting data report, and check how trial data is recorded. You should see data organized in a table, for example:
   

   
   
   Participant Code;Block Number;Trial Number;Target Position;Target Color;Target Shape;SOA Duration;Trial Result;Trial RT;
   
   Participant 01;1;1;180;Blue;1;100;True;881;
   
   Participant 01;1;2;180;Yellow;2;400;True;564;
   
   Participant 01;1;3;180;Blue;2;300;False;0;
   
   Participant 01;1;4;0;Blue;2;600;True;867;
   
   Participant 01;1;5;180;Red;2;200;True;760;
   
   

   
   

Using Reporter for collecting data into a record list ¶

1. Repeat steps 1-5 from the previous technique, except for selection of the parent event. The record list is usually added once per run, at the start of the experiment.
2. Set the layout of variables to "in columns" in the Layout Option panel of Reporter's designer. If you do not want variables' names to be included in a record list, uncheck the 'Append variables's headers' option.
3. Set the layout of variables to "in columns" in the Layout Option panel of Reporter's designer. If you do not want variables' names to be included in a record list, uncheck the 'Append variables's headers' option. Otherwise, select a character that will separate variable's name and value in each row.
4. Check the report preview at the bottom of the designer
5. Close the designer and run an experiment for several trial loops.
6. Open or export the resulting data report, and check how trial data is recorded. You should see data organized in a list, for example:
   

   
   
   Participant Code;Participant 01;
   
   Condition; AA05;
   
   Key Map; 01;
   
   

   
   

Element's internal actions aligned with epochs of the parent event ¶

Notes ¶

• You can apply a format to a variable value, before it is recorded. To do so, add a .Net format string to the third row of the variable table in Reporter's designer. For example, the format string '0.00' ensure that a recorded numerical values will have 2 digits in the fractional part.
• You can use multiple Reporter elements in an experiment, but be aware of the order, in which they save data into a data report.
• There is no need to use the Reporter element when you want to save some global experiment variables at the top of a data report. Instead, you can used the startup info variables.
• While using the Reporter element, you still can write arbitrary data into a data report manually, via code snippets.
• You can temporally suspend data collection done by the Reporter element. To do it, set the 'Is Active' property to False at runtime.