requireTableIntersect {CohortConstructor} | R Documentation |
Require cohort subjects are present in another clinical table
Description
requireTableIntersect()
filters a cohort table based on a requirement
that an individual is seen (or not seen) to have a record (or no records) in
a clinical table in some time window around an index date.
Usage
requireTableIntersect(
cohort,
tableName,
window,
intersections = c(1, Inf),
cohortId = NULL,
indexDate = "cohort_start_date",
targetStartDate = startDateColumn(tableName),
targetEndDate = endDateColumn(tableName),
censorDate = NULL,
name = tableName(cohort)
)
Arguments
cohort |
A cohort table in a cdm reference. |
tableName |
Name of the table to check for intersect. |
window |
Window to consider events over. |
intersections |
A range indicating number of intersections for criteria to be fulfilled. If a single number is passed, the number of intersections must match this. |
cohortId |
IDs of the cohorts to modify. If NULL, all cohorts will be used; otherwise, only the specified cohorts will be modified, and the rest will remain unchanged. |
indexDate |
Variable in x that contains the date to compute the intersection. |
targetStartDate |
Date of reference in cohort table, either for start (in overlap) or on its own (for incidence). |
targetEndDate |
Date of reference in cohort table, either for end (overlap) or NULL (if incidence). |
censorDate |
Whether to censor overlap events at a specific date or a column date of x. |
name |
Name of the new cohort with the future observation restriction. |
Value
Cohort table with only those in the other table kept (or those that are not in the table if negate = TRUE)
Examples
library(CohortConstructor)
cdm <- mockCohortConstructor(drugExposure = TRUE)
cdm$cohort1 |>
requireTableIntersect(tableName = "drug_exposure",
indexDate = "cohort_start_date",
window = c(-Inf, 0))