check_progress | R Documentation |
The check_progress()
function subsets rows of data, retaining rows
that have incomplete progress.
The function is written to work with data from
Qualtrics surveys.
check_progress( x, min_progress = 100, id_col = "ResponseId", finished_col = "Finished", progress_col = "Progress", rename = TRUE, keep = FALSE, quiet = FALSE, print = TRUE )
x |
Data frame (preferably imported from Qualtrics using {qualtRics}). |
min_progress |
Amount of progress considered acceptable to include. |
id_col |
Column name for unique row ID (e.g., participant). |
finished_col |
Column name for whether survey was completed. |
progress_col |
Column name for percentage of survey completed. |
rename |
Logical indicating whether to rename columns (using |
keep |
Logical indicating whether to keep or remove exclusion column. |
quiet |
Logical indicating whether to print message to console. |
print |
Logical indicating whether to print returned tibble to console. |
Default column names are set based on output from the
qualtRics::fetch_survey()
.
The default requires 100% completion, but lower levels of completion
maybe acceptable and can be allowed by specifying the min_progress
argument.
The finished column in Qualtrics can be a numeric or character vector
depending on whether it is exported as choice text or numeric values.
This function works for both.
The function outputs to console a message about the number of rows that have incomplete progress.
The output is a data frame of the rows
that have incomplete progress.
For a function that marks these rows, use mark_progress()
.
For a function that excludes these rows, use exclude_progress()
.
Other progress functions:
exclude_progress()
,
mark_progress()
Other check functions:
check_duplicates()
,
check_duration()
,
check_ip()
,
check_location()
,
check_preview()
,
check_resolution()
# Check for rows with incomplete progress data(qualtrics_text) check_progress(qualtrics_text) # Remove preview data first qualtrics_text %>% exclude_preview() %>% check_progress() # Include a lower acceptable completion percentage qualtrics_numeric %>% exclude_preview() %>% check_progress(min_progress = 98) # Do not print rows to console qualtrics_text %>% exclude_preview() %>% check_progress(print = FALSE) # Do not print message to console qualtrics_text %>% exclude_preview() %>% check_progress(quiet = TRUE)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.