Get participants

get_participants(
  collection = NULL,
  corpus = NULL,
  target_child = NULL,
  role = NULL,
  role_exclude = NULL,
  age = NULL,
  sex = NULL,
  connection = NULL,
  db_version = "current",
  db_args = NULL
)

Arguments

collection

A character vector of one or more names of collections

corpus

A character vector of one or more names of corpora

target_child

A character vector of one or more names of children

role

A character vector of one or more roles to include

role_exclude

A character vector of one or more roles to exclude

age

A numeric vector of an single age value or a min age value and max age value (inclusive) in months. For a single age value, participants are returned for which that age is within their age range; for two ages, participants are returned for whose age overlaps with the interval between those two ages.

sex

A character vector of values "male" and/or "female"

connection

A connection to the CHILDES database

db_version

String of the name of database version to use

db_args

List with host, user, and password defined

Value

A `tbl` of Participant data, filtered down by supplied arguments. If `connection` is supplied, the result remains a remote query, otherwise it is retrieved into a local tibble.

Examples

# \donttest{ get_participants()
#> Using current database version: '2020.1'.
#> # A tibble: 24,255 x 18 #> id code name role corpus_name min_age max_age language group sex #> <int> <chr> <chr> <chr> <chr> <dbl> <dbl> <chr> <chr> <chr> #> 1 1 CHI John Target… English-Wol… 78.0 102. eng NA male #> 2 2 CHI Rachel Target… English-Wol… 80.0 101. eng NA fema… #> 3 3 CHI Margar… Target… English-Wol… 80.0 105. eng NA fema… #> 4 4 CHI Erin Target… English-Wol… 79.0 103. eng NA fema… #> 5 5 CHI Christ… Target… English-Wol… 77.0 105. eng NA fema… #> 6 7 INV Nina Invest… English-Wol… NA NA eng NA NA #> 7 8 MOT NA Mother English-Wol… NA NA eng NA fema… #> 8 9 INV Nina Invest… English-Wol… NA NA eng NA NA #> 9 10 INV Nina Invest… English-Wol… NA NA eng NA NA #> 10 11 CHI Joanna Target… English-Wol… 79.0 104. eng NA fema… #> # … with 24,245 more rows, and 8 more variables: ses <chr>, education <chr>, #> # custom <chr>, collection_name <chr>, collection_id <int>, corpus_id <int>, #> # target_child_id <int>, target_child_name <chr>
# }