In Psifr, free recall data are imported in the form of a “long” format table. Each row corresponds to one study or recall event. Study events include any time an item was presented to the participant. Recall events correspond to any recall attempt; this includes repeats of items there were already recalled and intrusions of items that were not present in the study list.
This type of information is well represented in a CSV spreadsheet, though any file format supported by pandas may be used for input. To import from a CSV, use pandas. For example:
import pandas as pd data = pd.read_csv("my_data.csv")
The basic information that must be included for each event is the following:
Some code (numeric or string) indicating individual participants. Must be unique for a given experiment. For example, sub-101.
sub-101
Numeric code indicating individual lists. Must be unique within subject.
String indicating whether each event is a study event or a recall event.
study
recall
Integer indicating position within a given phase of the list. For study events, this corresponds to input position (also referred to as serial position). For recall events, this corresponds to output position.
Individual thing being recalled, such as a word. May be specified with text (e.g., pumpkin, Jack Nicholson) or a numeric code (682, 121). Either way, the text or number must be unique to that item. Text is easier to read and does not require any additional information for interpretation and is therefore preferred if available.
pumpkin
Jack Nicholson
682
121
subject
list
trial_type
position
item
1
absence
2
hollow
3
pupil
Additional fields may be included in the data to indicate other aspects of the experiment, such as presentation time, stimulus category, experimental session, distraction length, etc. All of these fields can then be used for analysis in Psifr.