An introduction to E-Prime

When running an experiment, precision is essential to ensure results are as exact as possible. Thus, computers, which offer endless accuracy, have become an inevitable tool to design experiments. To avoid programming from scratch for each new situation, a program, E-Prime, has been created to ease the conception of experiments. E-Prime, developed by PSTNet, offers a user-friendly interface that makes typical experiments easy to create. This paper shows how to effortlessly create an experiment with E-Prime, followed by a simple example.


Structure
The structure window gives an overview of the experiment being built, as shown in Figure 2.
The structure of the experiment should be thought through before even opening E-Prime.In an experiment, it is often easier to design starting with the more simple elements, such as the trial.Contrarily, it is easier, in E-Studio, to start with the main concept and slowly work down to the trial.Some basic elements can be seen in the structure window such as the frames, the trials, the blocks and the complete experiment.Frames :A frame is an event during the experiment.It can either be a slide with text or pictures shown to the subject or simply a delay.For the subject, an experiment is simply a sequence of frames.Each frame can have a fixed duration, be terminated by an external event or both."Both" would be where a frame should be ended by an external event, such as the subject hitting the space bar, but with a limited time to do so.Trials : Trials are where the real testing happens.They consist of an organized set of frames in which the stimuli are presented.Each trial will show different stimuli according to the goal of the experiment.In E-Prime, a template is programmed for the series of trials and the specifics of each trial are then listed.Blocks : A block is a group of trials.Usually, an experiment will include a few blocks that will often be exactly the same.It is within the blocks that all trials necessary to collect all the data are listed.The blocks can also include an introductory frame and a conclusion one.These frames can be used as pauses during the experiment.They can also inform the subject of his or her progress by stating the number of blocks left.

Complete experiment
With all the blocks, the trials and the frames, the experiment is complete.Only a few introductory frames with instructions and concluding remarks on other frames are missing to have the final product.

Toolbox
The toolbox contains all the objects that can be used in the experiment.In the structure window, the tools can be identified through the icons presented.The tools will be organized, as shown in the structure window, to create the experiment.Some of the tools can be grouped by their functions, while others are a class of their own.Frames : There are quite a few tools that are used as frames.
Text display : The text display is a slide shown to the subject that can only contain text.It has many properties, as described in Table 1.
Image display : This frame presents images to the subject.It has practically the same properties as the text display.

Slide :
The slide is far more polyvalent as it allows the user to manipulate text, images and sounds on the same frame.It is presented, much like the text display and the image display, to the subject at a specific time.The three small icons at the top of the frame, as shown in Figure 3, are used to insert any of the three elements.The slide's properties are close to the text display's properties.

Feedback display :
The feedback display, as stated by its name, presents feedback to the subject.Feedback can be given about any action of the subject, as long as it is specified in the Input Object Name.Feedback can also present different information such as accuracy, response time, dispersion measures, etc. Accuracy can be defined by any of these three options: correct, incorrect or no response.Instead, the last frame will be displayed.The main property is Duration under the DurationInput tab, which dictates the length of the wait.Procedure : One of the more important objects is the procedure, which organizes the frames and tools.
The objects from the toolbox can be dragged and dropped along the line drawn across the window.Afterwards, simply editing the different objects will create the experiment.It is also through the addition of a procedure that it is possible to change the level of specificity, as in going from the blocks to the trials.The procedure is used to create the complete experiment, then the blocks at a lower level and, finally, the trials.
The procedure only has one property: log data.It's used to prevent the recording of data during this specific procedure which might be useful for, among other examples, a practice set.
Since programming every trial would be extremely cumbersome, the procedure becomes a template.It is through the use of a list that the template will be modified with each trial and, in the end, will create the experiment.List : The lists dictate how and how many times the procedures will be repeated.Mainly, they are used to create the blocks by housing the information specific to each trial.It is also with lists that the blocks are repeated.A list minimally contains three columns.One is to specify the procedure that should be displayed.Most of the time, all the rows will have the same procedure name, but if some trials are different from the rest and require a different procedure, this is where it should be noted.Next is a column for the weight an element should have (i.e. the number of time it is showed to the subject compared to the other elements).And, finally, a column called "Nested" to specify if there is another list under the present list.Other information can be added such as the stimuli used, the response expected, the order in which the elements should be presented, to name only a few.The list object has a few properties, as listed in Table 2.
In the list window, shown in Figure 5, there are a few simple tools.The table itself works somewhat like an excel worksheet.
The first two options respectively add one row or

