show_dropouts {gmoTree}R Documentation

Show participants who did not finish the experiment

Description

Show information on the people who did not finish the experiment at (a) certain page(s) and/or app(s).

Usage

show_dropouts(oTree, final_apps = NULL, final_pages = NULL, saved_vars = NULL)

Arguments

oTree

A list of data frames created with import_otree().

final_apps

Character string or character vector. The name(s) of the app(s) at which the participants have to finish the experiment.

final_pages

Character string or character vector. The name(s) of the page(s) at which the participants have to finish the experiment.

saved_vars

Character string or character vector. The name(s) of variable(s) that need(s) to be shown in the list of information on dropout cases.

Value

This function returns a list of information on participants who did not finish the experiment.

In this list, you can find the following information:

It is important to note that if only the argument final_pages is set, this function does not distinguish between page names that reoccur in different apps.

If the columns end_app and end_page in the output are empty, these variables were not saved by oTree for the specific participants. This could be because empty rows were not deleted. This can be done by using the argument del_empty = TRUE" when using import_otree().

Examples

# Use package-internal list of oTree data frames
oTree <- gmoTree::oTree

# Show everyone who did not finish with the app "survey"
show_dropouts(oTree, final_apps = "survey")

# Show everyone who did not finish with the page "Demographics"
show_dropouts(oTree, final_pages = "Demographics")

# Show everyone who finished with the following apps: "survey," "dictator"
final_apps <- unique(oTree$all_apps_wide$participant._current_app_name)
final_apps <- final_apps[final_apps != "survey"]
final_apps <- final_apps[final_apps != "dictator"]
show_dropouts(oTree, final_apps = final_apps)

[Package gmoTree version 1.4.1 Index]