Create a ParticipantGroup instance using long-format data

Takes in a data frame of raw 'long format' consistency test data and returns a ParticipantGroup instance, to which all the relevant data are linked. See the example data frame `synr_exampledf_long_small` and its documentation (`help(synr_exampledf_long_small)`) for more information on the format that this function expects data to be in.

Usage

create_participantgroup(
  raw_df,
  n_trials_per_grapheme = 3,
  id_col_name,
  symbol_col_name,
  color_col_name,
  time_col_name = NULL,
  color_space_spec = "Luv"
)

Arguments

raw_df

A data frame of 'long format' raw consistency test data.

n_trials_per_grapheme

A one-element numeric vector holding the number of trials per grapheme that was used in the consistency test the data are from.

id_col_name

A one-element character vector that holds the name of the participant id column in raw_df.

symbol_col_name

A one-element character vector that holds the name of the grapheme/symbol column in raw_df.

color_col_name

A one-element character vector that holds the name of the response color (hex codes) column in raw_df.

time_col_name

(optional) A one-element character vector that holds the name of the response time (time from stimulus presentation to response) column in raw_df.

color_space_spec

A one-element character vector specifying which color space to use for calculations with participant data. One of "XYZ", "sRGB", "Apple RGB", "Lab", and "Luv".

Examples

pg <- create_participantgroup(
  raw_df=synr_exampledf_long_small,
  n_trials_per_grapheme=2,
  id_col_name="participant_id",
  symbol_col_name="trial_symbol",
  color_col_name="response_color",
  time_col_name="response_time",
  color_space_spec="Luv"
)
cons_means <- pg$get_mean_consistency_scores()
print(cons_means)
#> [1] 131.2060 101.3738 151.9597