Read and combine raw OpenSesame data.
Read and combine multiple raw data files that were collected with OpenSesame (Mathot, Schreij, & Theeuwes, 2012). The files will be merged into one data.frame.
read_opensesame(directory = ".", subdirectories = FALSE, extension = NULL, data = NULL, verbose = TRUE)
- a character string. Name of the folder where the raw data are stored. If it does not contain an absolute path, the file name is relative to the current working directory. Defaults to current working directory.
- logical indicating whether the directory contains
FALSE(the default), it is assumed that all raw data files are directly included in the directory. If
TRUE, it is assumed that the raw data files are stored in folders within the directory. Alternatively, a vector of folder names that contain the raw data.
- an optional character string. If specified, only files ending with the specified extension will be merged.
data.frameto which the new data will be added. This is optional, and an empty
data.frameis used if none is provided.
- logical indicating whether function should report its progress.
OpenSesame generally produces an output
.csv file for each participant
in the experiment. This is handy during data collection, but for the analysis
it is often useful to combine many such files into a single
data.frame. This is the single task of the
function, which loads all files from a given directory and attempts to
combine them into a
read_opensesame provides a wrapper around read_bulk to load the
raw data files. After loading, the different data files are merged using
rbind.fill. This function can deal with varying column names
across files, and still places data into the appropriate columns. If a column
is not present in a specific file, it will be filled with
A data.frame containing the merged raw data.One column in the data.frame (
File) contains the name of the raw data file. If the
subdirectoriesoption is set, an additional column (
Subdirectory) with the name of the subdirectory is added.
Mathot, S., Schreij, D., & Theeuwes, J. (2012). OpenSesame: An open-source, graphical experiment builder for the social sciences. Behavior Research Methods, 44(2), 314-324.
read_bulk for reading and combining multiple data files that have other file formats.
## Not run: # # Read single raw data file from OpenSesame # raw_data <- utils::read.csv("raw_data/subject-1.csv",encoding = "UTF-8") # # # Merge all files in the main folder "raw_data" # # (which is in the current working directory) # raw_data <- read_opensesame(directory = "raw_data") # # # Merge files with file extension ".csv" # raw_data <- read_opensesame(directory = "raw_data", # extension = ".csv") # # # Merge all files stored in separate folders # # within the folder "raw_data" # raw_data <- read_opensesame(directory = "raw_data", # subdirectories = TRUE) # # # Merge all raw data stored in the folders "Session1" # # and "Session2" within the folder "raw_data" # raw_data <- read_opensesame(directory = "raw_data", # subdirectories = c("Session1","Session2")) # # # Export merged data to a file using write.table # write.table(raw_data, file = "raw_data.csv", # sep=",", row.names = FALSE) # ## End(Not run)