Data logging
To specify the kind of answer expected from the subject.

Devices
To specify the device that will be used to answer (ex: keyboard).Allowable To specify the keys used to answer.All the other keys will be disabled.

Correct
To specify the correct answer.

Time limit
To specify the allotted time to answer.

End action
To specify what will happen once the frame ends.It can either stops there (terminate), jump to a label or do nothing (none).Sound Out : This object implements a sound within the experiment and, accordingly, doesn't have any visual presentation.There are a few properties associated as listed in Table 3.
Label : The label tool is used to mark a point in the time line.It is only useful when one wants to jump to a certain point in the experiment.It doesn't have any other properties than its placement.
Package call This tool is used to connect an E-Prime experiment to another device such as an EEG or an EKG.

Properties
This window shows the properties of the selected object, as seen in Figure 1, number 3. While useful, it can sometimes cause mistakes.It is indeed important to make sure that the object being modified is really the object requiring a change.

Worksheet
The worksheet is the main window where you see what the subject will see.It is shown in Figure 1, where it is identified as number 4. It displays the visual part of the selected object.

Example of an experiment
To clarify all the notions on E-Studio here is an example: the Priming Experiment.In this experiment, the participant has to identify the probe word as being living or non-living.Before seeing the probe word, a prime word, shown too quickly to consciously see it, is presented.The prime word is either congruent (both of the same category) with the probe word or incongruent (both of different categories).The basic structure of the experiment is shown in Figure 6.To specify after how many lines the list should be reset.

Exit list
To specify after how many trials the list should be ended.The trials will contain two stimuli each.Table 4 shows four examples of trials.

Creating the structure
Once the main structure of the experiment has been designed, the actual programming in E-Studio can start.First, to create the main frame, a procedure should be used.It can be created by double-clicking on the "Procedure" icon in the toolbar.Once the window is open (Figure 7) two text displays, one for the instruction and one for the end, are to be placed along the lines in the window by simply dragging and dropping them around a list.The text displays can be renamed for more clarity.
Next, a sublevel is created through the list.To achieve this, a new procedure is added in the list tool.By doubleclicking on the Blocklist object, its properties window appears.First, because the experiment consists of ten blocks and the number of lines should match, one can click on the second icon to add nine lines.Second, the "Procedure" column should present the name of the block procedure, here, in Figure 8, named BlockProc.The BlockLeft column of Figure 8 is used to indicate, to the subject, the number of blocks left.
By entering the name of a new procedure in the list, it is automatically created and the new level is added.Through the same process used for the first procedure, a template for each block is designed with two slides and a list (Figure 9).
In this new list, 39 lines are added since the design of the experiment demands 40 trials.The procedure column should show the trial procedure "TrialProc".In this new procedure, the template for each trial is found, as in Figure 10.
The structure of the experiment is now complete and clearly shown in the structure window (Figure 11).

