NBDCtools (version 1.0.2)

filter_events_abcd: Filter ABCD events

Description

Given a (set of) condition(s), filters the events included in an ABCD dataset. Conditions can be specified as a vector of strings, where each string can be one of the following conditions:

• "core": events for the ABCD core study

• "annual": annual events for the ABCD core study

• "mid_year": mid-year events for the ABCD core study

• "substudy": events for ABCD substudies

• "covid": events for the COVID substudy

• "sdev": events for the Social Development substudy

• "even": even-numbered events

• "odd": odd-numbered events

• numerical expressions like >2 or <=5 to filter events by number

• any other string to be used as filter for the session_id column

The conditions can be combined with logical "and" or "or".

Usage

filter_events_abcd(data, conditions, connect = "and")

Value

A tibble with the filtered data.

Arguments

data

tibble. The data to be filtered.

conditions

character (vector). The events to keep.

connect

character. Whether to connect the conditions with "and" (an event is retained if all conditions are met; the default) or "or" (an event is retained if any condition is met).

Examples

if (FALSE) { # requireNamespace("NBDCtoolsData", quietly = TRUE)
data <- tibble::tribble(
  ~session_id,     ~study,     ~type,
  "ses-00S",       "core",     "screener",
  "ses-00M",       "core",     "mid-year",
  "ses-00A",       "core",     "even",
  "ses-01M",       "core",     "mid-year",
  "ses-01A",       "core",     "odd",
  "ses-02M",       "core",     "mid-year",
  "ses-02A",       "core",     "even",
  "ses-03M",       "core",     "mid-year",
  "ses-03A",       "core",     "odd",
  "ses-04M",       "core",     "mid-year",
  "ses-04A",       "core",     "even",
  "ses-05M",       "core",     "mid-year",
  "ses-05A",       "core",     "odd",
  "ses-06M",       "core",     "mid-year",
  "ses-06A",       "core",     "even",
  "ses-C01",       "substudy", "covid",
  "ses-C02",       "substudy", "covid",
  "ses-C03",       "substudy", "covid",
  "ses-C04",       "substudy", "covid",
  "ses-C05",       "substudy", "covid",
  "ses-C06",       "substudy", "covid",
  "ses-C07",       "substudy", "covid",
  "ses-S01",       "substudy", "sdev",
  "ses-S02",       "substudy", "sdev",
  "ses-S03",       "substudy", "sdev",
  "ses-S04",       "substudy", "sdev",
  "ses-S05",       "substudy", "sdev"
)

# ABCD core study events
filter_events_abcd(data, c("core"))

# COVID substudy events
filter_events_abcd(data, c("covid"))

# imaging events
filter_events_abcd(data, c("annual", "even"))

# mid-years before year 5
filter_events_abcd(data, c("mid_year", "<5"))

# COVID or Social Development substudy events
filter_events_abcd(data, c("covid", "sdev"), connect = "or")
}