Filter Cohorts
a07_filter_cohorts.Rmd
For this example we’ll use the Eunomia synthetic data from the CDMConnector package.
con <- DBI::dbConnect(duckdb::duckdb(), dbdir = eunomia_dir())
cdm <- cdm_from_con(con, cdm_schema = "main",
write_schema = c(prefix = "my_study_", schema = "main"))
Let’s start by creating two drug cohorts, one for users of diclofenac and another for users of acetaminophen.
cdm$medications <- conceptCohort(cdm = cdm,
conceptSet = list("diclofenac" = 1124300,
"acetaminophen" = 1127433),
name = "medications")
cohortCount(cdm$medications)
#> # A tibble: 2 × 3
#> cohort_definition_id number_records number_subjects
#> <int> <int> <int>
#> 1 1 9365 2580
#> 2 2 830 830
We can take a sample from a cohort table using the function
sampleCohort()
. This allows us to specify the number of
individuals in each cohort.
cdm$medications |> sampleCohorts(cohortId = NULL, n = 100)
#> # Source: table<main.my_study_medications> [?? x 4]
#> # Database: DuckDB v1.1.0 [unknown@Linux 6.8.0-1015-azure:R 4.4.1//tmp/RtmpPc1idR/file239d640ca50.duckdb]
#> cohort_definition_id subject_id cohort_start_date cohort_end_date
#> <int> <int> <date> <date>
#> 1 1 4382 1965-06-16 1965-06-30
#> 2 1 3279 2010-02-06 2010-02-20
#> 3 1 2927 1945-04-10 1945-04-24
#> 4 1 4544 1953-04-21 1953-04-28
#> 5 1 4701 2008-11-02 2008-11-16
#> 6 2 2935 2013-08-16 2013-08-16
#> 7 2 3784 1965-02-14 1965-02-14
#> 8 1 1840 2006-09-04 2006-09-18
#> 9 2 1155 2007-10-29 2007-10-29
#> 10 2 1934 2000-08-12 2000-08-12
#> # ℹ more rows
cohortCount(cdm$medications)
#> # A tibble: 2 × 3
#> cohort_definition_id number_records number_subjects
#> <int> <int> <int>
#> 1 1 369 100
#> 2 2 100 100
When cohortId = NULL all cohorts in the table are used. Note that this function does not reduced the number of records in each cohort, only the number of individuals.
It is also possible to only sample one cohort within cohort table, however the remaining cohorts will still remain.
cdm$medications <- cdm$medications |> sampleCohorts(cohortId = 2, n = 100)
cohortCount(cdm$medications)
#> # A tibble: 2 × 3
#> cohort_definition_id number_records number_subjects
#> <int> <int> <int>
#> 1 1 9365 2580
#> 2 2 100 100
The chosen cohort (users of diclofenac) has been reduced to 100 individuals, as specified in the function, however all individuals from cohort 1 (users of acetaminophen) and their records remain.
If you want to filter the cohort table to only include individuals
and records from a specified cohort, you can use the function
subsetCohorts
.
cdm$medications <- cdm$medications |> subsetCohorts(cohortId = 2)
cohortCount(cdm$medications)
#> # A tibble: 1 × 3
#> cohort_definition_id number_records number_subjects
#> <int> <int> <int>
#> 1 2 830 830
The cohort table has been filtered so it now only includes
individuals and records from cohort 2. If you want to take a sample of
the filtered cohort table then you can use the
sampleCohorts
function.
cdm$medications <- cdm$medications |> sampleCohorts(cohortId = 2, n = 100)
cohortCount(cdm$medications)
#> # A tibble: 1 × 3
#> cohort_definition_id number_records number_subjects
#> <int> <int> <int>
#> 1 2 100 100