tbl_run_peer_evaluation: Run a peer evaluation app

Description Usage Arguments See Also

View source: R/peer_evaluation.R

Description

This function starts the peer evaluation user interface. Note that this function is typically NOT called directly but indirectly by setting up the peer evalution app using tbl_setup_peer_evaluation, adjusting the files in the peer evaluation app folder, and test running the app using tbl_test_peer_evaluation.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
tbl_run_peer_evaluation(data_gs_title, roster = read_excel("roster.xlsx"),
  gs_token = "gs_token.rds", app_title = "Peer Evaluation",
  welcome_md_file = "app_welcome.md",
  self_eval_plus_md_file = "app_self_evaluation_plus.md",
  self_eval_minus_md_file = "app_self_evaluation_minus.md",
  teammate_eval_plus_md_file = "app_teammate_evaluation_plus.md",
  teammate_eval_minus_md_file = "app_teammate_evaluation_minus.md",
  quant_scores_md_file = "app_quantitative_scores.md",
  points_per_teammate = 10, max_points = 15, min_points = 0,
  min_point_difference = 2, auto_login_access_code = NULL, ...,
  launch = FALSE)

Arguments

data_gs_title

name of the google spreadsheet that should be used for storing the peer evaluation data. This spreadsheet must already exist and the credentials used when asked by this function must have write access to the spreadsheet.

roster

data frame with the student roster

gs_token

path to a google spreadsheet oauth 2.0 authentication token file (see Token-class). If none is provided or the file does not exist yet, will ask for google drive credentials interactively to generate a token for the peer evaluation app. The token is safe to use on a secure shiny app server but be careful to never post this token file anywhere publicly as it could be used to gain access to your google drive.

app_title

the title of the Peer Evaluation App, e.g. "Class name - Peer Evaluation #1"

welcome_md_file

path to a markdown (.md) file for the login welcome message

self_eval_plus_md_file

markdown file for the "plus" self evaluation message

self_eval_minus_md_file

markdown file for the "minus" self evaluation message

teammate_eval_plus_md_file

markdown file for the "plus" teammate evaluation message

teammate_eval_minus_md_file

markdown file for the "minus" teammate evaluation message

quant_scores_md_file

markdown file for the quantiative scores message

points_per_teammate

points per teammate

max_points

the maximum number of points allowed per team member

min_points

the smallest number of points allowed per team member

min_point_difference

the minimum point difference required for the scores (set to 0 to allow all scores to be identical)

auto_login_access_code

set an automatic login access code for testing and debugging purposes

...

passed on to the runApp call (only if launch = TRUE), can include server-specific parameters such as host or port

launch

whether to launch the app (TRUE) or return a shiny app object (FALSE) that then can be launched via runApp

See Also

Other peer evaluation functions: tbl_setup_peer_evaluation, tbl_test_peer_evaluation


KopfLab/tbltools documentation built on March 19, 2018, 9:14 a.m.