make_time_sequence_data: make_time_sequence_data()

Description Usage Arguments Details Value Examples

View source: R/time_sequence_data.R

Description

Creates time-bins and summarizes proportion-looking within each time-bin.

Usage

1
2
make_time_sequence_data(data, time_bin_size, aois = NULL,
  predictor_columns = NULL, other_dv_columns = NULL, summarize_by = NULL)

Arguments

data

The output of make_eyetrackingr_data

time_bin_size

How large should each time bin be? Units are whatever units your time column is in

aois

Which AOI(s) is/are of interest? Defaults to all specified in make_eyetracking_r_data

predictor_columns

Which columns indicate predictor variables, and therefore should be preserved in grouping operations?

other_dv_columns

Within each time-bin, this function will calculate not only proportion- looking, but also the mean of any columns specified here.

summarize_by

Should the data be summarized along, e.g., participants, items, etc.? If so, give column name(s) here. If left blank, will leave trials distinct. The former is needed for more traditional analyses (t.test, ANOVA), while the latter is preferable for mixed-effects models (lmer)

Details

Aside from proportion looking (Prop), this function returns several columns useful for subsequent analysis:

Value

Data binned into time-bins, with proportion-looking and transformations as well as orthogonal time-polynomials for growth curve analysis

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
data(word_recognition)
data <- make_eyetrackingr_data(word_recognition, 
                               participant_column = "ParticipantName",
                               trial_column = "Trial",
                               time_column = "TimeFromTrialOnset",
                               trackloss_column = "TrackLoss",
                               aoi_columns = c('Animate','Inanimate'),
                               treat_non_aoi_looks_as_missing = TRUE
)

# bin data in 250ms bins, and generate a dataframe
# with a single AOI (Animate) predicted by Sex, and summarized by ParticipantName
response_time <- make_time_sequence_data(data,
                                         time_bin_size = 250,
                                         predictor_columns = c("Sex"),
                                         aois = "Animate",
                                         summarize_by = "ParticipantName"
)

# optionally specify other columns in the data
# to be included in the generated dataframe
# (e.g., for use in statistical models)
# bin data in 250ms bins, and generate a dataframe
# with Animate and MCDI_Total summarized by ParticipantName
response_time <- make_time_sequence_data(data,
                                         time_bin_size = 250,
                                         predictor_columns = c("Sex","MCDI_Total"),
                                         aois = "Animate", 
                                         summarize_by = "ParticipantName"
)

eyetrackingR documentation built on May 30, 2017, 12:35 a.m.

Search within the eyetrackingR package
Search all R packages, documentation and source code