check_duration | R Documentation |
The check_duration()
function subsets rows of data, retaining rows
that have durations that are too fast or too slow.
The function is written to work with data from
Qualtrics surveys.
check_duration(
x,
min_duration = 10,
max_duration = NULL,
id_col = "ResponseId",
duration_col = "Duration (in seconds)",
rename = TRUE,
keep = FALSE,
quiet = FALSE,
print = TRUE
)
x |
Data frame (preferably imported from Qualtrics using {qualtRics}). |
min_duration |
Minimum duration that is too fast in seconds. |
max_duration |
Maximum duration that is too slow in seconds. |
id_col |
Column name for unique row ID (e.g., participant). |
duration_col |
Column name for durations. |
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()
.
By default, minimum durations of 10 seconds are checked, but either
minima or maxima can be checked with the min_duration
and
max_duration
arguments. The function outputs to console separate
messages about the number of rows that are too fast or too slow.
This function returns the fast and slow rows.
An object of the same type as x
that includes the rows with fast and/or
slow duration.
For a function that marks these rows, use mark_duration()
.
For a function that excludes these rows, use exclude_duration()
.
Other duration functions:
exclude_duration()
,
mark_duration()
Other check functions:
check_duplicates()
,
check_ip()
,
check_location()
,
check_preview()
,
check_progress()
,
check_resolution()
# Check for durations faster than 100 seconds
data(qualtrics_text)
check_duration(qualtrics_text, min_duration = 100)
# Remove preview data first
qualtrics_text %>%
exclude_preview() %>%
check_duration(min_duration = 100)
# Check only for durations slower than 800 seconds
qualtrics_text %>%
exclude_preview() %>%
check_duration(max_duration = 800)
# Do not print rows to console
qualtrics_text %>%
exclude_preview() %>%
check_duration(min_duration = 100, print = FALSE)
# Do not print message to console
qualtrics_text %>%
exclude_preview() %>%
check_duration(min_duration = 100, quiet = TRUE)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.