This is the ‘quick start’ guide to synr. For an in-depth tutorial, please see the main tutorial.
If you have long format data (otherwise see Creating ParticipantGroup objects):
<- create_participantgroup( pg 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", # optional, not necessary for core functionality color_space_spec="Luv" )
The resulting object (
pg) is a nested structure implemented with reference classes. With this, you can call various methods and access various attributes. Examples of common use cases are included below.
Consistency scores for all participants, looking only at trials involving letters.
<- pg$get_mean_consistency_scores(symbol_filter=LETTERS) cons_scores_letters print(cons_scores_letters) #>  119.2646 129.1678 145.5045
Plot of single participant’s per-grapheme consistency scores, looking only at trials involving the graphemes ‘A’ and ‘7’.
# get mean consistency scores for all participants, filtering first by letters, then digits <- pg$get_mean_consistency_scores(symbol_filter=LETTERS) mean_cscores_letters <- pg$get_mean_consistency_scores(symbol_filter=0:9) mean_cscores_digits # get number of graphemes where all response colors were non-missing, # filtering first by letters, then digits # (in the example data frame, all participants have all-valid responses) <- pg$get_numbers_all_colored_graphemes(symbol_filter=LETTERS) num_valid_letters <- pg$get_numbers_all_colored_graphemes(symbol_filter=0:9) num_valid_digits <- pg$get_ids() p_ids <- data.frame( mean_scores_df participant_id=p_ids, cscore_letters=mean_cscores_letters, cscore_digits=mean_cscores_digits, num_valid_letters=num_valid_letters, num_valid_digits=num_valid_digits )print(mean_scores_df) #> participant_id cscore_letters cscore_digits num_valid_letters #> 1 1 119.2646 155.089 2 #> 2 2 129.1678 45.786 2 #> 3 3 145.5045 164.870 2 #> num_valid_digits #> 1 1 #> 2 1 #> 3 1
Apart from the aforementioned vignettes, you can find help documentation for fields/attributes and methods of involved objects by running