apptime {gmoTree} | R Documentation |
Calculate the time that was spent on an app
Description
Calculate the time spent on one app or several apps.
Usage
apptime(
oTree,
apps = NULL,
pcode = NULL,
plabel = NULL,
group_id = NULL,
seconds = FALSE,
rounded = TRUE,
digits = 2,
sinfo = "session_code",
combine = FALSE
)
Arguments
oTree |
A list of data frames that were created by import_otree(). |
apps |
Character. Name(s) of the app(s) for which the time should be calculated. |
pcode |
Character. The value of the participant.code variable if the time should only be calculated for one specified participant. |
plabel |
Character. The value of the participant.label variable if the time should only be calculated for one specified participant. |
group_id |
Integer. The value of the group_id variable if the time should only be calculated for one specified group. The group_id variable can be created with make_ids(). |
seconds |
Logical. TRUE if the output should be in seconds instead of minutes. |
rounded |
Logical. TRUE if the output should be rounded. |
digits |
Integer. The number of digits to which the output should be rounded. This parameter has no effect unless rounded = TRUE. |
sinfo |
Character. "session_id" to use session ID for additional information in the data frame of single durations, "session_code" to use session codes, or NULL if no session column should be shown. |
combine |
Logical. TRUE if all variables relating to epoch time should be merged, and all variables relating to participant code should be merged when data from multiple versions of oTree are used. |
Value
This function returns a list for each app containing information on the mean, the minimum, and maximum time the participants spent on the app, a data frame with information on the time each participant spent on the app, and eventually, vectors of relevant background information on these numbers.
If the experiment's duration is only calculated for one participant, the output returns an NA (per app) if the person did not make it to the app(s).
Examples
# Use package-internal list of oTree data frames
oTree <- gmoTree::oTree
# Show how much time all participants spent on app "survey"
apptime(oTree, apps = "survey")
# Show how much time the participant "y8rbzcju" spent on
# the app "survey"
apptime(oTree, pcode = "y8rbzcju", apps = "survey")
# Show how much time the participants in group 4 spent on
# the app "survey"
oTree <- make_ids(oTree, gmake = TRUE,
from_var = "dictator.1.group.id_in_subsession")
apptime(oTree, group_id = 4, apps = "survey")