exclude_duration: Exclude rows with minimum or maximum durations

In excluder: Checks for Exclusion Criteria in Online Data

Exclude rows with minimum or maximum durations

Description

The exclude_duration() function removes rows of data that have durations that are too fast or too slow. The function is written to work with data from Qualtrics surveys.

Usage

exclude_duration(
  x,
  min_duration = 10,
  max_duration = NULL,
  id_col = "ResponseId",
  duration_col = "Duration (in seconds)",
  rename = TRUE,
  quiet = TRUE,
  print = TRUE,
  silent = FALSE
)

Arguments

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 rename_columns())
quiet	Logical indicating whether to print message to console.
print	Logical indicating whether to print returned tibble to console.
silent	Logical indicating whether to print message to console. Note this argument controls the exclude message not the check message.

Details

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.

Value

An object of the same type as x that excludes rows with fast and/or slow duration. For a function that checks for these rows, use check_duration(). For a function that marks these rows, use mark_duration().

See Also

Other duration functions: check_duration(), mark_duration()

Other exclude functions: exclude_duplicates(), exclude_ip(), exclude_location(), exclude_preview(), exclude_progress(), exclude_resolution()

Examples

# Exclude durations faster than 100 seconds
data(qualtrics_text)
df <- exclude_duration(qualtrics_text, min_duration = 100)

# Remove preview data first
df <- qualtrics_text %>%
  exclude_preview() %>%
  exclude_duration()

# Exclude only for durations slower than 800 seconds
df <- qualtrics_text %>%
  exclude_preview() %>%
  exclude_duration(max_duration = 800)

excluder documentation built on Feb. 16, 2023, 7:09 p.m.