Changing the tools
Each tool should have its properties changed to best fit the experiment.The "Instructions", "GetReady" and "EndOfBlock" frames should be ended by the participant hitting the spacebar.To achieve this, the Duration property, under the Duration/Input tab, should be set at "(infinite)" and the Allowable property at "{SPACE}" after the Keyboard has been selected in the Device(s) window (Figure 12).
For the two list objects, the selection order has to be specified.This can be done through the Selection tab in their properties window, in the Order command.The block list has to be set at Sequential while the trial list needs to be at Random.
In the trial procedure, the "FixationPoint", "FirstMask" and "SecondMask" frames need five lines for their specific displays.The center line is for a cross sign, which is the fixation point.The "FirstMask" will also show a "#####" sign on the first line while the "SecondMask" will show the same sign, but on the fifth line.
The two other slides, "FirstWord" and "SecondWord", show the actual stimuli.To achieve this, the "FirstWord" slide will contain the five lines and the fixation point from earlier but, also, the word "[Primer]" situated on the first line.The same thing stands for the "SecondWord" slide, but the word is "[Probe]" and written on the fifth line.These two words will change with each trial to show the words included in the list.The list needs two more columns, named Primer and Probe to host the stimuli, as shown in Figure 13.
When the second word is presented, data has to be collected.First, the correct response has to be specified in the trial list under the name Living.The Congruency column of Figure 13 was created only for analysis purposes and doesn't have any function in the experiment itself.In the "SecondWord" slide, in the properties window, under the Duration/Input tab, once the keyboard is selected as the device, the allowable keys are to be specified.In this case, both 1 and 2 are allowed and should be noted as 12 in the "Allowable" field.Also, the Correct field, just under the Allowable one, has to show [Living].This refers to the columns containing the correct answers for each trial, as shown in Figure 14.
The time limit set at 2000 indicates that the participant has two full seconds to answer before the frame disappears.
Finally, the feedback display object has to be adjusted.The Input Object Name property has to show the "SecondWord" slide so that it can present the feedback for the right object.Each experiment has an .ebsfile, which is the E-Run file.This file shows the experiment in E-Basic code, as seen in Figure 17.While the experiment can be modified through this window, it is not the most practical way to do so.

E-DataAid
This program shows the data collected, as presented in Figure 18.It uses the .edatfile created after running the experiment.It is a useful program that offers a few simple functions to modify the data, but nothing more.It is mainly practical to delete unnecessary information.
Each data file contains a lot of information under many columns.Every column is a different variable and many of those are useless.Unfortunately, it is not possible to stop E-Prime from logging those variables, but they can easily be deleted without losing any information.With the Arrange columns option, in the Tools menu (see Figure 18), one can choose the variables one wants to keep.It is also possible to filter the lines with the Filter option, shown in Figure 18.For example, one could choose only one block for further analysis.All the columns taken away are actually only hidden and can be shown again with the same tools.
Since E-DataAid is somewhat limited, it is probably easier to export the information.Through the Export function in the file menu, the format compatible with other data analysis programs can be chosen.

E-Merge
When experimenting with many subjects, it is easier to do any analysis on the whole of the data accumulated.To create one file with information from all the subjects, E-Merge can be used.Its interface is quite simple, as shown in Figure 19.After opening the targeted file in the left window, one simply selects the files to merge and click on Merge, at the top of the screen.This will create a new file containing all the data from the previously selected files.

E-Recovery
If an experiment is aborted, not all data will be lost, but only a .txtfile will be created.While useful, it cannot be opened by E-DataAid, but E-Recovery can transform it into an .edatfile.Its use is quite simple: select the .txtfile, click on Recover and a new file will be created.

Conclusion
E-Prime is an intuitive and easy program to use after only a short period of time.Still, some experiments may be a little trickier to create and the following sources of information could be helpful.

Figure
Figure 7: Session Procedure

Figure 17 :
Figure 17: Opening window of E-Run

Figure
Figure 19: The E-Merge interface

Table 1 :
Text Display's PropertiesGeneral tabText This shows the text which will be displayed.All the other options in this and the frame tab modify the properties of the text.
Basic code.This sheet can be used anywhere in the experiment.The only property is log data.It allows one to indicate if there's any data that should be recorded from this tool.
multiple rows.The next two do the same thing, but for columns.The next one governs the summary section.The last two delete a row or a column.Other tools : There are a few other tools that can be used in E-Studio.In Line : If the experiment being created has particulars not included in E-Studio, the In Line tool can be useful.Indeed, In Line is a blank page in which one can program using the E-

Table 3
/www.pstnet.com/products/E-Prime/.Offers a section with many typical programs.• http://step.psy.cmu.edu/scripts/categories.html.Offers many classic examples of experiments such as the Stroop effect or the McCollough effect.