Module eyekit.io
Functions for reading and writing data.
Functions
def load(file_path)
-
Read in a JSON file.
FixationSequence
andTextBlock
objects are automatically decoded and instantiated. def save(data, file_path, *, compress: bool = False)
-
Write arbitrary data to a JSON file. If
compress
isTrue
, the file is written in the most compact way; ifFalse
, the file will be more human readable.FixationSequence
andTextBlock
objects are automatically encoded. def import_asc(file_path, *, variables: list = [], placement_of_variables: str = 'after_end', import_samples: bool = False, encoding: str = 'utf-8') ‑> list
-
Import data from an ASC file produced from an SR Research EyeLink device (you will first need to use SR Research's Edf2asc tool to convert your original EDF files to ASC). The importer will extract all trials from the ASC file, where a trial is defined as a sequence of fixations (EFIX lines) that occur inside a START–END block. Optionally, the importer can extract user-defined variables and ms-by-ms samples. For example, if your ASC file contains messages like this:
MSG 4244101 trial_type practice MSG 4244101 passage_id 1 MSG 4244592 stim_onset
then you could extract the variables
"trial_type"
and"passage_id"
. A variable is some string that is followed by a space; anything that follows this space is the variable's value. If the variable is not followed by a value (e.g.,"stim_onset"
above), then the time of the message is recorded as its value; this can be useful for recording the precise timing of an event. By default, the importer looks for variables that follow the END tag. However, if your variables are placed before the START tag, then set theplacement_of_variables
argument to"before_start"
. If unsure, you should first inspect your ASC file to see what messages you wrote to the data stream and where they are placed. The importer will return a list of dictionaries, where each dictionary represents a single trial and contains the fixations along with any other extracted variables. For example:[ { "trial_type": "practice", "passage_id": "1", "stim_onset": 4244592, "fixations": FixationSequence[...] }, { "trial_type": "test", "passage_id": "2", "stim_onset": 4256311, "fixations": FixationSequence[...] } ]
def import_csv(file_path, *, x_header: str = 'x', y_header: str = 'y', start_header: str = 'start', end_header: str = 'end', trial_header: str = None, encoding: str = 'utf-8') ‑> list
-
Import data from a CSV file. By default, the importer expects the CSV file to contain the column headers,
x
,y
,start
, andend
, but this can be customized by setting the relevant arguments to whatever column headers your CSV file contains. Each row of the CSV file is expected to represent a single fixation. If your CSV file contains data from multiple trials, you should also specify the column header of a trial identifier, so that the data can be segmented into trials. The importer will return a list of dictionaries, where each dictionary represents a single trial and contains the fixations along with the trial identifier (if specified). For example:[ { "trial_id" : 1, "fixations" : FixationSequence[...] }, { "trial_id" : 2, "fixations" : FixationSequence[...] } ]
def read(file_path)
-
Deprecated in 0.4. Use
load()
. def write(data, file_path, compress=False)
-
Deprecated in 0.4. Use
save()
.